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

執行結果與狀態

瞭解最終輸出、歷程記錄和中斷項目,以及下一輪需要沿用哪些資料。

執行智慧體時,除了取得最終答案,你也可以從執行結果得知交接後由哪個智慧體接手,以及如何接續下一輪對話。如果執行流程暫停以等待審查,結果也會提供可用來恢復執行的狀態快照。

選擇所需的結果屬性

大多數應用程式只需要用到幾個結果屬性:

需求 使用方式
要顯示給使用者的最終答案 finalOutput (在 TypeScript 中)或 final_output (在 Python 中)
可在本機重播的歷程記錄 history (在 TypeScript 中)或 to_input_list() (在 Python 中)
通常應由哪個專責智慧體接手下一輪對話 lastAgent (在 TypeScript 中)或 last_agent (在 Python 中)
由 OpenAI 管理回應之間的串接 lastResponseId (在 TypeScript 中)或 last_response_id (在 Python 中)
待核准項目與可恢復執行的狀態快照 interruptions 搭配 state (在 TypeScript 中)或 to_state() (在 Python 中)

閱讀本指南時,可以先熟悉這些屬性。如需瞭解更完整的執行項目、模型的原始回應和詳細診斷資訊,請參閱 SDK 文件與參考資料。

下一輪要沿用哪些資料

依應用程式接續對話的方式,選擇如何使用執行結果:

  • 如果應用程式自行管理完整的本機歷程記錄,請沿用 history (在 TypeScript 中)或 to_input_list() (在 Python 中)。
  • 如果使用工作階段,請持續傳入同一個工作階段,讓 SDK 載入並儲存歷程記錄。
  • 如果由伺服器管理後續對話,只需傳入使用者的新輸入,並沿用已儲存的 ID,無須重播完整對話記錄。
  • 交接後,如果下一輪仍應由接手的專責智慧體負責,請沿用 lastAgent (在 TypeScript 中)或 last_agent (在 Python 中)。

執行中斷時會傳回狀態,尚無最終答案

有些流程會刻意在執行尚未完成時傳回結果,最常見的情況是等待核准。

  • finalOutput (在 TypeScript 中)或 final_output (在 Python 中) 可能仍為空值,因為執行流程尚未結束。
  • interruptions 會列出哪些待處理的工具呼叫需要你決定是否核准。
  • state (在 TypeScript 中)或 to_state() (在 Python 中) 是已儲存的狀態快照。核准或拒絕這些項目後,請將快照傳回執行環境。

如果審查可能延到這次請求結束後才進行,請將同一份狀態快照序列化。

更詳細的執行項目與診斷資訊

如果應用程式需要比上述屬性更詳細的資料,SDK 也提供個別執行項目與診斷資訊,包括各項工具呼叫與交接的記錄、模型的原始回應、防護機制的執行結果,以及用量明細。

這些資料適合用於稽核、建置自訂介面和深入除錯。大多數開發人員可以先熟悉本指南介紹的常用屬性,等有需要時再深入瞭解。

後續步驟

確定需要哪些結果屬性後,可以接著閱讀下列指南,瞭解這些結果如何產生,以及如何檢查結果。