智慧體可以運用工具規劃並完成任務、與其他智慧體協作,也能在不同步驟之間保留上下文。
執行你的第一個智慧體
先依照 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 的服務中執行託管的任務執行框架。