接入模型服务
模型服务决定由哪个大模型驱动你的 Agent 完成推理。实例开通后首先要完成模型接入，未接入模型时，对话、自动任务与通道回复都会失败。
入口： 左侧导航「接入 → 模型服务」
接入前先准备三样东西
平台内置了常见服务商的预设，但无论使用预设还是自建服务，本质都是填写一套兼容 OpenAI 协议的接口信息，需要提前准备：
| 准备项 | 说明 |
|---|---|
| 接口地址 | 在服务商控制台获取 base URL，通常以 /v1 结尾 |
| API Key | 在服务商控制台新建密钥并立即复制，多数平台只显示一次 |
| 模型名称 | 在服务商的模型列表页抄下模型 ID，例如 glm-4.6、deepseek-chat |
填写接口配置
配置共四项，四项都属于模型配置的一部分，填写完成后点击「保存并启用」。
| 字段 | 说明 |
|---|---|
| 配置名称 | 用于区分服务商、用途或模型，最多 40 个字符。例如「优云智算 Coding Plan」 |
| API 地址 | 模型服务的 base URL，填到 /v1 为止，Agent 会自动补上 /chat/completions |
| API Key | 提交后会发送到当前实例，前端不保存也不回显明文。修改配置时需要重新填写 |
| 模型名称 | 按服务商文档里的模型 ID 原样填写，区分大小写 |
快捷键入： API 地址下方提供服务商预设，点击即可自动填充地址。可选预设包括优云 Coding Plan、智谱 GLM、DeepSeek、通义千问、OpenAI、Anthropic。自建或其他兼容 OpenAI 协议的服务选择「自定义」，手动填写地址。
提示： 页面顶部的黄色横幅会提示「还没有接入模型」，右上角以
已填写/总数的形式显示当前配置进度。四项填齐后「保存并启用」按钮才可用。
保存后的变化
点击「保存并启用」后配置立即启用，Gateway 会自动重启以加载新配置。页面右侧的「模型用在哪里」会同步显示当前各能力的接入状态：
| 能力 | 说明 |
|---|---|
| 对话 | 控制台内的对话与会话 |
| 自动任务 | 定时任务的执行 |
| 通道回复 | 消息通道中收到的消息由 Agent 自动回复 |
| 技能调用 | Agent 在执行任务时调用已安装的技能 |
换模型的影响
更换模型只改变由谁来推理，不影响已经装好的技能、人设和自动任务。技能、人设和自动任务都存在于实例这一侧，与模型服务相互独立。
需要注意的是，出于安全考虑，API Key 不会回显。再次修改配置时需要重新填写完整的 Key。
常见问题
保存后 Agent 仍无响应？ 先确认四项配置是否都已填写且保存成功，再检查 API Key 是否有效、模型名称是否与服务商文档一致。Key 失效或模型名称拼写错误都会导致调用失败。
可以用自建或私有化部署的推理服务吗？ 可以。只要服务兼容 OpenAI 协议，选择「自定义」并填写对应的地址、Key 与模型名称即可。
使用自己的 API Key，平台会代扣模型费用吗？ 不会。模型推理费用由你与对应服务商直接结算，平台只负责把请求转发到该服务。若希望模型费用与实例套餐统一结算，可使用优云 Coding Plan 预设。