AI 供应商配置

AI 供应商是欣悦互通所有 AI 能力的基础。系统基于 rig-core 统一编排引擎，支持任意 OpenAI 兼容的模型供应商动态接入，您只需配置 API Key 和 Base URL 即可启用对话、多模态生成、Function Calling 等全部 AI 功能。

本页介绍如何创建和管理 AI 供应商，是使用其他 AI 功能的前置条件。

什么是 AI 供应商

AI 供应商（Provider）代表一个可调用的模型服务端点。由于系统采用 OpenAI 兼容协议，您可以接入：

• 官方 OpenAI（GPT 系列）
• Anthropic Claude（通过兼容网关）
• 国内模型（通义千问、智谱 GLM、Moonshot、DeepSeek 等）
• 自建模型服务（vLLM、Ollama 等暴露 OpenAI 接口的服务）

每个供应商按租户独立配置，不同租户可以使用不同的模型服务商，互不影响。

rig-core 统一编排

系统底层使用 rig-core 0.39.0 作为统一的 LLM 编排引擎，带来以下优势：

1. 统一接口：所有供应商通过相同接口调用，切换供应商无需改代码
2. 动态切换：按租户从数据库加载配置，运行时自动切换 Provider
3. 连接池复用：rig client 缓存池避免重复建连，降低延迟
4. 原生流式：基于 rig stream_prompt 实现真流式 SSE 输出
5. Function Calling：内置 16 个 Tool 通过 rig ToolDyn 自动循环调用

创建供应商

操作步骤

1. 进入「AI 能力 > 供应商管理」页面
2. 点击「新增供应商」，填写以下信息：
   • 供应商名称（如 "生产环境 OpenAI"）
   • Base URL（如 https://api.openai.com/v1）
   • API Key（系统加密存储）
   • 默认模型（如 gpt-4o）
   • 能力类型（文本 / 图片 / 语音 / 视频）
3. 点击「测试连接」验证配置是否正确
4. 保存后供应商即可在对话和生成功能中使用

配置示例

{
  "name": "通义千问",
  "base_url": "https://dashscope.aliyuncs.com/compatible-mode/v1",
  "api_key": "sk-xxxxxxxxxxxx",
  "default_model": "qwen-max",
  "capabilities": ["text", "image"]
}

!TIP 国内用户可优先接入通义千问、DeepSeek 等国内模型，无需科学上网即可使用，响应速度更快。

管理供应商

编辑供应商

在供应商列表中点击「编辑」，可修改名称、Base URL、API Key、默认模型等配置。修改后系统会自动刷新连接池缓存。

删除供应商

删除供应商前，请确认没有正在执行的对话或生成任务。删除后，使用该供应商的 AI 功能将不可用。

!WARNING 删除供应商会导致依赖该供应商的所有 AI 功能立即失效，请先迁移到其他供应商再执行删除。

启用 / 禁用

对于临时不用的供应商，可以禁用而非删除，保留配置以便日后启用。禁用状态下不会消耗任何配额。

多供应商策略

系统支持为不同场景配置不同供应商，实现成本和效果的平衡：

• 日常对话：使用性价比高的模型（如 DeepSeek、通义千问）
• 复杂推理：使用强能力模型（如 GPT-4o、Claude）
• 图片生成：使用专用图像模型
• 语音合成：使用 TTS 专用模型

!NOTE 供应商配置按租户隔离，同一租户下所有用户共享供应商配置。

API 参考

相关链接

• AI 对话与流式输出
• 多模态生成
• 用量统计与配额管理