OpenAI 代理 SDK - Hostlinku Docs

OpenAI Agents SDK 默认使用 Responses API，该 API 由 Hostlinku 在 POST /v1/responses 中提供。只需向 OpenAI 客户端提供 base_url Hostlinku，并关闭跟踪功能（跟踪数据将导出到 OpenAI 平台，而非通过网关）。

代理循环的工作原理

每个 agent loop 循环都对应一次向 Hostlinku 网关发出的请求：代理发送提示，模型通过 工具调用 进行响应，代理在本地运行工具（读写文件、执行命令），然后将结果发回-如此循环往复，直至模型给出最终答案。网关将每个循环路由到上游模型，所有操作都会在控制台中单独记录 → 请求日志，其中包含Token和费用信息。

Hostlinku 代理循环图：IDE/编码代理、Hostlinku 网关、上游模型、Hostlinku 控制台以及本地工作区

无需修改代码：环境变量

SDK OpenAI 读取 OPENAI_BASE_URL 和 OPENAI_API_KEY，因此无需修改代码即可将 Agents SDK 重定向至 Hostlinku - 只需通过环境变量关闭跟踪即可：

export OPENAI_BASE_URL=https://api.hostlinku.com/v1
export OPENAI_API_KEY=sk-isi-api-key-kamu          # API key Hostlinku
export OPENAI_AGENTS_DISABLE_TRACING=1
python agent.py

是Responses API还是Chat Completions？

默认 SDK 是 Responses API（/v1/responses）-建议使用该版本，因为它支持 reasoning 项，且工具流程最为完整。若需使用 Chat Completions（/v1/chat/completions）：

from agents import set_default_openai_api
set_default_openai_api("chat_completions")

import { setOpenAIAPI } from "@openai/agents";
setOpenAIAPI("chat_completions");

两者使用相同的API密钥、余额和请求日志。

通过网关支持的

Agents SDK 功能	状态
`function_tool` / `tool()`，并行工具调用	是
代理之间的交接（包括每个代理采用不同的模型）	是的-将`claude-sonnet-4-6`和`gpt-5-5`混合在同一条生产线上
结构化输出（`output_type` / Zod）	是的，在支持 JSON 模式的模型中
流式传输 (`Runner.run_streamed`, `run(..., { stream: true })`)	是
`reasoning={"effort": …}` 经由 `ModelSettings`	是的，转给模型
托管工具 OpenAI（`WebSearchTool`、`FileSearchTool`、`CodeInterpreterTool`）	取决于目标模型；如果不可用，请单独以`function_tool`身份运行该工具
追踪至OpenAI平台	不经过网关-请关闭，或使用第三方跟踪处理器

故障排除

错误日志中出现 tracing export 401 - 跟踪功能尚未关闭；请调用 set_tracing_disabled(True) / setTracingDisabled(true) 或设置 OPENAI_AGENTS_DISABLE_TRACING=1。
400 previous_response_id tidak didukung - 停止使用 previous_response_id / conversation_id；请参见上方的说明。
404 model_not_found - model= 的 slug 应为 Hostlinku，而非原始模型 OpenAI/Anthropic。

​代理循环的工作原理

​无需修改代码：环境变量

​是Responses API还是Chat Completions？

​通过网关支持的

​故障排除

代理循环的工作原理

无需修改代码：环境变量

是Responses API还是Chat Completions？

通过网关支持的

故障排除