代理框架的工作流程定義明確且可檢視的執行路徑,用於協調程式碼、代理、狀態、事件及人工輸入。 該框架在同一工作流程運行模式下,提供功能性與圖形化的 API。
工作流程 API
所有 SDK 都支援基於圖形的工作流程。 Python 也提供一個實驗性的功能性工作流程 API。
.NET SDK 採用基於WorkflowBuilder圖形的 API。 它透過邊緣與條件連接型別執行者,支援扇出與扇入執行,發出工作流程與執行器事件,並在超步驟邊界處檢查點進行。 可透過標準 AsAIAgent()代理介面與 公開相容的工作流程。
- Workflow Builder and Execution 說明如何建立和執行 .NET 工作流程圖。
- 執行者、 邊、 事件與 狀態管理 描述圖執行時原語。
- 功能性工作流程 API 採用 Python 函式與原生控制流程。
- 工作流程建構器與執行 工具建構並執行經過型別驗證的工作流程圖。
兩個 API 產生的可觀察工作流程結果相同。 選擇與你想表達的執行模型相符的 API:
功能性(@workflow) |
圖(WorkflowBuilder) |
|
|---|---|---|
| 控制流程 | 原生Python(if,循環,asyncio.gather) |
邊緣與條件 |
| 適用對象 | 序列管線、自訂迴圈與臨時平行處理 | 固定圖形、扇出/扇入及型別驗證訊息路由 |
| 平行性 | asyncio.gather |
平行邊群與超步執行 |
| 可觀察性 | 每個步驟的事件 @step |
執行者事件 |
| 人在循環中 | ctx.request_info() |
RequestInfoExecutor |
| 檢查點設置 | 每@step結果快取 |
超步邊界檢查點 |
| 代理封裝 | 在 .as_agent() 上出現 FunctionalWorkflow |
在 .as_agent() 上出現 Workflow |
Go SDK 採用基於 workflow.NewBuilder 圖形的 API。 它透過邊、條件以及扇出或扇入群組連接綁定執行者,然後將圖送入執行環境, inproc.Default如 。 可透過標準 agentworkflow.New(...)代理介面揭露面向代理的工作流程。
- Workflow Builder and Execution 說明了如何建立和執行 Go 工作流程圖。
- 執行者、 邊、 事件與 狀態管理 描述圖執行時原語。
圖與執行時模型
進階執行
- Agent Executor 將代理整合進工作流程圖中。
- 工作流程執行模式 說明串流與非串流執行。
- 可重置執行器 描述在執行間重置的執行器。
- 子工作流程 將工作流程組合為較大圖中的執行者。
關於功能導向的指引,如檢查點、人機互動、視覺化與編排,請參見 工作流程能力。