跳转到内容
ProxAI

协议模型总览

协议模型总览

Section titled “协议模型总览”

ProxAI 把数据处在代理链路的哪个阶段和这个阶段使用哪种 wire protocol拆成两个独立概念。这个页面是协议指南的入口：当你需要理解 request path、协议取值、转换支持或各协议交互示例时，从这里开始。

两条轴线

Section titled “两条轴线”
  1. 1inbound_request客户端发给 ProxAI 的原始请求。
  2. 2provider_requestProxAI 准备发给选中上游 provider 的请求。
  3. 3upstream_response上游 provider 返回给 ProxAI 的响应。
  4. 4outbound_responseProxAI 返回给客户端协议的响应。
协议值Wire 行为
openai_responsesOpenAI Responses API：item 化 output[]、稳定 item_id、类型化 streaming events。
openai_chat_completionsOpenAI Chat Completions API：choices[]、assistant messages、tool_calls[]、[DONE] stream。
anthropic_messagesAnthropic Messages API：单个 Message、扁平 content[] blocks、content_block streaming events。

按任务阅读

Section titled “按任务阅读”
我要配置路由当你要决定哪个 provider 处理哪个模型或请求 endpoint 时，看这里。我要理解协议行为当你需要 request/response shape、流式行为或交互示例时，看这里。我要维护转换逻辑当你维护 `src/translation/` 或评审跨协议语义时，看这里。我要查精确协议取值配置值、请求 path、支持转换对等稳定查表内容在 Reference 中。我要对齐停止原因比较 status、finish_reason、stop_reason 和流式终止事件时看这里。

协议文档

Section titled “协议文档”
如何选择协议配置透传或转换路由前，先决定入站协议和 provider 协议。信息损失与保真度理解跨协议转换在哪里能保留行为、但不能保留精确源 shape。OpenAI Responses 概览Responses 请求/响应模型与 output item 语义。OpenAI Responses 交互示例Function tools、hosted tools、item ids、content parts 和 terminal response events。OpenAI Chat Completions 概览Chat completion choices、messages、delta 与 tool calls。OpenAI Chat Completions 交互示例Function tools、tool messages、`tool_calls[].index`、finish reason 和 `[DONE]`。Anthropic Messages 概览Anthropic message content blocks、stop reasons 与 streaming events。Anthropic Messages 交互示例本地工具、服务端工具、content block index、message delta 和 `message_stop`。流式行为Terminal events、SSE 预期和工具调用卡住超时行为。

选择协议路径

Section titled “选择协议路径”
客户端调用检测出的 request protocol从这里开始
/v1/responsesopenai_responsesOpenAI Responses
/v1/chat/completionsopenai_chat_completionsOpenAI Chat Completions
/v1/messagesanthropic_messagesAnthropic Messages

转换支持

Section titled “转换支持”
入站 \ ProviderResponsesChatAnthropic
openai_responses透传支持支持
openai_chat_completions不支持透传支持
anthropic_messages支持不支持透传

其他跨协议转换保持显式未支持，直到逐个实现。权威查表页是 协议参考。