---
title: "OpenAI Agents SDK dengan custom provider OpenAI-compatible"
description: "Pakai OpenAI Agents SDK untuk Python dengan BroadNet Inference lewat AsyncOpenAI dan OpenAIChatCompletionsModel, lalu matikan tracing yang butuh kunci OpenAI."
url: https://broadrouter.com/id/guides/openai-agents-sdk-custom-provider/
lang: id
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Diterjemahkan dari bahasa Inggris dengan bantuan AI. [Baca versi asli bahasa Inggris](https://broadrouter.com/guides/openai-agents-sdk-custom-provider/) (diperbarui 2026-11-16).

# Menjalankan OpenAI Agents SDK di BroadNet Inference

Diperbarui 2026-11-16

Buat client AsyncOpenAI dengan base\_url https://inference.broadnet.ai/v1 dan kunci BroadNet Anda, bungkus dalam OpenAIChatCompletionsModel dengan ID model seperti broadnet/glm-5.3, lalu berikan model itu ke Agent. Panggil set\_tracing\_disabled(True), kecuali Anda punya kunci OpenAI terpisah untuk tracing.

OpenAI Agents SDK adalah framework Python untuk agen dengan tools, handoff, dan guardrail. Dokumentasinya menjelaskan cara memasang provider non-OpenAI. Untuk API yang kompatibel dengan OpenAI seperti BroadNet Inference, Anda memberikan client `AsyncOpenAI` milik Anda sendiri ke SDK dan memakai kelas model Chat Completions. Secara default SDK memakai Responses API, yang tidak disediakan oleh banyak provider.

## Setup

1.  **Instal SDK-nya.** Dibutuhkan Python 3.10 atau lebih baru.

```bash
pip install openai-agents
export BROADNET_API_KEY='your-broadnet-key'
```

2.  **Buat client, model, dan agen.**

```python
import asyncio
import os

from agents import (
    Agent,
    AsyncOpenAI,
    OpenAIChatCompletionsModel,
    Runner,
    function_tool,
    set_tracing_disabled,
)

set_tracing_disabled(disabled=True)  # tracing needs a platform.openai.com key

client = AsyncOpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)

model = OpenAIChatCompletionsModel(model="broadnet/glm-5.3", openai_client=client)

@function_tool
def get_order_status(order_id: str) -> str:
    """Look up an order."""
    return f"Order {order_id}: shipped"

agent = Agent(
    name="Support agent",
    instructions="Answer briefly. Use tools when you need order data.",
    model=model,
    tools=[get_order_status],
)

async def main():
    result = await Runner.run(agent, "Where is order 4471?")
    print(result.final_output)

asyncio.run(main())
```

3.  **Jalankan.** Agen seharusnya memanggil `get_order_status` dan menjawab berdasarkan hasilnya.

## Tiga cara memasang provider

Dokumentasi SDK mencantumkan opsi bawaan berikut:

-   **Per agen:** berikan `OpenAIChatCompletionsModel` sebagai `Agent.model`, seperti di atas. Pakai cara ini jika agen yang berbeda memakai provider yang berbeda.
-   **Default global:** `set_default_openai_client(client)` menjadikan client Anda sebagai default. Pasangkan dengan `set_default_openai_api("chat_completions")`.
-   **Per run:** berikan `ModelProvider` kustom di `RunConfig(model_provider=...)`.

Default global terlihat seperti ini:

```python
import os
from agents import (
    Agent,
    AsyncOpenAI,
    set_default_openai_api,
    set_default_openai_client,
    set_tracing_disabled,
)

client = AsyncOpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])
set_default_openai_client(client, use_for_tracing=False)
set_default_openai_api("chat_completions")
set_tracing_disabled(True)

agent = Agent(name="Assistant", instructions="Be brief.", model="broadnet/glm-5.3")
```

Jika hanya memakai environment variable, atur `OPENAI_BASE_URL=https://inference.broadnet.ai/v1` dan isi `OPENAI_API_KEY` dengan kunci BroadNet Anda, lalu lakukan panggilan `set_default_openai_api` dan `set_tracing_disabled` yang sama.

Menurut dokumentasi SDK, saat dirutekan lewat Chat Completions, SDK diam-diam membuang field yang khusus Responses, seperti `previous_response_id`, `conversation_id`, dan `prompt`. Agar muncul error sebagai gantinya, atur `strict_feature_validation=True` pada `OpenAIProvider`. Simpan state percakapan di kode Anda sendiri, misalnya dengan meneruskan daftar input dari hasil sebelumnya ke run berikutnya. Tools yang di-host OpenAI, seperti web search dan file search, tidak ada di provider lain. Gunakan `function_tool` untuk apa pun yang perlu dipanggil agen.

## Tracing

Tracing aktif secara default dan mengirim trace ke OpenAI. Dokumentasi SDK menyebut bahwa tanpa API key dari platform.openai.com, Anda sebaiknya mematikannya dengan `set_tracing_disabled()` atau memasang tracing processor lain. Jika Anda punya kunci OpenAI, tracing bisa tetap aktif dengan memberikan kunci itu lewat `set_tracing_export_api_key(...)`. SDK memakainya hanya untuk mengunggah trace. Kunci BroadNet Anda tidak bisa dipakai untuk itu.

## Model mana yang dipilih

| Jenis agen | Model | Catatan |
| --- | --- | --- |
| Agen yang memakai tools | [GLM 5.3](https://broadrouter.com/id/models/glm-5.3/) | Tools dan output terstruktur tercantum; konteks 1M |
| Input gambar dengan tools | [Qwen3.8 27B](https://broadrouter.com/id/models/qwen3.8-27b/) | Konteks 262K; diuji dalam bahasa Arab |
| Agen yang berjalan lama dengan tarif tetap | [DeepSeek V4.1 Flash](https://broadrouter.com/id/models/deepseek-v4.1-flash/) | Paket unlimited; tools tidak dicantumkan BroadNet |

Dokumentasi SDK memperingatkan bahwa sebagian provider tidak mendukung output terstruktur dengan JSON schema. Jika Anda mengatur `output_type` pada agen, gunakan GLM 5.3 atau Qwen3.8 27B. Bandingkan harganya di [halaman harga](https://broadrouter.com/id/pricing/).

## Troubleshooting

-   **401.** Kunci BroadNet salah, kedaluwarsa, atau jatah bayar sesuai pemakaiannya habis. Error tracing di log adalah hal terpisah: artinya tracing masih aktif tanpa kunci OpenAI.
-   **404 atau “not found”.** Kemungkinan Anda memakai Responses API. Gunakan `OpenAIChatCompletionsModel` atau `set_default_openai_api("chat_completions")`. Jika itu sudah diatur, pastikan ID model sama persis dengan ID BroadNet. Model berbayar memerlukan top up; kredit $5 hanya mencakup Gemma 4 VL 26B.
-   **`final_output` kosong.** Penalaran ikut dihitung dalam `max_tokens`. Jika Anda mengatur `ModelSettings(max_tokens=...)`, naikkan nilainya. [Kenapa jawaban kembali kosong](https://broadrouter.com/id/guides/reasoning-tokens-empty-response/).
-   **429.** Kunci bayar sesuai pemakaian mengizinkan 30 permintaan per menit dan 4 permintaan sekaligus. Setiap putaran tool adalah permintaan baru. Lihat [error dan percobaan ulang](https://broadrouter.com/id/guides/errors-and-retries/).
-   **Agen paralel di paket.** Satu [sesi paket unlimited](https://broadrouter.com/id/guides/unlimited-llm-api-sessions/) menjalankan satu permintaan dalam satu waktu. Agen yang dijalankan bersamaan dengan `asyncio.gather` masing-masing butuh satu sesi, kalau tidak mereka akan mengantre. Lihat [menjalankan agen paralel dengan tarif tetap](https://broadrouter.com/id/blog/run-parallel-coding-agents-flat-rate/).

## Istilah dalam panduan ini

[Tool calling (function calling)](https://broadrouter.com/id/glossary/tool-calling/)

Tool calling, disebut juga function calling, adalah fitur API LLM di mana model mengembalikan permintaan terstruktur untuk menjalankan fungsi yang didefinisikan developer, lengkap dengan argumen JSON. Aplikasi yang menjalankan fungsi itu dan mengirim hasilnya kembali; model tidak pernah menjalankan kode sendiri.

[Bayar sesuai pemakaian (pay-as-you-go)](https://broadrouter.com/id/glossary/pay-as-you-go/)

Bayar sesuai pemakaian (pay-as-you-go) adalah model harga di mana Anda hanya membayar yang Anda pakai, dihitung per satuan seperti token, permintaan, atau menit audio, tanpa langganan atau komitmen minimum. Sebagian besar API LLM menagih dengan cara ini, dari saldo prabayar atau tagihan berkala.

[Chat Completions API](https://broadrouter.com/id/glossary/chat-completions-api/)

Chat Completions API adalah endpoint HTTP milik OpenAI, POST /v1/chat/completions, yang menerima nama model dan daftar pesan bertanda peran lalu mengembalikan pesan berikutnya dari model. Bentuk request dan response-nya menjadi format umum yang dipakai ulang oleh penyedia dan SDK yang kompatibel dengan OpenAI.

[Konkurensi (concurrency)](https://broadrouter.com/id/glossary/concurrency/)

Konkurensi (concurrency) adalah jumlah permintaan yang sedang berjalan dari sebuah client pada saat yang sama. API LLM sering membatasinya per kunci atau per paket, terpisah dari batas permintaan per menit, karena setiap permintaan yang terbuka menahan kapasitas GPU sampai responsnya selesai.

[Output terstruktur (structured output)](https://broadrouter.com/id/glossary/structured-output/)

Output terstruktur adalah fitur API LLM yang membatasi balasan model pada format yang ditentukan developer, biasanya JSON Schema, agar kode bisa mem-parse-nya dengan andal. Fitur ini lebih ketat daripada JSON mode, yang menjamin JSON valid tetapi tidak menjamin bentuk tertentu.

[Rate limit (batas laju)](https://broadrouter.com/id/glossary/rate-limit/)

Rate limit adalah batas yang diterapkan API pada seberapa banyak client boleh memakainya dalam rentang waktu tertentu, misalnya permintaan per menit atau token per menit. Permintaan yang melebihi batas ditolak, biasanya dengan HTTP 429 Too Many Requests, sampai pemakaian kembali di bawah batas.

[API kompatibel OpenAI](https://broadrouter.com/id/glossary/openai-compatible-api/)

API kompatibel OpenAI adalah API HTTP yang menerima format permintaan dan respons yang sama dengan API OpenAI, seperti POST /v1/chat/completions, sehingga SDK dan tool OpenAI bisa memakainya hanya dengan mengganti base URL, kunci API, dan nama model.

[JSON Schema (skema JSON)](https://broadrouter.com/id/glossary/json-schema/)

JSON Schema adalah kosakata yang ditulis dalam JSON untuk mendeskripsikan dan memvalidasi struktur data JSON: tipe, field wajib, nilai yang diizinkan, dan susunan bertingkat. Versi terbarunya 2020-12. API LLM memakainya untuk mendefinisikan parameter tool dan bentuk persis yang harus diikuti output terstruktur.

## Pertanyaan umum

### Kenapa Agents SDK memberi error 404 dengan base URL kustom?

Secara default SDK memakai Responses API, sedangkan BroadNet melayani chat completions. Gunakan OpenAIChatCompletionsModel, atau panggil set\_default\_openai\_api("chat\_completions") jika Anda mengonfigurasi client lewat environment variable.

### Kenapa Agents SDK mengeluh soal tracing?

Tracing mengunggah data ke OpenAI dan butuh kunci dari platform.openai.com. Dokumentasi SDK menyarankan set\_tracing\_disabled() jika Anda tidak punya kunci itu, atau memakai tracing processor lain.

### Bisakah Agents SDK dikonfigurasi hanya dengan environment variable?

Bisa. Isi OPENAI\_BASE\_URL dengan https://inference.broadnet.ai/v1 dan OPENAI\_API\_KEY dengan kunci BroadNet Anda, lalu panggil set\_default\_openai\_api("chat\_completions") dan set\_tracing\_disabled(True). OPENAI\_DEFAULT\_MODEL menentukan model untuk agen yang tidak menyebut model.

### Berapa sesi paket yang dibutuhkan untuk run multi-agen?

Satu sesi per permintaan yang berjalan bersamaan. Handoff menjalankan agen satu per satu, jadi satu sesi sudah cukup. Agen yang dijalankan paralel dengan asyncio.gather masing-masing butuh satu sesi.

## Panduan terkait

-   [Memakai OpenAI Python SDK dengan BroadNet Inference](https://broadrouter.com/id/guides/openai-python-sdk/)
-   [Cara kerja paket API LLM unlimited untuk agen](https://broadrouter.com/id/guides/unlimited-llm-api-sessions/)
-   [Kenapa model reasoning mengembalikan jawaban kosong](https://broadrouter.com/id/guides/reasoning-tokens-empty-response/)
-   [Mengarahkan LiteLLM ke BroadNet Inference (SDK dan proxy)](https://broadrouter.com/id/guides/litellm-proxy-custom-provider/)
-   [Semua alat yang bisa dipakai dengan BroadNet Inference (bahasa Inggris)](https://broadrouter.com/integrations/): SDK, agen coding, antarmuka chat, dan alat otomatisasi, lengkap dengan pengaturan persis untuk masing-masing

Coba dengan beban kerja Anda yang sebenarnya. Akun baru mendapat kredit US$5 untuk Gemma dan transkripsi. DeepSeek, GLM, dan Qwen3.8 memerlukan top up.

[Mulai](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-guides-openai-agents-sdk-custom-provider&utm_content=page-cta) ·

**Sumber**

-   [Dokumentasi OpenAI Agents SDK, Models (provider non-OpenAI) (diperiksa 2026-11-14)](https://openai.github.io/openai-agents-python/models/)
-   [PyPI, paket openai-agents (0.24, Python 3.10+, diperiksa 2026-11-14)](https://pypi.org/project/openai-agents/)
-   [Referensi API BroadNet Inference (bahasa Inggris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-guides-openai-agents-sdk-custom-provider&utm_content=sources)
