Pular para o conteúdo
NoSqlStudio
Documentação

AI Providers

Traga seu próprio LLM. Registre Anthropic, OpenAI, Gemini, Ollama, Azure OpenAI, ou qualquer endpoint OpenAI-compatible. Keys ficam encriptadas no keychain do OS via Electron safeStorage. Troque modelos em 1 clique.

O que é

Um workspace registry onde você adiciona LLM providers. Cada entry armazena um label, kind (anthropic / openai / gemini / ollama / azure / custom), URL de endpoint (se aplicável), id de modelo, e uma API key. Keys nunca saem da workstation DBA — encriptadas em repouso com safeStorage, decriptadas on demand para cada request.

Quando usar

Configure uma vez por workstation. Então qualquer surface AI-driven — Cosmos AI Advisor, query rewriter, schema migration assistant, AI-anomaly detector — usa o provider ativo. Troque de Claude para GPT-4 para Ollama local em 1 clique, sem rebuild.

Como abrir

  1. No app desktop do NoSqlStudio, abra o menu Tools → AI Providers, ou pressione Ctrl+Alt+Shift+I.
  2. O workspace lista os providers configurados. Clique em Add para registrar um novo.
  3. Escolha o kind do dropdown. Preencha os campos obrigatórios. O field de URL de endpoint auto-popula para providers managed; kinds custom esperam qualquer endpoint OpenAI-compatible /v1/chat/completions.

Registrando um provider

  1. Anthropic — cole a API key começando com sk-ant-. Escolha um modelo (claude-opus-4-7 / claude-sonnet-4-6 / claude-haiku-4-5).
  2. OpenAI — cole a API key começando com sk-. Escolha um modelo (gpt-4, gpt-4o, gpt-4-turbo, etc.).
  3. Gemini — cole a API key. Escolha um modelo (gemini-1.5-pro / gemini-1.5-flash).
  4. Ollama (local) — deixe a API key vazia. Endpoint default em http://localhost:11434. Escolha um modelo já pulled (llama3 / mistral / etc.).
  5. Azure OpenAI — cole o URL do endpoint, nome do deployment, versão da API, e a key.
  6. Custom OpenAI-compatible — cole o base URL (ex.: https://api.together.ai/v1) e a API key. Útil para OpenRouter, Together AI, Anyscale, vLLM, e endpoints self-hosted.

Trocando o provider ativo

Clique em "Set active" em qualquer provider registrado. A nova seleção é broadcast em todas as tabs de workspace abertas que consomem AI — sem restart de app, sem override per-feature; um único switch global.

Garantia de validação shadow

Ações AI-driven dentro do app NUNCA tocam produção. Toda mutation é staged numa shadow collection (ex.: `__shadow_<orig>`), validada contra seu workload real, e só aplicada após confirmação explícita. A AI propõe; o DBA dispõe.

Limitações (v1)

  • Keys são encriptadas com Electron safeStorage — força da encriptação depende do keyring do OS (Keychain no macOS, DPAPI no Windows, libsecret no Linux). Se seu threat model precisa de isolamento hardware-key, não use AI desktop em hosts compartilhados.
  • Sem fallback automático de provider se um primário falha no meio do request. Você pode wire uma chain de fallback manualmente mas a UI expõe só um único provider ativo.
  • Performance Ollama local depende do seu hardware. Análise pesada de schema em llama3-70b num laptop vai ser lenta — escolha um modelo menor para fluxos interativos.