创建 Chat Completions 连接
/v1,不要附加 /chat/completions。Responses 不附加 /responses;Messages 按对应端点根地址配置。协议 provider 值见协议表。
连接验证实际发送什么
三个模型连接的 config 都只接受base_url 和 model。URL 必须使用 HTTPS,不能包含用户名/密码、查询参数或 fragment。模型 ID 为非空字符串,最多 200 字符。凭据放在连接 credential 字段,不写入 URL 或 config。
每次验证请求超时为 30 秒,并拒绝重定向。它检查协议形状,不要求回答字面上等于 OK。Responses 的 incomplete 响应也可能通过,所以 ready 不证明任务完整或输出预算足够。验证请求不覆盖流式、Tool 调用或多轮对话。
例如 base 为
https://model.example/service/v1/ 时,Chat Completions 请求地址为 https://model.example/service/v1/chat/completions。若 base 已包含 /chat/completions 等操作路径,系统不会自动纠正。应配置服务实际支持的 API 根路径,不根据供应商名称猜路径;这里的示意域名不是可用端点。
创建片段每次运行都会创建新连接。保存返回 ID,后续变更使用 update/validate/enable。创建响应丢失时先检查已有记录,不直接重跑创建;友好显示名称不是唯一请求键。
用已有记录的端点完成任务
作为一个具体的 Chat Completions 起点,11 月 18 日矩阵记录了https://api.minimaxi.com/v1、模型 MiniMax-M3 与内置 Pi 1.5.2 / OpenCode 1.2.27 的 Python、TypeScript 独立任务。只有当这就是你准备使用的服务时,才将这些值与自己获准的凭据填入配置示例。这是历史证据,不是当前账户检查。
保存启用后的模型连接 ID,选择精确 Harness 与已验证的 Sandbox 组合,再用首个 Session 程序执行。保留其中的持久 journal、产物内容验证、关闭与留存检查,并分别运行两套客户端。11 月 20 日的首个 Session 证据使用另一个已配置的 Messages 端点,不能证明该教程重新运行过这里的 Chat 配置。
验证后的使用
把返回连接 ID 作为 Session 的 model_connection_id,选择兼容 Harness。验证会发送有界模型请求,可能消耗模型额度;它不等于完整 Agent Tools / 多轮验收。 模型原始 key 留在控制平面。运行时使用受保护通道,向 guest 提供限定授权或原生占位,而不是复制账户 key 到普通 env。不要为了修复网络失败把原 key 填入 Agent prompt。失败定位
先检查精确 base URL、协议、模型 ID、账户权限与余额,再区分控制平面到上游网络和 Sandbox 到凭据入口。model_response_invalid 表示返回形状不符合该验证器预期;不能仅凭 200 判定兼容。配置或凭据更新后重新验证、启用,并考虑新 Session 的固定配置。
完成接入需真实 Run 产生预期回答,按需要执行 Tool、连续第二轮和流式结果,最后清理。参考历史模型记录选择已验证试验组合,但保留新测试独立证据。
依据:模型适配器、Responses。下一步:协议兼容性、选择组合、网络入口。