ChatGPT 订阅 Provider
面向 AI Agent:本页的 Markdown 版本位于 https://ankole.agentbull.com/zh-Hans-CN/docs/chatgpt-subscription-provider/index.md,全站文档索引位于 https://ankole.agentbull.com/zh-Hans-CN/llms.txt。
在 Ankole 中,ChatGPT 订阅作为一种标准的 AIGateway Provider 接入。无论是日常对话档案还是“后台 Agent 任务”档案,任何语言模型档案都可以绑定到它——模型档案只需指定目标 Provider 记录与具体模型名称。
每条 Provider 记录内部都维护着一个凭据池:控制面负责加密保存每个订阅账号的令牌、自动完成 OAuth 令牌刷新,并为每次请求挑选健康的池成员。运行在 Worker 侧的 Agent Computer 只会收到 AIGateway 的网关地址与专属访问密钥,绝不会接触到 ChatGPT 的 Refresh Token。
创建 Provider
- 打开 Console → 模型提供商。
- 点击新增 Provider,类型选择 ChatGPT 订阅。
- 填写一个稳定的 Provider ID(例如
chatgpt-main)。 - 保存配置。
默认的请求端点与身份请求头已按 Codex 协议预置妥当;除非私有网络环境有明确的代理转发要求,否则无需改动「高级设置」中的端点地址或请求头。
通过设备码添加账号
- 点开刚才创建的 ChatGPT 订阅 Provider。
- 点击“添加 ChatGPT 账号”。
- 在浏览器中打开 Console 展示的验证链接,输入页面给出的一次性设备验证码完成授权。
- 等待 Console 自动完成登录握手并将该账号加入凭据池。
- 如需扩容并发与额度,可在同一个 Provider 下重复上述步骤继续添加备用账号。
登录时,Console 会优先发起官方设备码授权流程;若当前环境下设备码入口不可用,页面会自动切换为浏览器授权链接模式,完成登录后将浏览器跳转的完整回调 URL 粘贴回 Console 即可。此外,ChatGPT Enterprise 企业管理员也可以直接录入受信任的 Access Token 及对应的 ChatGPT Account ID。
配置凭据池
凭据池列表会展示每个账号成员的备注标签(label)、优先级(priority)、接入来源(source)、当前健康状态、累计请求次数、上游限额窗口以及模型与图像生成用量,但绝不会在页面上回显任何明文密钥或令牌。
你可以为凭据池指定以下任一调度策略(Console 界面会显示中文名称,API 与数据库存储则使用对应的规范英文键名):
| Console 显示名称 | API 键名 | 调度行为 |
|---|---|---|
| 优先使用首个 | fill_first |
始终固定使用排在最前的健康成员,直至该账号触发限流或不可用时才顺延切换。 |
| 轮询 | round_robin |
每次请求依次轮转使用池中的健康成员。 |
| 最少使用 | least_used |
优先挑选累计请求计数最小的健康成员。 |
| 随机 | random |
每次从健康成员中随机抽取一个。 |
触发限流进入 exhausted(配额耗尽)状态的账号,会在冷却窗口结束后自动恢复回池;而进入 dead(凭证失效)状态的账号则必须重新登录授权或替换凭据才能恢复(仅修改备注标签不会清除 dead 状态)。你也可以随时在列表中手动禁用或移除某个账号成员。
分配给 Agent
- 打开 Console → 智能体,进入目标 Agent 的编辑页。
- 找到需要配置的模型档案:长时异步任务请编辑
heavy(复杂推理与后台任务)档案,日常交互回合请编辑primary、light或对应的自定义模型档案。 - 选择刚刚配好的 ChatGPT 订阅 Provider,并选定订阅账号有权访问的模型。
- 按需设置推理强度(Reasoning Effort)与快速模式(Fast Mode)。
- 保存模型档案。
配置完成后,所有模型调用依旧统一流经 AIGateway:对于同一个有状态会话线程,网关会尽量固定复用同一个池内账号;一旦遇到可重试的上游限流或瞬时故障,会自动轮换池内其他健康账号重试,但不会跨 Provider 切换到其他模型提供商。如果池内所有账号均处于冷却状态且已知恢复时间,前台交互调用会返回附带最早恢复时间的限流提示,后台 Agent 任务会退回 queued 队列,等到该时刻再重试。无法确定恢复时间时,后台任务按常规的有界重试策略处理,详见 后台 Agent 任务。
关于后台任务的创建、交互与排障方法,请参阅 后台 Agent 任务。