> ## Documentation Index
> Fetch the complete documentation index at: https://agent-compass.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAI Responses

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

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

标准请求与响应结构见 [OpenAI Responses API 官方参考](https://developers.openai.com/api/reference/resources/responses/methods/create)；兼容端点支持的具体字段以 provider 文档为准。

## 配置协议

```bash theme={"system"}
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](/zh/user_guide/modules/models/openai_chat)，协议兼容性见[选择 Harness](/zh/user_guide/modules/harnesses/overview)。