> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAI Agents SDK

> 使用 TokenLab 模型與 OpenAI Agents SDK

## 概覽

OpenAI Agents SDK 可以透過 OpenAI 相容的客戶端與 `OpenAIChatCompletionsModel` 來使用 TokenLab。

<Note>
  **類型**: Python Agent SDK

  **主要路徑**: OpenAI 相容的 chat completions

  **支援信心**: 支援 chat-completions 路徑
</Note>

## 環境設定

```bash theme={null}
export TOKENLAB_API_KEY="sk-your-tokenlab-key"
export TOKENLAB_BASE_URL="https://api.tokenlab.sh/v1"
export TOKENLAB_MODEL="gpt-5.4-mini"
```

## 範例

```python theme={null}
import asyncio
import os

from openai import AsyncOpenAI

from agents import Agent, OpenAIChatCompletionsModel, Runner, set_tracing_disabled

client = AsyncOpenAI(
    base_url=os.getenv("TOKENLAB_BASE_URL", "https://api.tokenlab.sh/v1"),
    api_key=os.environ["TOKENLAB_API_KEY"],
)

set_tracing_disabled(disabled=True)


async def main():
    agent = Agent(
        name="Assistant",
        instructions="You are concise and practical.",
        model=OpenAIChatCompletionsModel(
            model=os.getenv("TOKENLAB_MODEL", "gpt-5.4-mini"),
            openai_client=client,
        ),
    )

    result = await Runner.run(agent, "Explain custom model providers in one paragraph.")
    print(result.final_output)


asyncio.run(main())
```

## 範圍

此路徑使用 Chat Completions 相容性。TokenLab 的原生 Responses 端點位於 `https://api.tokenlab.sh/v1/responses`，但依賴於 OpenAI 特定 Responses 語義的 SDK 功能，在投入生產環境使用前，應先針對確切的模型與工作流程進行驗證。