Azure Functions 託管技能中的動態工作流程

動態工作流程是 Azure Functions 託管技能的一項功能。 它們讓託管技能啟動一個持久且多步驟的工具呼叫與等待工作流程,而不必你寫 Durable Functions 的協調程式碼。

如需最新且最完整的執行階段文件,請參閱 Dynamic workflows in Azure Functions Agents Runtime。

Important

Azure Functions 託管技能目前處於預覽階段。 功能、設定名稱及支援的連接器在正式上市前可能會變更。

動態工作流程讓 AI 模型不必再透過對話迴圈逐一呼叫工具,而是能產生結構化的工具呼叫計畫。 執行階段會以可扇出、等待、存活重啟,並在只有最終結果進入託管技能的上下文時保持可檢視的 Durable Functions 協調流程執行方案。

為什麼要動態工作流程

直接在模型迴圈中呼叫託管技能工具有四大基本限制:

  • 代幣成本。 每個中間工具的結果都會被加入模型的上下文中。 多步驟計畫可能會花費代幣購買模型只需彙總的原始資料。
  • 延遲。 每一次直接呼叫工具都是另一輪模型往返。 較長或分支較多的工作會在模型迴圈中以序列方式執行,而不是將可獨立進行的工作平行執行。
  • 耐久性。 如果背景工作重新啟動,內嵌工作可能會中斷,且沒有原生支援的方法可以讓程式依定時器休眠,或是等待一個長時間執行的外部訊號。
  • 可觀察性。 營運商無法在不經過聊天會話的情況下輕易列出、檢查或取消機上工作。

動態工作流程透過將計畫執行移入持久的編排方式來解決這些限制。 託管技能會啟動工作流程、接收工作流程識別碼(ID),然後結束本回合。 編排器會執行可安全用於工作流程的工具和持久計時器。 聊天介面和操作介面可以各自獨立追蹤工作流程,而代管技能會在工作流程完成後接續執行。

動態工作流程與程式化工具呼叫的關聯

動態工作流程的形狀類似於 Anthropic 的程式化工具呼叫模式。 在此模式中,模型建立結構化的工具計畫,執行時則在正常工具間的對話迴圈之外執行。 此方法可減少令牌使用與延遲,因為中間結果不在模型上下文中,且一個模型撰寫的計畫可代表多個工具呼叫。

動態工作流程將此模式套用到 Azure Functions,並新增耐用度與操作層:

功能 程式化工具呼叫模式 動態工作流程
平面架構的工具呼叫 是的 是的
多工具操作時較低的代幣使用與延遲 是的 是的
跨背景工作重新啟動的持續執行 No 是的,使用 Durable Functions 即可
持久性等待與計時器 No 是的
迴路外清單、檢查、取消與終止 No 是的
在持久任務排程器中的操作員可視性 No 設定時是的

何時使用動態工作流程

當託管技能需要執行超出單一對話輪次或直接呼叫工具所能處理範圍的工作時,請使用動態工作流程。 合適的對象包括:

  • 扇出/扇入模式,可從多個獨立來源並行收集證據,例如日誌、指標和部署歷史。
  • 並行執行獨立的專業託管技能,並整合其回應。
  • 執行多步驟計畫,後續步驟依賴先前工具的結果。
  • 等待耐久型計時器,且不佔用背景工作執行緒。
  • 在最終結果或摘要可用之前,不將大型中間結果納入託管技能的對話內容脈絡。
  • 在模型迴圈之外追蹤並控制長時間執行的工作

小提示

如果工作能在單一工具呼叫中完成,或每個步驟都需要立即使用者回應,請使用直接工具呼叫而非動態工作流程。

工作流程的運作方式

下圖顯示動態工作流程架構中的主要組成部分:

圖示顯示一個託管技能啟動動態工作流程,透過 Durable 編排器執行工具活動、計時器和子代理。

動態工作流程如下:

  1. 事件會觸發該託管技能,或使用者透過聊天介面發送請求。
  2. 託管技能會使用 AI 模型產生的工作流程計畫呼叫 start_workflow。
  3. 執行階段會將該計畫作為 Durable Functions 協調流程啟動,並立即傳回工作流程識別碼。
  4. 編排器會平行執行已就緒的工具活動,並為 wait 步驟建立持久計時器。 它也能將工作委派給子代理託管的技能,每個技能在孤立且無狀態的會話中運行。
  5. 當工作流程進入終端狀態時,執行時會通知託管技能,該技能會呼叫 get_workflow_status 並總結最終輸出。

當託管技能使用內建的聊天介面時,介面也會輪詢工作流程狀態並顯示進度卡。

中間結果會留在工作流程儲存庫中。 託管技能只會在啟動時看到工作流程 ID,並在擷取結果時看到最終狀態。 託管技能在工作流程執行期間不會進行輪詢。

工作流程管理工具

當你啟用工作流程時,執行環境會將以下工具加入託管技能:

Tool Purpose
start_workflow 啟動經過驗證的工作流程計畫,並立即回傳工作流程 ID。
get_workflow_status 取得工作流程的當前狀態和最終輸出。
list_workflows 列出目前工作階段所擁有的工作流程。
cancel_workflow 要求協同取消。
terminate_workflow 會突然終止工作流程實例。

託管技能會呼叫這些工具。 使用者不會直接在應用程式代碼中呼叫它們。

工作流程子代理

啟用工作流程的託管技能可在其workflows.subagents設定中授與專門託管技能的存取權。 每個專門項目都是同一個託管技能應用程式中的另一個.agent.md檔案。

以下前段讓協調員使用兩位專家:

---
name: PR Status Portfolio Coordinator
description: Reviews pull requests and produces an actionable report.
workflows:
  enabled: true
  subagents:
    - agent: pr_status_analyst
      when: Review one pull request and summarize its current status
    - agent: actionable_report_writer
      when: Combine pull-request summaries into an actionable portfolio report
---

該 agent 值為專家的檔名單字。 例如,pr_status_analyst 是指 pr_status_analyst.agent.md。 可選 when 值有助於模特兒決定何時使用專家。 執行時會先驗證每位專家是否符合此明確授權,然後才排程工作流程。

模型可產生一個包含 sub_agent、id 和 agent 的工作流程任務,以及一個自成一體的 task。 子代理任務也可以使用 depends_on、 when、 for_each和 。

{
  "id": "analyze_pr",
  "type": "sub_agent",
  "agent": "pr_status_analyst",
  "task": "Review the supplied pull request and summarize its current status."
}

每個子代理的調用都是無狀態且孤立的:

  • 專家使用其自身的模型、指示、工具、MCP 伺服器、技能和逾時設定。
  • 專家不會獲得協調員的對話歷史、沙盒、工作流程管理工具或聊天時間委派工具。
  • 專門項目故障或逾時會導致父系工作流程失敗。
  • 專業工具應容忍重複執行,因為工作者失敗可能導致子代理執行多次。

若想看端對端的範例,如何執行平行的 PR 分析師任務並將摘要合併成報告,請參考 工作流程子代理人範例。

儲存體後端

動態工作流程內部使用 Durable Functions,並支援相同的儲存後端。 預設情況下,工作流程會使用你的函式應用程式已有的 Azure 儲存體 帳號。 對於生產工作負載,你可以切換到 Durable Task Scheduler(DTS),它提供一個儀表板,包含每個實例的任務狀態、重試紀錄,以及飛行中工作的控制。 操作指南 涵蓋了這兩種選項。

Considerations

使用動態工作流程時,請記得以下目前的限制:

  • 工作流程安全的工具處理器必須同步且回傳可序列化的 JSON 值。
  • AI 模型會在執行時產生工作流程計畫。 你無法在 YAML 或 Markdown 中定義靜態工作流程範本。
  • 你無法設定每個任務的重試和逾時政策。
  • 不提供大量輸出處理與 MCP 任務整合功能。

下一步

配置安全工作流程的工具,並在本地執行您的工作流程: