模型配置
模型配置
概述
Model Management（设置 → Global settings → Model Management）决定 Agent 可以使用哪些 LLM。页面顶部的单选按钮可切换两种 Model Service 模式：
| 模式 | 密钥由谁提供 | 适用场景 |
|---|---|---|
| Enterprise Key（默认） | 你的组织。模型由空间管理员统一管理，按组织积分计费 | 大多数企业用户——无需任何配置 |
| Owner Key | 你自己。使用你自己的 API Key 和模型配置 | 个人密钥、私有端点、组织未开通的供应商 |
Enterprise Key
Enterprise Key 模式下，页面按供应商（如 OpenAI、Claude、Gemini）分组列出组织提供的 Available Models。每一行显示：
| 列 | 说明 |
|---|---|
| 模型名 + 版本 ID | 显示名称及底层模型版本 |
| Input | 支持的输入类型，以图标表示：文本、图片、文档、音频、视频 |
| Output | 支持的输出类型 |
此处不可编辑，列表跟随组织配置。这些模型消耗的积分计入组织的月度配额（见设置 → Usage）。
Owner Key
把 Model Service 切换为 Owner Key 即可使用自己的 API Key。页面分为左侧供应商列表和右侧该供应商的配置。
支持的供应商
OpenAI、Anthropic、Gemini、Grok、OpenRouter、DeepSeek、Moonshot、Qwen、Zhipu、MiniMax、Volcengine、StepFun 等。列表中每个供应商都有一个启用开关。
配置项
| 项目 | 说明 |
|---|---|
| API Base URL | API 端点。已预填供应商默认地址；使用代理或兼容的第三方端点时可修改 |
| API Key | 该供应商的密钥（本地加密存储，界面中隐藏显示） |
| LLM Protocol | OpenAI Completions / OpenAI Responses / Anthropic Claude——端点使用的请求格式 |
| Coding Plan（部分供应商） | 开启后使用供应商的编码套餐专用端点 |
| Test Connection | 校验 URL + Key；供应商标签从 Unverified 变为已验证 |
| Available Models | 该供应商暴露的模型，每个带输入 / 输出能力图标；+ Add Model 可手动添加模型版本 ID |
如何配置一个供应商
- 设置 → Model Management → 选择 Owner Key
- 在左侧列表点击供应商（如 Anthropic）
- 填写 API Key（使用兼容服务时同时修改 API Base URL）
- 选择与端点匹配的 LLM Protocol
- 点击 Test Connection
- 打开该供应商的开关——其模型即出现在输入框下方的模型选择器中
注意：Owner Key 凭证仅保存在本地，不会上传云端。切勿把 API Key 分享给他人或提交到代码仓库。
切换模型
当前模型显示在 New task 页输入框下方，点击即可切换；下一条消息使用新模型，已有对话历史不受影响。
定时任务可以跟随全局模型，也可以固定使用某个模型（见 定时任务）。
模型能力
每个模型行上的输入 / 输出图标表示该模型接受的内容：
| 能力 | 图标含义 | 影响 |
|---|---|---|
| 文本 | 文档行图标 | 始终支持 |
| 图片 | 图片图标 | 图片附件是否传给模型 |
| 文档 | 文件图标 | PDF / Office 附件是否传给模型 |
| 音频 / 视频 | 音符 / 摄像机图标 | 音频或视频附件是否传给模型 |
如果附件类型当前模型不支持，请切换到支持的模型。
上下文窗口与任务限制
可用上下文取决于模型窗口和 Task Control 设置（设置 → Task Control）：
| 设置 | 默认 | 说明 |
|---|---|---|
| Context Compaction Threshold | 128K | 上下文超过该 Token 数时自动摘要；取该值与模型窗口中的较小者 |
| Max Token Budget | 0（不限） | 累计输入 Token 超过该值时停止任务 |
| Full Context Rounds | 3 | 保留最近 N 轮的完整工具调用 / 结果细节，更早的轮次只保留文本 |
| Max Loop Count | 100 | 单次运行的最大 Agent 轮次 |
| Max Error Count | 100 | 连续工具错误达到该次数后停止 |
完整模型列表请参考 支持的模型列表。
模型选择建议
| 使用场景 | 建议 | 原因 |
|---|---|---|
| 日常对话、轻量任务 | 快速、低成本的模型 | 响应快、积分消耗低 |
| 复杂推理、长文档分析 | 窗口大、支持文档输入的旗舰模型 | 推理强、可直接读文档 |
| 代码开发与调试 | 旗舰或代码专长模型 | 代码理解能力 |
| 需要图片 / 视频理解 | Input 图标包含图片 / 视频的模型 | 多模态输入 |
| 成本敏感 | 较小的模型 | 积分消耗最低 |
提示：拿不准时就用模型选择器里的组织默认模型——那是管理员按综合表现选定的。
常见问题
API Key 无效（Owner Key）
- 确认 Key 复制正确（注意首尾空格）
- 确认 Key 属于所选供应商，且 LLM Protocol 匹配
- 确认 Key 未过期或被吊销；再次点击 Test Connection
请求超时
- 检查网络连接
- 使用自定义 Base URL 时，确认地址可达
- 部分模型在高负载时响应较慢，可稍后重试
模型选择器里找不到某个模型
- Enterprise Key：请管理员为组织开通
- Owner Key：确认供应商开关已打开；若未列出，用 + Add Model 添加