Pydantic AI 2.68 統一人工問答與核准:代理暫停後,怎麼接回同一項工具工作?
Pydantic AI 2.68 用 RequestInput 統一人工問答、核准與外部結果等待。解析立即回答、接續代碼、執行引擎限制與 AskUser 遷移,了解如何把答案接回同一項工具工作。
Pydantic AI 2.68 讓代理等待人的答案時,有機會把核准、追問和外部結果接到共同流程。若等待只藏在工具內部,服務重新啟動後就可能不知道原本在等誰。
Pydantic AI 的 2.68.0 版本於 2026 年 11 月 12 日發布到 GitHub,加入 RequestInput,並讓 AskUser 使用可延後處理的工具呼叫流程。
延後處理,是先保存尚未完成的工具要求,之後拿到相應結果再接續。核准是否可執行,和回答一個缺少資料的問題,仍需要分清類型。
這次介面也保留回答來源與接續識別。但可持續恢復的執行引擎,必須能記錄等待;沒有對應支援時會拒絕,不能只因介面統一就宣稱任何環境都能跨重啟接回。
我會先用一項不修改外部資料的工作,驗證提問、回答和恢復是否對得上,再加入真正需要核准的工具。這樣比較容易分辨資料沒有回來,還是權限本來就不允許。
要理解這項變更,先看代理究竟把哪一種尚未完成的要求交給應用接手。
Pydantic AI 把問題與核准放進同一條延後流程
共同流程保存的是待處理工具要求,要求的類型仍決定回覆應怎麼解讀。
代理常會碰到自己無法立即完成的工作:執行工具前需要人同意、缺少一項資料需要追問,或必須等待另一個系統提供結果。這三種情況都會讓原來的工具呼叫停在半路,應用要知道現在等的是哪一種回覆。
官方變更的出發點,是讓核准、問題和外部結果共用等待方式。過去 AskUser 可以把等待藏在工具函式內部,但執行引擎看不到這段過程,就難以在工作恢復時採用相同決定。
新版以延後工具呼叫承接這些要求。延後不是把整項任務丟掉重做,而是保留尚未取得結果的呼叫,等相應答案回來後再往下走。應用因此能把提問介面與代理的後續執行分開處理。
共同流程也保留類型差異。補上聯絡方式是在回答問題,同意傳送一封信是在核准操作,收到檔案轉換結果則是外部工作完成。介面可以統一,答案代表的權力仍不相同。
這讓開發者能把人工參與放進原有工作流,而不必為每種情況各造一套等待邏輯。採用前應先把工具分成需要決定、需要資料與需要外部結果的項目,再決定每種項目要交給誰回覆。
要求能被辨認之後,回覆要如何找到原來的工作就成了下一個問題。

RequestInput 可以立即取得答案,也能交出接續代碼
應用提供的回覆函式,可以直接回傳結果,或先交接等待,讓答案稍後到達。
RequestInput 接受應用提供的 ask 函式。這個函式會取得執行脈絡、待處理要求與接續代碼,回傳型別則表達兩條路:直接提供延後工具結果,或回傳 None,表示先把接續方式交出去。
若答案當下已可取得,函式可以立即回傳,代理便不用一直等待外部通知。若需要人稍後回答,就把代碼交給能接收答案的應用流程,等那裡解決事件後,再把結果送回原本的等待。
這裡的 None 代表答案會從稍後的事件到達,待處理工作仍然存在。把它誤當成核准失敗,可能讓應用過早結束;把它誤當成已核准,也可能直接跳過必要決定。
接續代碼負責把答案對回等待,不應當成可公開展示的訂單編號。應用仍要驗證誰可以回答哪一項要求,再把結果送回正確代碼,避免一個人的答案被套到另一項工作。
逾時則是這條流程的一部分。等待多久、超過時間後如何告知使用者,應在設計時一起決定。尤其是需要數小時才有人處理的工作,不能只拿一個同步函式一直卡住,便視為完成了人工交接。
同一個回覆契約可以由同步或非同步函式實作。選擇方式取決於應用如何接收資料,核心差異仍是立即回答或稍後接續,而非函式名稱本身。
等待方式明確後,還必須讓執行引擎知道這段等待確實已被保存。
跨重啟恢復要有引擎支援,不只是保留對話
可持續執行引擎需要自己的等待機制,才能在重播時使用相同決定。
可持續執行的引擎會記下工作步驟,在中斷後依記錄恢復。若某個人工答案沒有被記錄,重跑時就可能得到不同答案,使後續操作與原本工作日誌分歧。
這次變更因此採取明確限制:引擎沒有安裝自己的等待機制時,會丟出 UserError,而非悄悄改成程序內等待。一般非持續執行的工作仍可在程序中等候,但程序結束後,不能僅憑這項介面宣稱等待狀態仍在。
官方 PR 說明,AWS Lambda 已有對應等待支援;Temporal、DBOS、Prefect 及其他列出的引擎,若沒有各自等待程式,會拒絕這條路徑。讀者要核對的是自己使用的引擎版本,而不只是代理套件版本。
Lambda 還有一個細節:即使應用會立即回答,回呼也先被建立。答案非空時,流程不再等待該回呼;但回呼會留到逾時,稍後再送來的結果不影響已回傳的答案。
因此,立即回答不等於根本沒有建立等待資源。官方特別建議設定逾時,避免使用無上限等待設定時,留下不必要的未結回呼。這是理解資源生命週期後的配置要求,和答案內容對不對是不同層次。
服務若要跨重啟恢復,應在測試中真的中斷並接回一次。只保存聊天文字而沒有引擎日誌,仍無法證明它記得當初待核准的工具參數。
等待能被記錄之後,核准、問題和外部結果仍要各自對回正確要求。
問題類型與回答來源,幫助應用整理紀錄
kind 與 answered_by 提供工具要求和回覆的型別資訊,應用仍要保存自己的授權依據。
新版的 kind() 可以依工具呼叫識別取得要求類型,區分核准、問題與外部結果。這比靠提示文字猜測更清楚,例如兩個介面都顯示「請確認」,實際上可能一個在補資料,另一個在允許執行。
應用可據此選擇適合的表單。問題需要收集所缺欄位,核准需要清楚顯示將執行的操作,外部工作結果則要對應預期資料格式。把所有回覆都縮成一個確認按鈕,會失去原本類型所提供的資訊。
answered_by 則提供回答來源的型別欄位,讓應用有地方保存誰提供了答案。這個欄位能協助整理記錄,但欄位有值不等於身分已被驗證,可信來源仍要由應用登入與授權流程確定。
事件紀錄也有本次範圍限制。官方說明中,AskUser 的回答事件只涵蓋自身回答器的路徑,不能假設透過 RequestInput 回答的所有問題,都會產生一模一樣的事件。
如果團隊原本靠某個事件統計人工決定次數,就應用不同回答路徑比較一次。否則統計變少可能是事件覆蓋不同,而非使用者真的少回答,或代理已自行完成所有工作。
最適合留下的紀錄,是要求類型、原始工具呼叫識別、應用確認的回答者與最終結果之間的對應。這些資訊能解釋決定如何進入工作流,又不必把接續代碼散放在一般報表。
記錄能對上之後,舊有 AskUser 串接也需要按新時點調整。
AskUser 改在其他工具完成後接手回答
有回答器的 AskUser 會在同一步其他工具呼叫完成後,逐一處理問題。
AskUser 仍負責向人提問,但新版會把問題標成延後要求,再由處理器接手。對既有應用來說,最值得核對的是回答發生的時點,因為它不再藏在原本工具函式的執行範圍內。
因為問題要等同一步的其他工具完成才接手,如果畫面原本預期工具一開始就立即跳出問題,升級後的顯示順序與等待體驗可能不同,需要按新事件順序調整。
這種安排也影響追蹤資料。答案不再記在原先的工具追蹤區段內,因此舊版儀表板若只讀那一段,可能找不到答案。應沿著新的延後要求與回答事件查找,不能只因舊欄位變空就判定使用者沒回答。
串流執行仍在支援範圍內。串流是讓應用邊執行邊接收事件,而不是等到整項任務結束才拿結果;新版工具先延後,回答再由相應處理器處理,因此整合方仍須正確消費後續事件。
另一項遷移點是 AskUserToolset 不再接收原先的 answerer 與 timeout 參數。這屬於官方列出的工具組介面改動,舊程式應按新接法調整,不能只升級套件卻保留所有初始化參數。
若應用同時使用多個處理器,還要保留 AskUser 先於 HandleDeferredToolCalls 的處理順序。否則雖然工具仍在,負責回答的那一段卻可能沒有在預期位置接到問題。
知道舊流程哪裡變了,才適合設計提問失敗與恢復的比較案例。
先驗單一往返,再接上有權限的工作
用固定問題、原始參數與接續結果比較,才能確認答案回到了同一項要求。
第一項驗收可以只讓代理詢問一個固定資料,再產生摘要,不接付款、寄信或修改資料。這樣當答案沒有回來時,能先專注在要求識別與接續機制,而不必同時排查外部寫入結果。
保留提問時的要求、回覆內容與接續後結果,再加入立即回答和稍後回答兩種路徑。兩者都應對回原本那一項呼叫,而不是意外啟動一個全新任務,讓先前上下文失去對應。
接著測沒有答案、逾時與錯誤接續。這些情況需要在畫面與工作結果中可辨認,不能都顯示成等待成功。若應用允許多個問題同時存在,也應驗證每個答案只作用在自己的要求上。
需要持續執行的服務,再額外測中斷與恢復。原本的工具參數、待處理類型與已取得的決定,應能從引擎記錄接回。若引擎尚未支援,就接受明確拒絕,而不是用未記錄等待繞過限制。
等這些案例完成,才加入一項真正需要人工同意的操作。除了收到核准,也核對執行結果,因為人同意與工具成功是兩件事。共同等待介面能連起決定,最終工作是否完成仍要從結果判斷。
當等待與決定都有可追溯紀錄,才有依據擴大到長時間代理。
Pydantic AI 2.68 人工輸入常見問題
採用前需要分清介面支援、執行引擎與應用自己的核准規則。
RequestInput 回傳 None,是不是代表否決?
它代表答案稍後透過接續事件到達。是否同意操作或如何回答問題,應由相應結果表達,不能只用空值推定授權。
Pydantic AI 2.68 能讓所有引擎跨重啟等待嗎?
不能一概而論。引擎需要自己的等待實作,本次官方說明列出 Lambda 支援,也列出缺少等待器時會拒絕的引擎。一般程序內等待不等於持續恢復。
answered_by 可以直接當稽核身分嗎?
它提供記錄欄位,身分真實性仍由應用確認。而且不同回答路徑的事件覆蓋有差異,應用要先比較實際產生的紀錄。
升級前最先檢查哪一段?
先看 AskUser 的回答時點、工具組初始化參數,以及使用的執行引擎。完成一項簡單提問往返後,再接回會修改外部資料的工具。
先完成一次提問到恢復的往返,再把新介面接進正式工具。