執行智慧體時,除了取得最終答案,你也可以從執行結果得知交接後由哪個智慧體接手,以及如何接續下一輪對話。如果執行流程暫停以等待審查,結果也會提供可用來恢復執行的狀態快照。
選擇所需的結果屬性
大多數應用程式只需要用到幾個結果屬性:
| 需求 | 使用方式 |
|---|---|
| 要顯示給使用者的最終答案 | 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 也提供個別執行項目與診斷資訊,包括各項工具呼叫與交接的記錄、模型的原始回應、防護機制的執行結果,以及用量明細。
這些資料適合用於稽核、建置自訂介面和深入除錯。大多數開發人員可以先熟悉本指南介紹的常用屬性,等有需要時再深入瞭解。
後續步驟
確定需要哪些結果屬性後,可以接著閱讀下列指南,瞭解這些結果如何產生,以及如何檢查結果。