OpenAI Agents SDK - Hostlinku Docs

OpenAI Agents SDK secara default memakai Responses API, yang disediakan Hostlinku di POST /v1/responses. Cukup berikan client OpenAI dengan base_url Hostlinku, dan matikan tracing (tracing diekspor ke platform OpenAI, bukan lewat gateway).

Cara kerja agent loop

Setiap putaran agent loop adalah satu request ke Hostlinku Gateway: agent mengirim prompt, model membalas dengan tool call, agent menjalankan tool secara lokal (baca/tulis file, eksekusi perintah) lalu mengirim hasilnya kembali — begitu seterusnya sampai model memberi jawaban akhir. Gateway me-routing setiap putaran ke model upstream, dan semuanya tercatat terpisah di console → Log Permintaan lengkap dengan token dan biayanya.

Diagram agent loop Hostlinku: IDE/coding agent, Hostlinku Gateway, model upstream, Hostlinku Console, dan workspace lokal

Tanpa mengubah kode: environment variable

SDK OpenAI membaca OPENAI_BASE_URL dan OPENAI_API_KEY, sehingga Agents SDK bisa diarahkan ke Hostlinku tanpa menyentuh kode — cukup matikan tracing lewat env juga:

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 atau Chat Completions?

Default SDK adalah Responses API (/v1/responses) — disarankan, karena mendukung item reasoning dan alur tool yang paling lengkap. Bila ingin 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");

Keduanya memakai API key, saldo, dan Request Logs yang sama.

Yang didukung lewat gateway

Fitur Agents SDK	Status
`function_tool` / `tool()`, parallel tool calls	Ya
Handoffs antar agent (termasuk model berbeda per agent)	Ya — campur `claude-sonnet-4-6` dan `gpt-5-5` dalam satu alur
Structured output (`output_type` / Zod)	Ya pada model yang mendukung JSON schema
Streaming (`Runner.run_streamed`, `run(..., { stream: true })`)	Ya
`reasoning={"effort": …}` via `ModelSettings`	Ya, diteruskan ke model
Hosted tools OpenAI (`WebSearchTool`, `FileSearchTool`, `CodeInterpreterTool`)	Tergantung model tujuan; jalankan tool sebagai `function_tool` sendiri bila tidak tersedia
Tracing ke platform OpenAI	Tidak lewat gateway — matikan, atau gunakan trace processor pihak ketiga

Troubleshooting

Log penuh error tracing export 401 — tracing belum dimatikan; panggil set_tracing_disabled(True) / setTracingDisabled(true) atau set OPENAI_AGENTS_DISABLE_TRACING=1.
400 previous_response_id tidak didukung — hapus penggunaan previous_response_id / conversation_id; lihat callout di atas.
404 model_not_found — model= harus slug Hostlinku, bukan nama model OpenAI/Anthropic asli.

​Cara kerja agent loop

​Tanpa mengubah kode: environment variable

​Responses API atau Chat Completions?

​Yang didukung lewat gateway

​Troubleshooting

Cara kerja agent loop

Tanpa mengubah kode: environment variable

Responses API atau Chat Completions?

Yang didukung lewat gateway

Troubleshooting