> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# 如何在 Octop 中配置模型提供商与模型

Octop 内置了大量模型提供商预设，也支持接入任意自定义端点。提供商由管理员在**管理 → 模型**中配置，启用后其模型会进入一个共享的模型池，供所有专家使用。

## 添加提供商

```text
管理 → 模型
```


![模型管理](/images/ui-models.png "模型管理")

在**云端**或**本地**中选择一个预置提供商，填入 API 密钥并启用。该提供商的模型会立即对您账户下的专家可用。Octop 启动时会同步新的预置模型。语音、搜索和**决策模型**（用于技能、工具或团队路由时的选择）也在同一**模型**页。

OpenAI 兼容提供商可以把 **OpenAI API 模式**选成 **Responses（/v1/responses）**。回退到 Chat Completions 默认关闭，除非厂商明确表示不支持 Responses。

这一页的搜索提供商包括 DeepSeek 和**元宝**。DeepSeek 返回排序结果、摘要和来源链接。元宝覆盖公开网页和腾讯内容。

当前模型不可用时，Octop 可按健康状态自动切换到池中其他可用模型，对话不必卡住。

## 预置提供商

**云端**标签页覆盖各类托管服务：

| 预设                                                                                         | 协议             |
| ------------------------------------------------------------------------------------------ | -------------- |
| 腾讯云（含 Token Plan 企业版与 Hy 套餐）、Kimi、MiniMax、OpenCode、SiliconFlow、Aliyun、Volcano Engine、Zhipu | `openai`，多站点可选 |
| OpenAI、OpenAI (ChatGPT)、OpenRouter、DeepSeek、Google Gemini、Groq、ModelScope、Xiaomi MiMo      | `openai`       |
| Anthropic                                                                                  | `anthropic`    |

Tencent Cloud 包含 Token Plan、Token Plan Enterprise (CN)、Coding Plan 与 Hy Token Plan 等站点。使用支持推理状态的 Hy 模型（如 `hy3`）时，Octop 会自动显示对应推理状态。

**本地**标签页提供 **Ollama (Local)** 预设，默认指向 `http://localhost:11434/v1`。如果都不合适，可以用**自定义供应商**填写自己的 Base URL 和密钥。


> **说明**
> 
> 预设按其使用的 API 协议标注——`openai` 表示 OpenAI 对话补全规范，`anthropic` 表示 Anthropic Messages API。任何遵循这两种规范的端点都可以作为自定义提供商接入。
> 


## 可用模型池与自动路由

已启用提供商的模型会汇入页面顶部的**可用模型池**。Octop 可以为每条消息自动路由，选择最合适的模型；被标记为 ⭐ 偏好的模型在没有特殊需求时会被优先使用。

模型池中会显示每个模型的类型和上下文长度，方便您判断哪些适合处理长文本。

填写凭据后请点击**测试连接**。Octop 会把常见的鉴权、余额、限流和服务不可用错误转换成本地化提示，便于先修好提供商配置，再开始对话。

## 为专家设置模型

若未为专家单独指定，它会使用全局默认模型。您可以按专家覆盖——例如日常对话用便宜的模型，复杂任务用更强的模型。

每个账户还可以在个人设置中保存**首选模型**以及按模型的**推理**默认值。这些偏好只作用于该用户的新对话，不会改共享的提供商目录。


> **提示**
> 
> 在终端配置提供商与模型可以用 `octop models config`、`octop models list`、`octop models active`，详见[专家命令](/cli/agent-commands.md#octop-models)。
> 


## 使用 Ollama

在**本地**标签页启用 **Ollama (Local)** 预设即可，无需 API 密钥，Octop 会连接 `http://localhost:11434/v1`。


> **说明**
> 
> 向使用 Ollama 的专家发送第一条消息前，请确保 Ollama 已在运行。可以用 `octop models ollama-list` 和 `octop models ollama-pull` 查看和下载本地模型。
> 


## 知识库用的模型

知识库可以在本机为文档建立索引，也可以使用在线嵌入模型。管理员在**知识库 → 知识库设置**中选择模型，或在**模型**页下载本地模型。详见[知识库](/guide/concepts/knowledge.md)。

## 火山方舟图像与视频

启用火山引擎（方舟）提供商后，可配置 Seedream 图像与 Seedance 视频生成，并在页面中测试与预览结果。这些生成模型与对话补全相互独立。
