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

28 lines
2.6 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适配,保留既有Chat Completions。品牌、模型名称与声明不能替代检测。现有API代理可按实际协议添加;未知WorkBuddy登录态、Anthropic原生协议及视觉/音频输入仍未接入。
## 实际协议
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以保持现有可选参数契约。
混合协议或流式模型池封存每个成员实际请求变体;真正发送的请求另有原字节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)
以上是协议依据,不能证明任意代理完整兼容。专项使用自有loopback服务;真实模型工程效果和Purge收益仍按用户此前选择单独待验。