---
title: "smolagents OpenAIModel dengan api_base tersuai | BroadRouter"
description: "Sambung smolagents Hugging Face ke BroadNet Inference dengan OpenAIModel dan api_base: CodeAgent pada sebarang model, ToolCallingAgent pada GLM 5.3 dan Qwen3.8 27B."
url: https://broadrouter.com/ms/guides/smolagents-openai-compatible/
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/smolagents-openai-compatible/) (dikemas kini 2026-11-16).

# Jalankan smolagents di BroadNet Inference dengan OpenAIModel

Dikemas kini 2026-11-16

Cipta OpenAIModel smolagents dengan model\_id ditetapkan kepada ID BroadNet seperti broadnet/glm-5.3, api\_base kepada https://inference.broadnet.ai/v1 dan api\_key kepada kunci BroadNet anda, kemudian hantarnya kepada CodeAgent atau ToolCallingAgent. CodeAgent menulis Python dan bukannya panggilan alatan asli, jadi ia boleh berjalan pada DeepSeek V4.1 Flash. ToolCallingAgent memerlukan GLM 5.3 atau Qwen3.8 27B.

smolagents ialah pustaka Python kecil Hugging Face untuk ejen. Kelas `OpenAIModel`nya “connects to an OpenAI-compatible API server” (Terjemahan: menyambung ke pelayan API yang serasi OpenAI), dengan `api_base` untuk URL. BroadNet Inference menyediakan chat completions di `https://inference.broadnet.ai/v1`, jadi ia berfungsi terus. BroadRouter ialah laman web BroadNet sendiri; panduan ini mengikut dokumentasi smolagents 1.26.0.

## Pasang

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

## CodeAgent

```python
import os
from smolagents import OpenAIModel, CodeAgent

model = OpenAIModel(
    model_id="broadnet/deepseek-v4.1-flash",
    api_base="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
    max_tokens=4000,
)

agent = CodeAgent(tools=[], model=model)
print(agent.run("What is 6 * 7? Use Python to check."))
```

`CodeAgent` meminta model menulis Python di antara tag `<code>` dan menjalankannya secara setempat. Permintaannya ialah chat completion biasa dengan jujukan henti seperti `</code>`, dan tiada medan `tools`. Ini bermakna ia tidak bergantung pada tool calling asli, jadi ia boleh berjalan pada `broadnet/deepseek-v4.1-flash`, model pada [pelan tanpa had](https://broadrouter.com/ms/guides/unlimited-llm-api-sessions/) BroadNet. Kualiti kod masih berbeza mengikut model, jadi uji tugas anda sendiri.

CodeAgent menjalankan kod yang ditulis oleh model. Baca panduan smolagents tentang pelaksanaan kod yang selamat sebelum anda memberinya alatan yang menyentuh fail, rangkaian atau kelayakan.

## ToolCallingAgent

```python
from smolagents import ToolCallingAgent, tool

@tool
def get_weather(city: str) -> str:
    """Get the weather for a city.

    Args:
        city: The city name.
    """
    return f"21C in {city}"

model = OpenAIModel(
    model_id="broadnet/glm-5.3",
    api_base="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
    max_tokens=4000,
)
agent = ToolCallingAgent(tools=[get_weather], model=model)
print(agent.run("What's the weather in Riyadh?"))
```

`ToolCallingAgent` menghantar alatan anda, serta alatan `final_answer`nya sendiri, sebagai skema fungsi dengan `tool_choice: "required"`. Gunakan `broadnet/glm-5.3` atau `broadnet/qwen3.8-27b`; dokumentasi BroadNet menyenaraikan tools untuk dua model ini sahaja.

## Model mana yang patut dipilih

| Ejen | Model |
| --- | --- |
| `CodeAgent`, larian panjang pada pelan harga tetap | `broadnet/deepseek-v4.1-flash` |
| `ToolCallingAgent` | `broadnet/glm-5.3` |
| Mana-mana ejen dengan input imej | `broadnet/qwen3.8-27b` |

Satu sesi pelan menjalankan satu permintaan pada satu masa, dan ejen menghantar langkahnya satu demi satu, jadi satu sesi sesuai untuk satu ejen. [Harga setiap model](https://broadrouter.com/ms/pricing/).

## Cara kami mengujinya

Pada 2026-11-15 kami memasang smolagents 1.26.0 dalam persekitaran maya yang bersih dan menjalankan kedua-dua ejen terhadap pelayan olok-olok tempatan yang mengikut bentuk chat completions BroadNet. `CodeAgent` pada ID DeepSeek menerima balasan kod, menjalankannya dan memulangkan 42. Permintaannya mempunyai `max_tokens: 4000`, jujukan henti dan tiada tools. Untuk `ToolCallingAgent`, kami menyemak bentuk permintaan: ID model dihantar tanpa diubah, dengan kedua-dua skema alatan dan `tool_choice: "required"`. smolagents menghantar hasil alatan kembali sebagai mesej user. Pelayan olok-olok kami tidak mengikut format itu, jadi kami tidak menjalankan ejen itu sehingga jawapan akhir. Kami tiada kunci BroadNet, jadi kami tidak menguji output model sebenar.

## Penyelesaian masalah

-   **401.** Kunci salah, tamat tempoh atau kehabisan elaun.
-   **404.** `api_base` mesti berakhir dengan `/v1`. Semak ID model. Model berbayar memerlukan tambah nilai; kredit $5 hanya meliputi `broadnet/gemma-4-26b-a4b` dan dua model Transcribe.
-   **“Make sure to provide correct code blobs”.** Balasan model tiada blok kod. Naikkan `max_tokens`, kerana penaakulan dikira di dalamnya, atau cuba model lain. [Mengapa jawapan kosong](https://broadrouter.com/ms/guides/reasoning-tokens-empty-response/).
-   **ToolCallingAgent tidak pernah selesai.** Tukar kepada `broadnet/glm-5.3` atau `broadnet/qwen3.8-27b`.
-   **429.** Kunci bayar ikut guna membenarkan 30 permintaan seminit. smolagents boleh mengehadkan dirinya sendiri dengan `requests_per_minute`. Lihat [ralat dan cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/).

## 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.

[Jujukan henti (stop sequences)](https://broadrouter.com/ms/glossary/stop-sequences/)

Jujukan henti (stop sequences) ialah rentetan yang anda hantar bersama permintaan supaya model berhenti menjana sebaik sahaja ia menghasilkan salah satu daripadanya. OpenAI menamakan medan itu stop dan menerima sehingga 4 jujukan; Anthropic menamakannya stop\_sequences. Teks yang sepadan biasanya tidak dimasukkan dalam output yang dipulangkan.

[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.

[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.

[Had kadar (rate limit)](https://broadrouter.com/ms/glossary/rate-limit/)

Had kadar ialah had yang ditetapkan oleh API ke atas jumlah penggunaan klien dalam satu tempoh masa, seperti permintaan seminit atau token seminit. Permintaan yang melebihi had ditolak, biasanya dengan HTTP 429 Too Many Requests, sehingga penggunaan turun semula di bawahnya.

[Kredit prabayar (prepaid credit)](https://broadrouter.com/ms/glossary/prepaid-credit/)

Kredit prabayar ialah wang yang ditambah ke akaun API sebelum digunakan. Setiap permintaan menolak kosnya daripada baki, dan apabila baki habis, permintaan bermeter berhenti sehingga anda menambah nilai. Ia mengehadkan perbelanjaan kepada jumlah yang telah anda bayar.

## Soalan lazim

### OpenAIModel atau OpenAIServerModel?

smolagents 1.26 mendokumentasikan OpenAIModel untuk mana-mana pelayan serasi OpenAI. OpenAIServerModel masih dieksport oleh pakej, tetapi dokumentasi menerangkan OpenAIModel.

### Bolehkah smolagents berjalan pada pelan tanpa had BroadNet?

Pelan itu meliputi DeepSeek V4.1 Flash. BroadNet tidak menyenaraikan tool calling untuknya, tetapi CodeAgent tidak memerlukan panggilan alatan asli; ia meminta kod Python daripada model. Dalam ujian pelayan olok-olok kami, CodeAgent pada ID DeepSeek menghantar permintaan chat biasa tanpa medan tools.

### Mengapakah ToolCallingAgent memerlukan GLM 5.3 atau Qwen3.8 27B?

Ia menghantar alatan sebagai skema fungsi OpenAI dengan tool\_choice ditetapkan kepada required. Dokumentasi BroadNet menyenaraikan tools untuk GLM 5.3 dan Qwen3.8 27B sahaja.

### Bagaimanakah saya menghantar max\_tokens atau temperature?

Sebagai argumen kata kunci kepada OpenAIModel. Dokumentasi smolagents menyatakan argumen tambahan dihantar ke setiap panggilan completion. Dalam ujian kami, max\_tokens=4000 dihantar pada setiap permintaan.

## 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/)
-   [Kod ralat BroadNet Inference dan bila perlu cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/)
-   [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-smolagents-openai-compatible&utm_content=page-cta) ·

**Sumber**

-   [Dokumentasi smolagents v1.26.0, rujukan Models (OpenAIModel) (disemak 2026-11-15)](https://huggingface.co/docs/smolagents/reference/models)
-   [PyPI, smolagents 1.26.0 (disemak 2026-11-15)](https://pypi.org/project/smolagents/)
-   [Rujukan API BroadNet Inference (disemak 2026-11-15) (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-guides-smolagents-openai-compatible&utm_content=sources)
