request protocol
从本地请求 path 检测出的入站协议，例如 openai_responses 或 anthropic_messages。
不要混淆: Provider
protocol，后者控制出站 wire 行为。使用位置
routingingresscaptures
术语表
文档、配置、代码注释、日志和 capture metadata 中应一致使用这些术语。本页是术语地图；精确取值以对应 reference 页面为准。
provider protocol
配置在 provider 上的出站协议；控制 provider request 序列化和 upstream response 处理。
不要混淆: Provider name。名称只是用户标签，不表达协议语义。
使用位置
providerstranslationtransport
protocol value
openai_responses、openai_chat_completions 或 anthropic_messages 三者之一。
不要混淆: OpenAI 或 Anthropic 这类市场名称；protocol value 描述 wire 行为。
使用位置
configroutingtranslation
translation pair
从入站 request protocol 到 provider protocol 的有向转换，例如 openai_chat_completions -> anthropic_messages。
不要混淆: Provider route。Route 选择 provider；translation pair 转换 payload 和 stream。
使用位置
translationcompatibility
provider name
配置好的上游 provider 的用户定义标签。
不要混淆: Provider protocol。名称
anthropic 不会自动意味着 anthropic_messages。使用位置
configroutes
route
默认 provider fallback 之前用于选择 provider 的显式 model/protocol 规则。
不要混淆: Default provider selection；它只在没有显式 route 命中时生效。
使用位置
routingconfig
request_protocol guard
可选 route 字段，把一个模型匹配限制到某个检测出的入站协议。
不要混淆: Provider protocol。Guard 过滤入站匹配，不控制出站序列化。
使用位置
routingconfig
Phase 与诊断
Section titled “Phase 与诊断”inbound_request
包含 ProxAI 收到的本地客户端请求的 pipeline phase。
不要混淆:
provider_request，后者已经经过 provider 选择、转换、模型改写和序列化。使用位置
captureslogs
provider_request
包含选中、转换并序列化后的 provider request 的 pipeline phase。
不要混淆: 原始入站客户端 payload。Provider request 可能使用不同协议和模型名。
使用位置
capturesprovider request
upstream_response
包含上游 status、headers 和原始 body bytes 的 pipeline phase。
不要混淆:
outbound_response，后者已经过 response translation/reconstruction。使用位置
capturesprovider response
outbound_response
包含返回给本地客户端的最终响应的 pipeline phase。
不要混淆: 上游原始 body；outbound response 可能已经被转换成入站协议形状。
使用位置
capturesclient response
capture phase
可写入可选调试 artifacts 的具名 pipeline 位置。
不要混淆: Logs。Captures 可能包含私有 payload 数据，需要更严格处理。
使用位置
debuggingprivacy
request hints
紧凑的、协议感知的日志摘要，避免记录 private request bodies。
不要混淆: Payload captures，后者是显式本地产物。
使用位置
logsobservability
SSE
Server-Sent Events；OpenAI 兼容与 Anthropic 风格 streaming response 使用的流式 carrier。
不要混淆: 协议事件语义。SSE 是 carrier；每个协议定义自己的事件名和终止标记。
使用位置
streamingtranslation
terminal event
标记语义流完成的协议特定事件或 sentinel，例如 response.completed、[DONE] 或 message_stop。
不要混淆: TCP 连接关闭。没有 terminal event 的 byte stream 关闭仍可能是语义不完整。
使用位置
streamingtool calls
semantic timeout
协议语义条件的超时，例如 streamed tool-call arguments 已开始但未完成。
不要混淆: Idle-read timeout，后者表示没有上游 bytes 到达。
使用位置
tool callsstreaming
idle-read timeout
等待上游 response bytes 时的传输层超时。
不要混淆: 总请求时长上限。它只在配置窗口内没有新 bytes 到达时触发。
使用位置
transportstreaming
stop reason
Provider/protocol-specific 的 generation 结束原因，例如 Anthropic stop_reason。
不要混淆: OpenAI Chat
finish_reason 或 Responses status；映射是协议特定的。使用位置
responsesstreaming
client-facing error type
返回给客户端的稳定紧凑 type 值，例如 stream_translation_error。
不要混淆:
TranslationError 或 SseError 这类内部 Rust error taxonomy。使用位置
errorsSDKs