Ir al contenido
NoSqlStudio
Documentación

AI Providers

Traiga su propio LLM. Registre Anthropic, OpenAI, Gemini, Ollama, Azure OpenAI, o cualquier endpoint OpenAI-compatible. Keys quedan encriptadas en el keychain del OS vía Electron safeStorage. Cambie modelos en 1 clic.

Qué es

Un workspace registry donde agrega LLM providers. Cada entry almacena un label, kind (anthropic / openai / gemini / ollama / azure / custom), URL de endpoint (si aplicable), id de modelo, y una API key. Keys nunca salen de la workstation DBA — encriptadas en reposo con safeStorage, decriptadas on demand para cada request.

Cuándo usar

Configure una vez por workstation. Luego cualquier surface AI-driven — Cosmos AI Advisor, query rewriter, schema migration assistant, AI-anomaly detector — usa el provider activo. Cambie de Claude a GPT-4 a Ollama local en 1 clic, sin rebuild.

Cómo abrirlo

  1. En el app desktop del NoSqlStudio, abra el menú Tools → AI Providers, o presione Ctrl+Alt+Shift+I.
  2. El workspace lista los providers configurados. Haga clic en Add para registrar uno nuevo.
  3. Elija el kind del dropdown. Llene los campos obligatorios. El field de URL de endpoint auto-popula para providers managed; kinds custom esperan cualquier endpoint OpenAI-compatible /v1/chat/completions.

Registrando un provider

  1. Anthropic — pegue la API key empezando con sk-ant-. Elija un modelo (claude-opus-4-7 / claude-sonnet-4-6 / claude-haiku-4-5).
  2. OpenAI — pegue la API key empezando con sk-. Elija un modelo (gpt-4, gpt-4o, gpt-4-turbo, etc.).
  3. Gemini — pegue la API key. Elija un modelo (gemini-1.5-pro / gemini-1.5-flash).
  4. Ollama (local) — deje la API key vacía. Endpoint default en http://localhost:11434. Elija un modelo ya pulled (llama3 / mistral / etc.).
  5. Azure OpenAI — pegue el URL del endpoint, nombre del deployment, versión de la API, y la key.
  6. Custom OpenAI-compatible — pegue el base URL (ej.: https://api.together.ai/v1) y la API key. Útil para OpenRouter, Together AI, Anyscale, vLLM, y endpoints self-hosted.

Cambiando el provider activo

Haga clic en "Set active" en cualquier provider registrado. La nueva selección es broadcast en todos los tabs de workspace abiertos que consumen AI — sin restart de app, sin override per-feature; un único switch global.

Garantía de validación shadow

Acciones AI-driven dentro del app NUNCA tocan producción. Toda mutation es staged en una shadow collection (ej.: `__shadow_<orig>`), validada contra su workload real, y solo aplicada después de confirmación explícita. La AI propone; el DBA dispone.

Limitaciones (v1)

  • Keys son encriptadas con Electron safeStorage — fuerza de la encriptación depende del keyring del OS (Keychain en macOS, DPAPI en Windows, libsecret en Linux). Si su threat model necesita aislamiento hardware-key, no use AI desktop en hosts compartidos.
  • Sin fallback automático de provider si un primary falla en medio del request. Puede wire una chain de fallback manualmente pero la UI expone solo un único provider activo.
  • Performance Ollama local depende de su hardware. Análisis pesado de schema en llama3-70b en un laptop va a ser lento — elija un modelo menor para flujos interactivos.