AI Providers

Dory 使用可插拔的 AI 提供商架构，为 AI Chat、SQL 生成、图表建议和 Schema 感知分析提供模型能力。你可以仅通过环境变量切换提供商，而不需要修改应用代码。

支持的提供商

提供商	`DORY_AI_PROVIDER` 值	说明
OpenAI	`openai`	使用官方 OpenAI API。
OpenAI-compatible	`openai-compatible`	适用于兼容 OpenAI API 的服务。
Anthropic	`anthropic`	通过 Anthropic API 使用 Claude。
Google	`google`	通过 Google Generative AI 使用 Gemini。
Qwen	`qwen`	通过兼容端点接入 Qwen。
xAI	`xai`	通过 xAI API 使用 Grok。

核心环境变量

大多数部署至少需要以下配置：

export DORY_AI_PROVIDER=openai
export DORY_AI_MODEL=gpt-4o-mini
export DORY_AI_API_KEY=your_api_key_here
export DORY_AI_URL=https://api.openai.com/v1

变量	是否必需	说明
`DORY_AI_PROVIDER`	是	选择 Dory 使用的模型提供商适配器。
`DORY_AI_MODEL`	是	选择 AI Chat 和 SQL 生成使用的模型。
`DORY_AI_API_KEY`	通常必需	提供商接受的 API Key 或 Bearer Token。
`DORY_AI_URL`	视提供商而定	OpenAI-compatible 服务或自定义端点的 Base URL。

不要把模型凭据写进前端代码、提交到仓库、出现在截图中，或粘贴到公开工单里。

提供商配置示例

OpenAI

DORY_AI_PROVIDER=openai
DORY_AI_MODEL=gpt-4o-mini
DORY_AI_API_KEY=sk-...
DORY_AI_URL=https://api.openai.com/v1

如果你希望使用最直接的 Dory AI SQL 生成配置路径，可以从 OpenAI 开始。

OpenAI-compatible

DORY_AI_PROVIDER=openai-compatible
DORY_AI_MODEL=your-model-name
DORY_AI_API_KEY=your_provider_key
DORY_AI_URL=https://your-compatible-endpoint.example.com/v1

如果团队已经统一使用兼容 OpenAI API 的服务或代理，可以选择这个模式。

Anthropic

DORY_AI_PROVIDER=anthropic
DORY_AI_MODEL=claude-3-5-sonnet-latest
DORY_AI_API_KEY=your_anthropic_key

当团队偏好 Claude 的长上下文推理能力，或内部策略要求使用 Anthropic 时，可以选择该提供商。

Google

DORY_AI_PROVIDER=google
DORY_AI_MODEL=gemini-1.5-pro
DORY_AI_API_KEY=your_google_key

如果组织内部已经在使用 Gemini 工作流，可以选择 Google。

Qwen

DORY_AI_PROVIDER=qwen
DORY_AI_MODEL=qwen-plus
DORY_AI_API_KEY=your_qwen_key

如果 Qwen 在语言、区域或成本上更符合团队要求，可以选择该模型系列。

xAI

DORY_AI_PROVIDER=xai
DORY_AI_MODEL=grok-2-latest
DORY_AI_API_KEY=your_xai_key

如果 Grok 模型已经在你的 AI 技术栈中通过审批，可以选择 xAI。

如何选择提供商

需求	建议
最快完成标准配置	从 OpenAI 开始。
已有统一代理或兼容端点	使用 OpenAI-compatible。
长上下文推理任务较多	对比 Anthropic 和 OpenAI 的模型效果。
已有 Google AI 使用基础	使用 Google。
区域、语言或成本更适配	对比 Qwen 和其他已批准提供商。
内部合规要求明确	选择组织已经批准的提供商。

验证清单

确认 DORY_AI_PROVIDER 的值与文档中的提供商值一致。
确认模型名称在该提供商中可用。
确认 API Key 有权限调用目标模型。
如果使用兼容端点，确认 DORY_AI_URL 包含正确的 Base Path。
修改提供商配置后重启 Dory 服务。
先用一个小的 Schema 问题测试 AI Chat，再测试复杂 SQL 生成。

常见问题排查

现象	可能原因	处理方式
AI Chat 返回认证错误	API Key 缺失或无效。	轮换 Key 并更新 `DORY_AI_API_KEY`。
提示模型不存在	模型名称和提供商不匹配。	使用该提供商实际支持的模型名称。
兼容端点调用失败	Base URL 或路径错误。	检查提供商文档中的 OpenAI-compatible Base URL。
SQL 质量不稳定	模型 Schema 推理能力不足。	尝试更强模型，并缩小上下文范围。
响应很慢	提供商延迟高或 Schema 上下文过大。	使用更快模型，或只选择相关数据库和表。

限制说明

提供商支持并不意味着输出质量完全一致。SQL 生成效果仍会受到模型能力、Schema 复杂度和提示语清晰度影响。

这篇文档有帮助吗？

本页内容