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

智慧體

選擇執行環境、連接工具,並管理多步驟任務。

智慧體能運用工具規劃並完成任務、與其他智慧體協作,並在各個步驟之間保留上下文。選擇執行環境時,請考量要在哪裡協調工作流程,以及由誰管理任務之間的狀態。

選擇入門指南

你想做什麼 從這裡開始
使用 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 而異。

Agents API 工作階段、SDK 工作階段、Responses 對話和沙盒是不同的資源。請依照所選執行環境的說明管理狀態並清理資源。