---
title: "OpenAI Agents SDK với provider tương thích OpenAI tùy chỉnh"
description: "Dùng OpenAI Agents SDK cho Python với BroadNet Inference qua AsyncOpenAI và OpenAIChatCompletionsModel, đồng thời tắt tracing vốn cần key OpenAI."
url: https://broadrouter.com/vi/guides/openai-agents-sdk-custom-provider/
lang: vi
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Được dịch từ tiếng Anh với sự hỗ trợ của AI. [Đọc bản gốc tiếng Anh](https://broadrouter.com/guides/openai-agents-sdk-custom-provider/) (cập nhật ngày 2026-11-16).

# Chạy OpenAI Agents SDK trên BroadNet Inference

Cập nhật 2026-11-16

Tạo client AsyncOpenAI với base\_url https://inference.broadnet.ai/v1 và key BroadNet, bọc nó trong OpenAIChatCompletionsModel với model ID như broadnet/glm-5.3, rồi truyền model đó cho Agent. Hãy gọi set\_tracing\_disabled(True), trừ khi bạn có một key OpenAI riêng cho tracing.

OpenAI Agents SDK là framework Python để xây dựng agent có tool, handoff và guardrail. Tài liệu của SDK mô tả cách cắm các provider không phải OpenAI. Với một API tương thích OpenAI như BroadNet Inference, bạn đưa cho SDK client `AsyncOpenAI` của riêng mình và dùng lớp model Chat Completions. Mặc định SDK dùng Responses API, thứ mà nhiều provider không phục vụ.

## Thiết lập

1.  **Cài SDK.** SDK cần Python 3.10 trở lên.

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

2.  **Tạo client, model và agent.**

```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.  **Chạy thử.** Agent sẽ gọi `get_order_status` và trả lời dựa trên kết quả của nó.

## Ba cách nối provider

Tài liệu SDK liệt kê các lựa chọn có sẵn sau:

-   **Theo từng agent:** truyền `OpenAIChatCompletionsModel` làm `Agent.model`, như ví dụ trên. Dùng cách này khi các agent khác nhau dùng các provider khác nhau.
-   **Mặc định toàn cục:** `set_default_openai_client(client)` biến client của bạn thành mặc định. Dùng kèm `set_default_openai_api("chat_completions")`.
-   **Theo từng lần chạy:** truyền một `ModelProvider` tùy chỉnh vào `RunConfig(model_provider=...)`.

Cách mặc định toàn cục trông như sau:

```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")
```

Nếu chỉ dùng biến môi trường, hãy đặt `OPENAI_BASE_URL=https://inference.broadnet.ai/v1` và đặt `OPENAI_API_KEY` là key BroadNet, rồi gọi `set_default_openai_api` và `set_tracing_disabled` giống như trên.

Theo tài liệu SDK, khi định tuyến qua Chat Completions, SDK lặng lẽ bỏ các trường chỉ có ở Responses, như `previous_response_id`, `conversation_id` và `prompt`. Muốn nhận lỗi thay vì vậy, hãy đặt `strict_feature_validation=True` trên `OpenAIProvider`. Hãy tự giữ trạng thái hội thoại trong code của bạn, ví dụ truyền danh sách đầu vào của kết quả trước vào lần chạy tiếp theo. Các tool do OpenAI host như web search và file search không có ở provider khác. Hãy dùng `function_tool` cho mọi thứ agent cần gọi.

## Tracing

Tracing bật sẵn và gửi trace về OpenAI. Tài liệu SDK nói rằng nếu không có API key từ platform.openai.com, bạn nên tắt nó bằng `set_tracing_disabled()` hoặc thiết lập một tracing processor khác. Nếu bạn có key OpenAI, bạn có thể giữ tracing và truyền key đó bằng `set_tracing_export_api_key(...)`. SDK chỉ dùng key này để tải trace lên. Key BroadNet không dùng được cho việc này.

## Nên chọn model nào

| Loại agent | Model | Ghi chú |
| --- | --- | --- |
| Agent dùng tool | [GLM 5.3](https://broadrouter.com/vi/models/glm-5.3/) | Có ghi hỗ trợ tool và đầu ra có cấu trúc; context 1M |
| Đầu vào hình ảnh, có tool | [Qwen3.8 27B](https://broadrouter.com/vi/models/qwen3.8-27b/) | Context 262K; đã thử nghiệm bằng tiếng Ả Rập |
| Agent chạy lâu với giá cố định | [DeepSeek V4.1 Flash](https://broadrouter.com/vi/models/deepseek-v4.1-flash/) | Gói không giới hạn; BroadNet không ghi hỗ trợ tool |

Tài liệu SDK cảnh báo rằng một số provider không hỗ trợ đầu ra có cấu trúc theo JSON schema. Nếu bạn đặt `output_type` cho agent, hãy dùng GLM 5.3 hoặc Qwen3.8 27B. So sánh giá trên [trang bảng giá](https://broadrouter.com/vi/pricing/).

## Xử lý sự cố

-   **401.** Key BroadNet bị sai, hết hạn hoặc hết hạn mức trả theo mức dùng. Lỗi tracing trong log là chuyện khác: chúng nghĩa là tracing vẫn đang bật mà không có key OpenAI.
-   **404 hoặc “not found”.** Nhiều khả năng bạn đang dùng Responses API. Hãy dùng `OpenAIChatCompletionsModel` hoặc `set_default_openai_api("chat_completions")`. Nếu đã đặt rồi, kiểm tra model ID có khớp chính xác với ID của BroadNet không. Các model trả phí cần nạp tiền; tín dụng $5 dùng được cho Gemma 4 VL 26B và hai model Transcribe.
-   **`final_output` rỗng.** Phần suy luận được tính vào `max_tokens`. Nếu bạn đặt `ModelSettings(max_tokens=...)`, hãy tăng giá trị lên. [Vì sao câu trả lời trả về rỗng](https://broadrouter.com/vi/guides/reasoning-tokens-empty-response/).
-   **429.** Key trả theo mức dùng cho phép 30 request mỗi phút và 4 request cùng lúc. Mỗi vòng gọi tool là một request mới. Xem [lỗi và thử lại](https://broadrouter.com/vi/guides/errors-and-retries/).
-   **Agent song song trên một gói.** Một [phiên của gói không giới hạn](https://broadrouter.com/vi/guides/unlimited-llm-api-sessions/) chạy một request tại một thời điểm. Các agent khởi chạy cùng lúc bằng `asyncio.gather` cần mỗi agent một phiên, nếu không chúng sẽ phải xếp hàng. Xem [chạy agent song song với giá cố định](https://broadrouter.com/vi/blog/run-parallel-coding-agents-flat-rate/).

## Thuật ngữ trong hướng dẫn này

[Trả theo mức dùng (pay-as-you-go)](https://broadrouter.com/vi/glossary/pay-as-you-go/)

Trả theo mức dùng (pay-as-you-go) là mô hình giá mà bạn chỉ trả cho những gì đã dùng, đo theo đơn vị như token, request hoặc phút âm thanh, không có gói đăng ký hay cam kết tối thiểu. Hầu hết API LLM tính phí theo cách này, trừ vào số dư trả trước hoặc qua hóa đơn định kỳ.

[API tương thích OpenAI (OpenAI-compatible API)](https://broadrouter.com/vi/glossary/openai-compatible-api/)

API tương thích OpenAI là một HTTP API nhận cùng định dạng request và phản hồi như OpenAI API, ví dụ POST /v1/chat/completions, nên SDK và công cụ của OpenAI dùng được nó chỉ bằng cách đổi base URL, API key và tên model.

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

Chat Completions API là endpoint HTTP của OpenAI, POST /v1/chat/completions, nhận tên model và danh sách message có gắn vai trò rồi trả về message tiếp theo của model. Cấu trúc request và response của nó đã trở thành định dạng chung mà các nhà cung cấp và SDK tương thích OpenAI dùng lại.

[Đầu ra có cấu trúc (structured output)](https://broadrouter.com/vi/glossary/structured-output/)

Đầu ra có cấu trúc (structured output) là tính năng của API LLM buộc câu trả lời của model theo định dạng do lập trình viên chỉ định, thường là JSON Schema, để code parse được tin cậy. Nó chặt hơn JSON mode, vốn chỉ đảm bảo JSON hợp lệ chứ không đảm bảo một cấu trúc cụ thể.

[Giới hạn tần suất (rate limit)](https://broadrouter.com/vi/glossary/rate-limit/)

Giới hạn tần suất (rate limit) là mức trần mà API đặt ra cho lượng sử dụng của một client trong một khoảng thời gian, như số request mỗi phút hoặc số token mỗi phút. Request vượt giới hạn bị từ chối, thường với HTTP 429 Too Many Requests, cho đến khi mức dùng giảm xuống dưới giới hạn.

[Gói LLM giá cố định (flat-rate LLM plan)](https://broadrouter.com/vi/glossary/flat-rate-llm-plan/)

Gói LLM giá cố định tính một mức giá cố định cho mỗi kỳ, ví dụ một tháng, để dùng API mô hình ngôn ngữ thay vì tính theo token. Gói này thường giới hạn thứ khác, như số request đồng thời, tốc độ, model hay khung giờ sử dụng, nên giới hạn quan trọng không kém giá.

[API key (khóa API)](https://broadrouter.com/vi/glossary/api-key/)

API key là một chuỗi bí mật dùng để xác định và cấp quyền cho client gọi API. API LLM thường yêu cầu nó trong header Authorization: Bearer, và bất kỳ ai giữ key đều có thể gửi request được tính phí vào tài khoản sở hữu key đó.

[Concurrency (request đồng thời)](https://broadrouter.com/vi/glossary/concurrency/)

Concurrency (request đồng thời) là số request mà một client đang xử lý cùng lúc. Các API LLM thường giới hạn nó theo key hoặc theo gói, tách biệt với số request mỗi phút, vì mỗi request đang mở chiếm dụng năng lực GPU cho tới khi response kết thúc.

## Câu hỏi thường gặp

### Vì sao Agents SDK báo lỗi 404 khi dùng base URL tùy chỉnh?

Mặc định SDK dùng Responses API, còn BroadNet phục vụ chat completions. Hãy dùng OpenAIChatCompletionsModel, hoặc gọi set\_default\_openai\_api("chat\_completions") nếu bạn cấu hình client qua biến môi trường.

### Vì sao Agents SDK báo lỗi về tracing?

Tracing tải dữ liệu lên OpenAI và cần key từ platform.openai.com. Tài liệu SDK khuyên dùng set\_tracing\_disabled() khi bạn không có key đó, hoặc dùng một tracing processor khác.

### Có thể cấu hình Agents SDK chỉ bằng biến môi trường không?

Có. Đặt OPENAI\_BASE\_URL là https://inference.broadnet.ai/v1 và OPENAI\_API\_KEY là key BroadNet, rồi gọi set\_default\_openai\_api("chat\_completions") và set\_tracing\_disabled(True). OPENAI\_DEFAULT\_MODEL đặt model cho các agent không chỉ định model.

### Một lần chạy nhiều agent cần bao nhiêu phiên của gói?

Mỗi request chạy đồng thời cần một phiên. Handoff chạy lần lượt từng agent, nên một phiên là đủ. Các agent chạy song song bằng asyncio.gather thì mỗi agent cần một phiên.

## Hướng dẫn liên quan

-   [Dùng OpenAI Python SDK với BroadNet Inference](https://broadrouter.com/vi/guides/openai-python-sdk/)
-   [Gói LLM API không giới hạn cho agent hoạt động thế nào?](https://broadrouter.com/vi/guides/unlimited-llm-api-sessions/)
-   [Vì sao model suy luận trả về câu trả lời rỗng](https://broadrouter.com/vi/guides/reasoning-tokens-empty-response/)
-   [Kết nối LiteLLM tới BroadNet Inference (SDK và proxy)](https://broadrouter.com/vi/guides/litellm-proxy-custom-provider/)
-   [Mọi công cụ dùng được với BroadNet Inference (tiếng Anh)](https://broadrouter.com/integrations/): SDK, agent lập trình, giao diện chat và công cụ tự động hóa, kèm cấu hình chính xác cho từng công cụ

Hãy thử với khối lượng công việc thực tế của bạn. Tài khoản mới được tặng US$5 tín dụng ban đầu cho Gemma và chuyển giọng nói thành văn bản. DeepSeek, GLM và Qwen3.8 cần nạp tiền.

[Bắt đầu](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-guides-openai-agents-sdk-custom-provider&utm_content=page-cta) ·

**Nguồn**

-   [Tài liệu OpenAI Agents SDK, Models (provider không phải OpenAI) (kiểm tra ngày 2026-11-14)](https://openai.github.io/openai-agents-python/models/)
-   [PyPI, gói openai-agents (0.24, Python 3.10 trở lên, kiểm tra ngày 2026-11-14)](https://pypi.org/project/openai-agents/)
-   [Tài liệu tham chiếu API BroadNet Inference (tiếng Anh)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-guides-openai-agents-sdk-custom-provider&utm_content=sources)
