跳转到内容

信息损失与保真度

支持某个转换 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 和 summary

Reasoning effort 与 summary controls 在不同 provider 间不对称。

Stop and finish reasons影响 终止状态

stop_reasonfinish_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。
  • 不支持的 pair 显式失败。
  • 跨协议转换不得静默泄漏原始 provider 结构。
  • 流式转换必须保留终止语义。
  • 工具调用完成必须和自然文本完成保持区分。
  • 目标协议能表达时,应保留错误和 refusal 语义。