OpenAI Responses

将 AgentCompass 连接到 OpenAI 响应兼容 端点。

openai-responses 协议适用于兼容 OpenAI Responses API 的端点，通常暴露在 /v1/responses。

标准请求与响应结构见 OpenAI Responses API 官方参考；兼容端点支持的具体字段以 provider 文档为准。

​

配置协议

export MODEL_NAME=""
export MODEL_BASE_URL="https://your-endpoint.example/v1"
export MODEL_API_KEY="sk-..."

agentcompass run <benchmark> <harness> "$MODEL_NAME" \
  --env <environment> \
  --model-base-url "$MODEL_BASE_URL" \
  --model-api-key "$MODEL_API_KEY" \
  --model-api-protocol openai-responses \
  --model-params '{"reasoning":{"effort":"high"}}'

​

兼容性转换

runtime 组件使用共享协议客户端时，AgentCompass 会把对话式 消息历史和函数工具转换为响应输入项目，并把响应输出标准化为常用 Harness 逻辑需要的对话式内部结构。

为了兼容已有 model 配置：

• 未设置 max_output_tokens 时，max_tokens 转换为 max_output_tokens；
• 未设置 reasoning 时，reasoning_effort 转换为 reasoning.effort；
• 所选 Harness 和端点支持时，显式响应原生字段保持不变并直接传入。

​

何时使用

只有 provider 和所选 Harness 明确支持 Responses API 时才选择 openai-responses，尤其适用于推理或有状态工具调用工作流。不要仅因为端点声明 OpenAI 兼容就选择它；很多兼容 provider 只实现了对话补全，没有实现响应。

对话补全端点见 OpenAI Chat，协议兼容性见选择 Harness。