Output item identity影响 多轮引用Responses 有稳定 output items 和 item references;其他协议可能只暴露 message blocks。
支持某个转换 pair,并不代表每个 provider-specific 或 protocol-specific 字段都能完全对称。ProxAI 优先保留行为,其次才是原始字段名称。
| 术语 | 含义 |
|---|---|
透传 | 入站协议和 provider 协议相同。ProxAI 仍负责路由、认证、传输、错误和观测。 |
支持的转换 | ProxAI 对 request/response/streaming 行为有显式协议 pair 实现。 |
有损映射 | 目标协议无法精确表达某些源细节,因此 ProxAI 保留最接近的行为。 |
不支持的 pair | 不存在转换实现;ProxAI 会显式失败。 |
Output item identity影响 多轮引用Responses 有稳定 output items 和 item references;其他协议可能只暴露 message blocks。
Tool-call streaming影响 增量拼装不同协议用 index、id、content block index 或 item id 标识工具调用。
Reasoning controls影响 effort 和 summaryReasoning effort 与 summary controls 在不同 provider 间不对称。
Stop and finish reasons影响 终止状态stop_reason、finish_reason 和 response status 相关但不完全相同。
Hosted tools影响 provider 能力目标 provider 可能不支持源协议使用的 hosted tool 模型。
Provider metadata影响 隐私和可移植性Provider-specific signatures 或 ids 应转换或省略,而不是作为通用 output 泄漏。
| 需求 | 优先选择 |
|---|---|
| 精确 output item id 和原生 Responses 多轮行为 | 可用时使用 openai_responses 入站到 openai_responses provider。 |
旧客户端要求 choices[] | 使用 openai_chat_completions 入站和兼容 provider 协议。 |
| Anthropic-native content block 行为 | 使用 anthropic_messages 入站和 anthropic_messages provider。 |
| 更看重本地客户端兼容,而非精确上游 shape | 使用预期明确的已支持转换 pair。 |
| 调试转换行为 | 开启最窄 capture phase,对比 provider_request / outbound_response。 |