提供商与模型
配置 Agent 的服务端连接、模型能力和上下文策略。
Agent 将“如何连接服务端”和“如何使用模型”分开配置：Provider 保存协议、API 地址和凭据；模型策略保存默认模型、推理强度、图片输入和上下文规则。
添加 Provider
进入“设置 → Agent”，在模型提供商区域添加 Provider。
| 配置 | 说明 |
|---|---|
| 名称 | 只用于在界面中区分 Provider |
| 协议 | OpenAI Responses、OpenAI Chat Completions 或 Anthropic Messages |
| API 地址 | 服务端接口根地址，必须使用 http 或 https |
| API Token | 服务端要求的认证 Token；不需要时可以留空 |
| 自定义请求头 | 网关或兼容服务要求的附加头 |
| 启用 | 决定它能否用于新选择和模型请求 |
协议必须与服务端实际实现一致。修改 API 地址不会把 Chat Completions 服务转换为 Responses 服务；兼容服务也可能只实现协议的一部分能力。
凭据按原文保存在设置中
Provider Token 和自定义请求头值不是密码占位符，应用会按输入内容保存和显示。不要把设置文件、包含凭据的截图或界面录屏公开分享。
选择默认模型
保存并启用 Provider 后，在模型策略中选择默认 Provider 和模型。模型列表是服务端返回的辅助目录，也可以填写服务端接受的自定义模型 ID。
选择已启用的 Provider。
从目录选择模型，或者输入准确的模型 ID。
按模型能力配置推理强度、图片输入和上下文窗口。
保存后新建一个短会话，发送简单问题验证连接。
没有默认模型时仍可创建空闲会话，但不能发送模型请求。点击输入框旁的模型名称或执行 /model，可为当前空闲会话选择模型。全局默认值发生变化时，已有会话不会被静默切换。
模型能力
| 配置 | 使用建议 |
|---|---|
| 推理强度 | Responses Provider 可使用预设值、Provider 默认值或自定义值；其他协议不提供此项 |
| 图片输入 | “自动”会在模型支持时发送图片；“禁用”会阻止图片输入 |
| 上下文窗口 | 填写模型实际可用的 Token 数；留空时依赖 Provider 和运行时信息 |
| 自动压缩 | 在接近阈值时整理模型上下文，默认阈值为窗口的 80% |
| 远程压缩 | 仅用于声明支持相应能力的 Responses Provider |
上下文窗口设置过高，服务端可能先拒绝请求；设置过低则会更早触发压缩。压缩只改变下一轮发送给模型的上下文，不会删除界面中已经保存的消息和工具记录。
当前会话的模型
会话会记录自己的 Provider、协议、模型和推理强度。需要临时更换时：
- 等待当前回答和压缩结束。
- 点击输入框旁的模型按钮，或执行
/model。 - 选择已启用的 Provider 和模型。
- 如需调整推理强度，再执行
/effort。
更换模型后，推理强度会回到目标 Provider 的默认配置。正在运行的回答、等待清理的任务或不支持推理强度的协议不能执行相应变更。
验证与排查
如果测试消息失败，按下面的顺序检查：
- Provider 是否启用，协议是否与服务端一致。
- API 地址是否包含正确的版本路径，且没有把凭据写进 URL。
- 模型 ID 是否真实存在并允许当前账号使用。
- Token 和自定义请求头是否正确。
- 应用代理和服务端网络是否可达。
- 上下文窗口、图片输入或远程压缩是否超出兼容服务能力。
禁用或删除 Provider 后，历史会话仍可阅读；要继续与模型交互，需要为会话显式选择另一个可用模型。删除 Provider 也会删除它保存的凭据。