Files
Agent-Workbench/docs/MODEL-PROTOCOLS.md
T

40 lines
5.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 模型协议与能力边界
1.17新增OpenAI Responses适配,1.24.4新增原生Anthropic Messages,保留既有Chat Completions。品牌、模型名称与声明不能替代检测。现有API代理可按实际协议添加;PNG任务图片按各协议发送,未知WorkBuddy登录态、音频和视频输入尚未接入。
## 实际协议
Chat沿用messages与tool_calls/tool_call_id;Responses使用typed input/output Items,function_call.call_id与function_call_output严格配对,保留原用量字段。请求使用store:false,支持同一接口和模型下携带加密reasoning Items,换接口/模型时重新生成普通历史,不泄露私有Items。工具采用strict:false以保持现有可选参数契约。
Messages 使用顶层 system、messages 内容块、tool_use/input_schema 和带原 tool_use_id 的 tool_result。原生 thinking/signature 与 redacted_thinking 只为同地址/型号保留上游历史,不拼成普通助手文本。未知服务端工具和内容块明确暂停;达到输出/上下文上限、pause_turn 或缺少完整终结时不执行工具。
连接选择 Anthropic Messages 后,可填服务根地址或以 /v1 结尾的 API 根地址,界面预览最终 POST 地址;例如 https://api.apikey.fan 和 https://api.apikey.fan/v1 都发送到 https://api.apikey.fan/v1/messages。完整 /messages 端点不作为根地址接受。Chat/Responses 延续原有根地址拼接规则,不自动为其它协议增加 /v1。Messages 默认 x-api-key,可显式选择兼容服务的 Bearer;同时发送 anthropic-version:2023-06-01。保存、选择与切换不自动请求模型。
Messages SSE 必须依次核对 message_start、每个内容块的 start/delta/stop、message_delta 和 message_stop,工具 JSON 必须完整为对象。message_start.message.model 参与原有请求/返回型号核对,严格模式下未知或不一致即暂停,不以注册别名掩盖不一致。原响应和用量保留;相同字符串也不认证底层模型权重。
Messages 的输入计数为 input_tokens + cache_creation_input_tokens + cache_read_input_tokens,message_delta 用量是累计快照,不能把每个快照相加。原字段与缓存分项保留;这是消费记录,不是 Purge 收益证明。原生参数已接入 temperature(0–1)、top_p、top_k、stop_sequences、thinking;max_tokens 始终来自工作台硬预算,不能由自定义参数覆盖。
新的请求账本、消费记录和错误信息保存实际请求 URL 与 fetch 观察到的响应 URL。所有模型请求不自动跟随 HTTP 重定向,避免向跳转目标转发任一种凭据;3xx 保留错误并要求核对地址。旧记录没有保存的历史最终 URL 不补造。
混合协议或流式模型池封存每个成员实际请求变体;真正发送的请求另有原字节SHA、长度和Task/Run所属工件。历史纯Chat请求继续按原格式核对。预算按最大变体估算和最小成员容量保守预留;不把多线路变体总和当一次发送量。
SSE只显示有界进展。完整参数和终结核对前不派发工具;Chat须完整finish_reason及[DONE],Responses须completed且身份、参数和文本与原片段一致。收到流后断开、超时或协议失败不自动换成员重发。主动停止关闭原HTTP并释放租约。保存有界原响应工件;已知凭据会脱敏,原流SHA和脱敏后工件SHA分别保留。超过4MB则停止读取并明确标记捕获范围。
## 能力与检测
文本/工具保留旧连接的协议声明,流式/视觉/音频默认待验证。检测只在用户主动调用后发送合成输入,可能产生上游费用;不输入项目文件、不执行检测工具。文本应答不能证明工具能力,工具须返回要求的原调用及nonce,流式须走真实SSE并完整结束。结果绑定连接和凭据修订及原请求账本;变化后不再显示已验证。
选路复用原轮询、权重、粘连、租约和冷却。能力不符者在获取租约前排除,并在原Run记录具体原因;全部不符记为未派发,不产生上游用量。HTTP401/429、超时、中断及结果未知分别保留,不承诺上游永不中断。
## 来源
实际读取并据以实现的OpenAI官方资料:
- [Responses迁移](https://developers.openai.com/api/docs/guides/migrate-to-responses)
- [函数调用](https://developers.openai.com/api/docs/guides/function-calling)
- [Responses流式事件](https://developers.openai.com/api/docs/guides/streaming-responses?api-mode=responses)
Messages 实际读取依据为 [Anthropic 官方 TypeScript SDK 的 Messages 契约](https://github.com/anthropics/anthropic-sdk-typescript/blob/main/src/resources/messages/messages.ts) 和 [apikey 公开请求示例](https://apikey.fan/docs/api-scripts)。本次两份官方文档网页实际转到地区不可用页,没有将该 HTTP200 当作文档内容。
以上是协议依据,不能证明任意代理完整兼容。专项使用自有loopback服务;真实连接身份预检、真实模型工程效果和Purge收益分别记录,不借用本机夹具结论。