> ## 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 Chat Completions

将 AgentCompass 连接到 OpenAI 兼容对话补全端点。

`openai-chat` 协议适用于兼容 OpenAI Chat 补全请求结构的端点，通常暴露在`/v1/chat/completions`。

标准请求与响应结构见 [OpenAI Chat Completions API 官方参考](https://developers.openai.com/api/reference/resources/chat/subresources/completions/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-chat \
  --model-params '{"temperature":0}'
```

model ID 是第三个位置参数。AgentCompass 通过所选 Harness 发送消息，并把支持的 `--model-params` 值转发给端点。

## 常用参数

| 参数            | 作用                                |
| ------------- | --------------------------------- |
| `temperature` | 端点支持时控制采样随机性。                     |
| `max_tokens`  | 限制生成的完成词元。                        |
| `timeout`     | 设置 AgentCompass 直接协议客户端的请求超时。     |
| `max_retries` | 设置 AgentCompass 直接协议客户端的 SDK 层重试。 |

Harness 可能添加、转换或限制 model 参数。在不同 agent 实现之间复制配置前，请查看所选[Harness](/zh/user_guide/modules/harnesses/overview) 页面。

## 何时使用

以下情况选择 `openai-chat`：

* provider 声明兼容对话补全；
* 所选 Harness 支持 `openai-chat`；
* 评测不依赖响应专属 状态或请求字段。

有状态响应端点请使用 [OpenAI 响应](/zh/user_guide/modules/models/openai_responses)；Anthropic 兼容端点请使用 [Anthropic Messages](/zh/user_guide/modules/models/anthropic_messages)。