---
title: "OpenAI Agents SDK dengan penyedia serasi OpenAI tersuai"
description: "Guna OpenAI Agents SDK (Python) dengan BroadNet Inference melalui AsyncOpenAI dan OpenAIChatCompletionsModel, dan matikan tracing yang memerlukan kunci OpenAI."
url: https://broadrouter.com/ms/guides/openai-agents-sdk-custom-provider/
lang: ms
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Diterjemahkan daripada bahasa Inggeris dengan bantuan AI. [Baca versi asal dalam bahasa Inggeris](https://broadrouter.com/guides/openai-agents-sdk-custom-provider/) (dikemas kini 2026-11-16).

# Jalankan OpenAI Agents SDK pada BroadNet Inference

Dikemas kini 2026-11-16

Cipta klien AsyncOpenAI dengan base\_url https://inference.broadnet.ai/v1 dan kunci BroadNet anda, balutkannya dalam OpenAIChatCompletionsModel dengan ID model seperti broadnet/glm-5.3, dan hantar model itu kepada Agent anda. Panggil set\_tracing\_disabled(True) melainkan anda mempunyai kunci OpenAI berasingan untuk tracing.

OpenAI Agents SDK ialah rangka kerja Python untuk ejen dengan tools, handoff dan guardrail. Dokumentasinya menerangkan cara memasang penyedia bukan OpenAI. Untuk API serasi OpenAI seperti BroadNet Inference, anda berikan SDK klien `AsyncOpenAI` anda sendiri dan gunakan kelas model Chat Completions. SDK menggunakan Responses API secara lalai, dan banyak penyedia tidak menyediakannya.

## Persediaan

1.  **Pasang SDK.** Ia memerlukan Python 3.10 atau lebih baharu.

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

2.  **Cipta klien, model dan ejen.**

```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.  **Jalankannya.** Ejen sepatutnya memanggil `get_order_status` dan menjawab berdasarkan hasilnya.

## Tiga cara menyambungkan penyedia

Dokumentasi SDK menyenaraikan pilihan terbina dalam ini:

-   **Bagi setiap ejen:** hantar `OpenAIChatCompletionsModel` sebagai `Agent.model`, seperti di atas. Gunakan cara ini apabila ejen yang berbeza menggunakan penyedia yang berbeza.
-   **Lalai global:** `set_default_openai_client(client)` menjadikan klien anda sebagai lalai. Pasangkannya dengan `set_default_openai_api("chat_completions")`.
-   **Bagi setiap larian:** hantar `ModelProvider` tersuai dalam `RunConfig(model_provider=...)`.

Lalai global kelihatan 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")
```

Dengan pemboleh ubah persekitaran sahaja, tetapkan `OPENAI_BASE_URL=https://inference.broadnet.ai/v1` dan `OPENAI_API_KEY` kepada kunci BroadNet anda, kemudian buat panggilan `set_default_openai_api` dan `set_tracing_disabled` yang sama.

Apabila anda melalui Chat Completions, dokumentasi SDK menyatakan ia membuang secara senyap medan khusus Responses, seperti `previous_response_id`, `conversation_id` dan `prompt`. Untuk mendapat ralat sebaliknya, tetapkan `strict_feature_validation=True` pada `OpenAIProvider`. Simpan keadaan perbualan dalam kod anda sendiri, contohnya dengan menghantar senarai input hasil sebelumnya ke larian seterusnya. Tools yang dihoskan oleh OpenAI seperti carian web dan carian fail tidak wujud pada penyedia lain. Gunakan `function_tool` untuk apa sahaja yang perlu dipanggil oleh ejen.

## Tracing

Tracing dihidupkan secara lalai dan menghantar jejak ke OpenAI. Dokumentasi SDK menyatakan bahawa tanpa kunci API daripada platform.openai.com, anda patut mematikannya dengan `set_tracing_disabled()` atau menyediakan pemproses tracing yang lain. Jika anda ada kunci OpenAI, anda boleh kekalkan tracing dan hantar kunci itu dengan `set_tracing_export_api_key(...)`. SDK menggunakannya hanya untuk memuat naik jejak. Kunci BroadNet anda tidak akan berfungsi untuk tujuan ini.

## Model mana yang patut dipilih

| Jenis ejen | Model | Nota |
| --- | --- | --- |
| Ejen yang menggunakan tools | [GLM 5.3](https://broadrouter.com/ms/models/glm-5.3/) | Tools dan output berstruktur disenaraikan; konteks 1M |
| Input imej dengan tools | [Qwen3.8 27B](https://broadrouter.com/ms/models/qwen3.8-27b/) | Konteks 262K; diuji dalam bahasa Arab |
| Ejen yang berjalan lama dengan kadar tetap | [DeepSeek V4.1 Flash](https://broadrouter.com/ms/models/deepseek-v4.1-flash/) | Pelan tanpa had; tools tidak disenaraikan oleh BroadNet |

Dokumentasi SDK memberi amaran bahawa sesetengah penyedia tidak menyokong output berstruktur JSON-schema. Jika anda menetapkan `output_type` pada ejen, gunakan GLM 5.3 atau Qwen3.8 27B. Bandingkan harga di [halaman harga](https://broadrouter.com/ms/pricing/).

## Penyelesaian masalah

-   **401.** Kunci BroadNet salah, tamat tempoh, atau kehabisan elaun bayar ikut guna. Ralat tracing dalam log ialah perkara berasingan: ia bermakna tracing masih hidup tanpa kunci OpenAI.
-   **404 atau “not found”.** Kemungkinan besar anda menggunakan Responses API. Gunakan `OpenAIChatCompletionsModel` atau `set_default_openai_api("chat_completions")`. Jika itu sudah ditetapkan, pastikan ID model sepadan tepat dengan ID BroadNet. Model berbayar memerlukan tambah nilai; kredit $5 meliputi Gemma 4 VL 26B dan dua model Transcribe.
-   **`final_output` kosong.** Penaakulan dikira dalam `max_tokens`. Jika anda menetapkan `ModelSettings(max_tokens=...)`, naikkannya. [Mengapa jawapan kosong](https://broadrouter.com/ms/guides/reasoning-tokens-empty-response/).
-   **429.** Kunci bayar ikut guna membenarkan 30 permintaan seminit dan 4 serentak. Setiap pusingan tool ialah permintaan baharu. Lihat [ralat dan cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/).
-   **Ejen selari pada pelan.** Satu [sesi pelan tanpa had](https://broadrouter.com/ms/guides/unlimited-llm-api-sessions/) menjalankan satu permintaan pada satu masa. Ejen yang dilancarkan serentak dengan `asyncio.gather` memerlukan satu sesi setiap satu, atau mereka akan beratur. Lihat [menjalankan ejen selari dengan kadar tetap](https://broadrouter.com/ms/blog/run-parallel-coding-agents-flat-rate/).

## Istilah dalam panduan ini

[Tool calling (panggilan alatan)](https://broadrouter.com/ms/glossary/tool-calling/)

Tool calling, juga dipanggil function calling, ialah ciri API LLM di mana model memulangkan permintaan berstruktur untuk menjalankan fungsi yang ditakrifkan oleh pembangun, bersama argumen JSON. Aplikasi menjalankan fungsi itu dan menghantar hasilnya kembali; model sendiri tidak pernah menjalankan kod.

[Bayar ikut guna (pay-as-you-go)](https://broadrouter.com/ms/glossary/pay-as-you-go/)

Bayar ikut guna ialah model harga di mana anda hanya membayar apa yang anda guna, dimeter mengikut unit seperti token, permintaan atau minit audio, tanpa langganan atau komitmen minimum. Kebanyakan API LLM mengebil dengan cara ini, daripada baki prabayar atau invois berkala.

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

Chat Completions API ialah endpoint HTTP OpenAI, POST /v1/chat/completions, yang menerima nama model dan senarai mesej bertanda peranan, lalu memulangkan mesej seterusnya daripada model. Bentuk permintaan dan responsnya menjadi format biasa yang digunakan semula oleh penyedia dan SDK yang serasi OpenAI.

[Keserentakan (concurrency)](https://broadrouter.com/ms/glossary/concurrency/)

Keserentakan ialah bilangan permintaan yang sedang berjalan serentak daripada satu klien. API LLM sering mengehadkannya bagi setiap kunci atau pelan, berasingan daripada permintaan seminit, kerana setiap permintaan yang terbuka memegang kapasiti GPU sehingga responsnya selesai.

[Output berstruktur (structured output)](https://broadrouter.com/ms/glossary/structured-output/)

Output berstruktur ialah ciri API LLM yang mengehadkan balasan model kepada format yang ditetapkan oleh pembangun, biasanya JSON Schema, supaya kod boleh menghuraikannya dengan boleh dipercayai. Ia lebih ketat daripada JSON mode, yang menjamin JSON yang sah tetapi bukan bentuk tertentu.

[Pelan LLM harga tetap (flat-rate LLM plan)](https://broadrouter.com/ms/glossary/flat-rate-llm-plan/)

Pelan LLM harga tetap mengenakan harga tetap bagi satu tempoh, seperti sebulan, untuk akses kepada API model bahasa dan bukannya mengebil setiap token. Pelan sebegini biasanya mengehadkan perkara lain, seperti keserentakan, kelajuan, model atau tetingkap penggunaan, jadi hadnya sama penting dengan harganya.

[Tetingkap konteks (context window)](https://broadrouter.com/ms/glossary/context-window/)

Tetingkap konteks ialah bilangan maksimum token yang boleh dikendalikan oleh model bahasa dalam satu permintaan. Ia meliputi prompt, sejarah perbualan, definisi alatan, imej dan output yang dijana, termasuk token penaakulan. Apa-apa yang tidak muat mesti dipotong, diringkaskan atau dipecahkan kepada beberapa permintaan.

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

API serasi OpenAI ialah API HTTP yang menerima format permintaan dan respons yang sama seperti OpenAI API, contohnya POST /v1/chat/completions, jadi SDK dan alat OpenAI boleh menggunakannya dengan hanya menukar base URL, kunci API dan nama model.

## Soalan lazim

### Mengapakah saya mendapat ralat 404 daripada Agents SDK dengan base URL tersuai?

SDK menggunakan Responses API secara lalai, manakala BroadNet menyediakan chat completions. Gunakan OpenAIChatCompletionsModel, atau panggil set\_default\_openai\_api("chat\_completions") jika anda mengkonfigurasi klien melalui pemboleh ubah persekitaran.

### Mengapakah Agents SDK merungut tentang tracing?

Tracing dimuat naik ke OpenAI dan memerlukan kunci daripada platform.openai.com. Dokumentasi SDK mengesyorkan set\_tracing\_disabled() jika anda tiada kunci itu, atau pemproses tracing yang lain.

### Bolehkah saya mengkonfigurasi Agents SDK dengan pemboleh ubah persekitaran sahaja?

Boleh. Tetapkan OPENAI\_BASE\_URL kepada https://inference.broadnet.ai/v1 dan OPENAI\_API\_KEY kepada kunci BroadNet anda, kemudian panggil set\_default\_openai\_api("chat\_completions") dan set\_tracing\_disabled(True). OPENAI\_DEFAULT\_MODEL menetapkan model untuk ejen yang tidak menamakan model.

### Berapakah bilangan sesi pelan yang diperlukan untuk larian berbilang ejen?

Satu bagi setiap permintaan yang berjalan serentak. Handoff menjalankan ejen satu demi satu, jadi satu sesi sudah memadai. Ejen yang dijalankan secara selari dengan asyncio.gather memerlukan satu sesi setiap satu.

## Panduan berkaitan

-   [Cara guna OpenAI Python SDK dengan BroadNet Inference](https://broadrouter.com/ms/guides/openai-python-sdk/)
-   [Cara pelan API LLM tanpa had berfungsi untuk ejen](https://broadrouter.com/ms/guides/unlimited-llm-api-sessions/)
-   [Mengapa model penaakulan memulangkan jawapan kosong](https://broadrouter.com/ms/guides/reasoning-tokens-empty-response/)
-   [Halakan LiteLLM ke BroadNet Inference (SDK dan proksi)](https://broadrouter.com/ms/guides/litellm-proxy-custom-provider/)
-   [Semua alat yang berfungsi dengan BroadNet Inference (Bahasa Inggeris)](https://broadrouter.com/integrations/): SDK, ejen pengekodan, antara muka sembang dan alat automasi, dengan tetapan tepat bagi setiap satu

Cuba dengan beban kerja sebenar anda. Akaun baharu bermula dengan kredit US$5 untuk Gemma dan transkripsi. DeepSeek, GLM dan Qwen3.8 memerlukan tambah nilai.

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

**Sumber**

-   [Dokumentasi OpenAI Agents SDK, Models (penyedia bukan OpenAI) (disemak 2026-11-14)](https://openai.github.io/openai-agents-python/models/)
-   [PyPI, pakej openai-agents (0.24, Python 3.10+, disemak 2026-11-14)](https://pypi.org/project/openai-agents/)
-   [Rujukan API BroadNet Inference (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-guides-openai-agents-sdk-custom-provider&utm_content=sources)
