跳转到主要内容
Hexagon 的模型连接 provider 表示请求协议,而不是供应商品牌。代理按允许路径转发,不在 Messages、Chat Completions 和 Responses 之间自动转换,也不在失败时猜测另一种协议。

当前 Harness 协议契约

表格描述当前 Hexagon 适配器契约,不代表上游项目的全部能力,也不代表所有镜像和端点已实云验证。OCI 注册固定版本与兼容性元数据;已有注册不会因为适配器后来更新而自动扩展,按当前注册项核对,需要时注册新版本。

带日期的端点实例

以下是仓库在 2026 年 11 月 18 日记录的验收观察,不是本次可用性检查,也不是更换供应商的建议。三行模型 ID 均为 MiniMax-M3,每行协议分别测试;品牌相同不代表接口可以互换。 带日期的矩阵说明支持 Tools 的组合覆盖两轮任务、实际分配的 MCP 调用、输入、环境、产物和清理;其中也保留早期未知创建记录,成功任务行不能证明全局资源全部清理。这些记录补充而不替代预览、审批与故障恢复旅程。使用时检查所选 Sandbox 的精确条目。OCI 路径还需要镜像 digest 与 command,不能把内置验证当作 OCI 验证。

协议相同也要验证行为

完整任务依赖文本流、工具调用格式、工具结果、后续对话、错误形状和模型实际能力。只通过一条问候消息不证明 Tool calling 正常。同样,模型端点自称兼容不保证每个可选字段或运行模式都支持。 Responses 的当前验证请求使用 store:false。Hexagon 不据此承诺服务端内置工具、后台任务轮询、WebSocket 模式或其他 Responses 扩展。Harness 工具仍通过平台 Tool mailbox 和审批机制执行。 OpenCode / Pi 的部分 Responses 契约使用真实二进制与确定性端点测试;这证明对应协议分支,不是所有真实供应商账户认证。实云记录应包含精确模型端点、模型 ID、Harness 版本、SDK 与任务范围。

在请求链路中定位失败

验证错误可能在分配 Sandbox 之前出现;后续 Run 也可能因为 Sandbox 无法访问凭据入口失败,即使控制平面仍能访问模型端点。分别诊断两段网络。协议不匹配不应靠轮换凭据解决,入口被阻断也不应靠把上游密钥写入 guest 配置解决。

如何选择和定位错误

先核对账户端点提供的协议,再选 Harness 支持的交集。比如使用 codex-v1 时应配置真正的 Responses 端点;给 Messages URL 改一个 provider 名称不能完成转换。base URL 不附加最终操作路径,避免生成重复路径。 预检 incompatible_model 时检查协议类型而不是密钥;验证失败时再看实际网络、权限、模型 ID 和响应格式。修正后重新验证与启用,最后运行需要的真实旅程。 依据:Runtime 协议表、内置 Pi、内置 OpenCode。下一步:模型配置、已验证组合、错误参考。