智慧體能運用工具規劃並完成任務、與其他智慧體協作,並在各個步驟之間保留上下文。選擇執行環境時,請考量要在哪裡協調工作流程,以及由誰管理任務之間的狀態。
選擇入門指南
| 你想做什麼 | 從這裡開始 |
|---|---|
| 使用 OpenAI 管理的 Codex 任務執行框架來執行智慧體 | Agents API |
| 在應用程式中控制智慧體的執行迴圈,重複使用智慧體、工具和任務交接機制 | Agents SDK |
| 直接處理模型回應,自行控制整合方式 | Responses API |
| 加入嵌入式對話介面 | ChatKit |
比較智慧體的執行環境
| Agents API | Agents SDK | Responses API | |
|---|---|---|---|
| 適用情境 | 執行長時間任務,由 OpenAI 管理智慧體並儲存進度 | 在應用程式中使用自訂工具和工作流程建構智慧體 | 直接呼叫模型,或從頭建構智慧體 |
| 智慧體在哪裡執行 | OpenAI 負責執行並管理 Codex 任務執行框架 | SDK 在你的應用程式中執行 | 在你的應用程式中執行,可選用託管服務來協調工作流程 |
| 整合智慧體所需的工作量 | 低 | 中 | 高 |
| 任務之間的狀態 | 已儲存的工作階段設定、互動輪次和項目 | 使用你自己的儲存空間和 SDK 工作階段,或使用 Responses 的對話狀態 | 手動管理歷程記錄、串接回應,或使用 Conversations |
| 工具執行方式 | 使用已連接服務的工具和應用程式中的函式處理常式,也可選用沙盒 | 使用在應用程式中設定的工具和整合項目 | 使用託管工具,以及由應用程式執行的工具 |
| 執行環境 | 使用 OpenAI 託管的沙盒、自行託管沙盒,或不使用沙盒 | 使用你自己的執行環境,並整合沙盒供應商的服務 | 使用你自己的執行環境 |
| 從這裡開始 | Agents API 概覽 | Agents SDK 概覽 | Responses 指南 |
Agents API 負責執行 Codex 任務執行框架,並管理智慧體的底層基礎設施,讓你能專注於智慧體要完成的任務。它能自動壓縮上下文、協調多個智慧體,也支援以程式呼叫工具和使用 MCP 伺服器。請參閱架構。
使用 Agents SDK 時,部署、儲存、核准流程,以及與執行環境的整合,都由你的應用程式控制。SDK 的執行器負責處理智慧體的執行迴圈與任務交接。請參閱執行智慧體。
加入工具、技能和提示詞快取
工具設計、可重複使用的技能和提示詞快取都適用於各種智慧體工作流程。它們的設定方式和生命週期可能因 API 而異。
- 先閱讀使用工具,了解函式呼叫、MCP 和託管功能。
- 閱讀以程式呼叫工具,了解如何使用 JavaScript 協調工作流程,以及如何設定各個 API。
- 參閱技能,了解如何重複使用指令,以及支援哪些載入方式。
- 閱讀提示詞快取,了解各 API 共通的快取行為,再參閱 Agents API 可觀測性與用量,了解如何按工作階段統計用量。
Agents API 工作階段、SDK 工作階段、Responses 對話和沙盒是不同的資源。請依照所選執行環境的說明管理狀態並清理資源。