如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題

Agents SDK

使用 OpenAI Agents SDK 以程式碼建構智慧體,再依需求採用更進階的執行模式。

智慧體可以運用工具規劃並完成任務、與其他智慧體協作,也能在不同步驟之間保留上下文。

執行你的第一個智慧體

先依照 Agents SDK 快速入門安裝 SDK,定義並執行一個智慧體。成功執行後,再回到這裡選擇應用程式接下來需要的功能。

取得 Agents SDK

前往 GitHub 程式碼庫,即可查看更多範例、GitHub 議題,以及各程式語言的詳細參考資料。

選擇從哪裡開始

你的目標 建議先讀 原因
以程式碼為主建構智慧體應用程式 快速入門 這是整合 SDK 並讓它順利運作的最快方式。
明確定義一個專責智慧體 智慧體定義 如果你還在界定單一智慧體的職責與介面,可以從這裡開始。
選擇模型、預設設定與傳輸方式 模型與供應商 當模型選擇、供應商設定或傳輸策略會影響工作流程時,請參閱這份文件。
瞭解執行迴圈與狀態 執行智慧體 這裡介紹智慧體的執行迴圈、串流,以及如何接續執行。
在容器環境中執行任務 沙盒智慧體 當智慧體需要使用檔案、指令、套件、快照、掛載點,或連接供應商時,請參閱這份文件。
規劃專責智慧體的分工 協調與交接 當工作流程需要多個智慧體時,可參考這份文件來決定由哪個智慧體負責回覆。
加入驗證或人工審查 防護機制與人工審查 如果工作流程需要阻止有風險的操作繼續執行,或先暫停流程,請參閱這份文件。
瞭解每次執行會傳回哪些內容 結果與狀態 這裡說明最終輸出、可用來恢復執行的狀態,以及下一輪互動可用的介面。
加入託管工具、函式工具或 MCP 使用工具與整合與可觀測性 平台的工具文件說明各種工具的行為。SDK 專屬的 MCP 與追蹤功能則在整合文件中說明。
檢查並改善執行成效 整合與可觀測性與評估智慧體工作流程 先利用追蹤記錄偵錯,再透過反覆評估來改善執行成效。
建構以語音為主的工作流程 語音智慧體 使用 SDK 的語音處理管線與即時智慧體模式。

使用 SDK 開發

如果你的伺服器負責部署、實作工具、儲存狀態及決定是否核准操作,而 SDK 負責執行智慧體迴圈並呼叫這些工具,請採用 SDK 開發方式。這種方式最適合以下需求:

  • 使用 TypeScript 或 Python 撰寫具型別的應用程式碼
  • 直接控制工具、MCP 伺服器與執行階段的行為
  • 自訂儲存方式,或由伺服器管理對話策略
  • 與既有產品邏輯或基礎設施緊密整合

SDK 文件通常可以依下列順序閱讀:

比較智慧體的執行方式

請參閱智慧體概覽,比較 Agents SDK、Agents API 與 Responses API。Agents SDK 在你的應用程式中執行,而 Agents API 則在 OpenAI 的服務中執行託管的任務執行框架。