AI Providers

它是什么

一个 workspace registry,您在其中添加 LLM 提供商。每个 entry 存储一个标签、kind(anthropic / openai / gemini / ollama / azure / custom)、端点 URL(如果适用)、模型 id 和 API key。Keys 永不离开 DBA 工作站 — 通过 safeStorage 静态加密,按需为每个请求解密。

何时使用

每个工作站配置一次。然后任何 AI 驱动的界面 — Cosmos AI Advisor、query rewriter、schema migration assistant、AI 异常检测器 — 都使用活动提供商。一键从 Claude 切换到 GPT-4 切换到本地 Ollama,无需重新构建。

如何打开

1. 在 NoSqlStudio 桌面应用中,打开 Tools 菜单 → AI Providers,或按 Ctrl+Alt+Shift+I。
2. workspace 列出已配置的提供商。点击 Add 注册新的。
3. 从下拉菜单选择 kind。填写必填字段。托管提供商的端点 URL 字段自动填充;自定义 kinds 期望任何 OpenAI-compatible /v1/chat/completions 端点。

注册提供商

1. Anthropic — 粘贴以 sk-ant- 开头的 API key。选择一个模型(claude-opus-4-7 / claude-sonnet-4-6 / claude-haiku-4-5)。
2. OpenAI — 粘贴以 sk- 开头的 API key。选择一个模型(gpt-4、gpt-4o、gpt-4-turbo 等)。
3. Gemini — 粘贴 API key。选择一个模型(gemini-1.5-pro / gemini-1.5-flash)。
4. Ollama(本地)— API key 留空。端点默认为 http://localhost:11434。选择一个已拉取的模型(llama3 / mistral 等)。
5. Azure OpenAI — 粘贴端点 URL、部署名称、API 版本和 key。
6. 自定义 OpenAI-compatible — 粘贴基础 URL(例如 https://api.together.ai/v1)和 API key。适用于 OpenRouter、Together AI、Anyscale、vLLM 和自托管端点。

切换活动提供商

在任何已注册的提供商上点击 "Set active"。新选择广播到所有消费 AI 的打开的 workspace tabs — 无需重启应用,无 per-feature 覆盖;一个全局切换。

Shadow 验证保证

应用内的 AI 驱动操作绝不触及生产。每个 mutation 在 shadow collection(例如 `__shadow_<orig>`)中暂存,针对您的真实 workload 验证,仅在明确确认后应用。AI 提议;DBA 决定。

限制(v1)

• Keys 通过 Electron safeStorage 加密 — 加密强度取决于 OS keyring(macOS 上的 Keychain、Windows 上的 DPAPI、Linux 上的 libsecret)。如果您的威胁模型需要硬件密钥隔离,不要在共享主机上使用桌面 AI。
• 如果主提供商在请求中途失败,无自动提供商回退。您可以手动接入回退链,但 UI 只暴露单个活动提供商。
• 本地 Ollama 性能取决于您的硬件。在 laptop 上对 llama3-70b 进行繁重的 schema 分析会很慢 — 为交互流程选择较小的模型。