Microsoft Agent Framework 1.26:結構化結果、工具核准與記憶遷移怎麼升級?

Agent Framework 1.26 更新 Copilot 結構化結果與核准安排。解析 CLI 最低版本、訪客逾時邊界及記憶介面遷移,協助團隊保住資料與原有工具流程。

Share
Microsoft Agent Framework Python 1.26.0 的官方 GitHub 發布分享圖
Microsoft Agent Framework 更新 Python 1.26.0,涵蓋 Copilot 結構化結果、核准與記憶介面調整。圖片來源:Microsoft/GitHub。 圖片來源:官方原文。

Agent Framework 1.26 更新後,讓代理回答一份可交給程式使用的結果,和准許它呼叫工具,仍是兩項不同工作。團隊需要同時確認資料格式與執行權限,不能只看答案是否順眼。

Microsoft 在 2026 年 11 月 13 日發布 Python 1.26.0,為 Copilot 整合加入結構化結果,也調整工具核准、執行限制與實驗記憶介面的遷移安排。

結構化結果是依指定欄位與型別保存答案,讓程式不用再從一段文字猜內容。新版會在最後文字產生後解析結果,串流途中依然傳回文字片段。

這次 Copilot 整合要求 CLI 至少 1.0.85,版本太舊或無法辨認都會在啟動時拒絕。CLI 是在命令列執行的程式,和 Python 套件有各自版本,升級其中一邊不保證另一邊符合。

我會先從有固定欄位的低風險任務驗證,再檢查核准範圍與記憶檔案。已有記憶的團隊尤其應先保存原資料,因為新介面不會自動搬好舊內容。

先釐清結果何時能被解析,再看這些資料如何在工具核准與長期記憶中維持相同意義。

結構化結果等到最後解析,串流仍是一段段文字

Copilot 可以接收欄位結構要求,並將最後答案放進可讀取的結果值。這適合把代理產生的結論接到後續程式,而不必每次再從自然語言猜出哪個字代表狀態。

例如文件分類可以要求一個分類欄位與一個理由欄位,程式便能分別取值。這是應用設計的例子,實際欄位仍由開發者決定,格式要求也不能代替對文件內容的查核。

新版 Copilot 整合接受 Pydantic 類別或 JSON Schema。前者能用 Python 型別定義資料,後者描述欄位、型別與必要條件。兩者都在告訴系統最後應拿到什麼結構,讓應用有明確的接收契約。

解析發生在最終文字產生之後,成功結果放在 AgentResponse.value。串流仍是一段段傳回的文字,介面可以顯示生成過程,但不能把任意一小段都當成已經完成的物件交給下一步執行。

這個時間差會影響表單或自動流程的接法。若前端一看到分類名稱就立即送出外部操作,後面的內容仍可能尚未完整。較合適的安排,是等最後結果解析完成,再檢查必要欄位與業務條件。

未提供結構要求的既有呼叫,仍保留原本使用方式。因此,升級可以先挑一個原本就有固定欄位的工作比較,確認錯誤處理與最後結果的讀取方式,再擴大到其他代理。

測試時也可以保留缺欄位或型別不合的案例。例如原本要求整數,答案卻回一段文字,應用需要能處理解析失敗,不能把空結果當成業務上的否定。因為沒有成功解析,和得到一個明確的否定答案,對後續程式有不同意義。

同一份結構也應保留版本。如果後續新增必要欄位,舊工作保存的結果可能不符合新要求,應用就需要決定轉換或重新處理。先把這項相容性納入安排,才不會只因解析介面統一,就把所有歷史結果當成同一種資料。

格式能交給程式使用之後,還需要確認執行這個整合的命令列版本。資料定義寫得正確,並不能讓不相容的執行程式自動具備相同能力。

Microsoft Agent Framework Python 1.26.0 的官方 GitHub 發布分享圖
Microsoft Agent Framework 更新 Python 1.26.0,涵蓋 Copilot 結構化結果、核准與記憶介面調整。圖片來源:Microsoft/GitHub。 圖片來源:官方原文。

Copilot CLI 版本是一道啟動條件

新版整合只接受可確認達到最低要求的 CLI,避免執行中才發現協定不合。這次最低版本為 1.0.85,無法辨認版本時也會拒絕啟動,不會先假設環境可用。

這道檢查與 Python 套件的版本不同。團隊可能已更新 Agent Framework,卻仍透過自訂路徑找到舊命令列程式。若只核對一份套件清單,就可能漏掉真正被啟動的執行檔。

發布說明列出 Copilot SDK 的相應最低要求,指定版本所附的 CLI 也已達到門檻。但使用自訂路徑或環境設定的部署,仍應記下實際來源與版本,而非由預期安裝內容推論執行結果。

例如開發電腦與自動化環境各有一個 CLI,兩邊的啟動結果可能不同。這時先比對程式實際找到哪個檔案,會比反覆修改模型提示更能對準問題,因為失敗發生在模型工作開始之前。

版本核對最好連到實際部署紀錄,保留框架、整合套件與命令列程式的對應。之後若另一台機器無法重現結果,就能先排除環境差異,不必把相容性問題誤當成模型在相同設定下突然改變行為。

環境版本對上之後,工具能做什麼仍要由應用自己的核准安排決定。能讓代理正常執行,只是建立工作條件,並沒有授予它任意操作外部系統的權限。

訊息標記與核准,保住工具執行的依據

實驗安全設定讓應用提供訊息來源標記,核准也要對上實際工具呼叫。這是把資料來源與行動依據放回可檢查的位置,避免只因一段文字自稱可信就提高權限。

訊息來源標記由應用設定的函式提供,能按來源與訊息內容附上標籤。權威來自應用管理的來源範圍,不能任由輸入文字裡的識別碼宣稱自己屬於另一個高權限來源。

對歷史紀錄的處理也需要保守。重新讀入的文字若沒有原本的可信來源資訊,不能只因它存在對話歷史中,就當成新的操作指令。保存內容與保存授權依據,是兩項需要分別設計的工作。

核准則要綁到待處理的工具呼叫及其控制狀態。例如原本准許讀一份文件,後續變成刪除另一份文件,就應重新核對,而不能把舊同意當成一張涵蓋全部工具的通行證。

這版也提供依任務限制權限的中介層範例,中介層是放在要求與工具之間的檢查程式,先檢查再決定是否放行。中介層可以在工具本體執行前檢查要求,沒有通過就先拒絕。它是展示既有介面如何搭配的範例,不能當成每個套件都自動啟用的新內建機制。

因此,團隊採用前仍須決定哪些來源可信、哪些工具需要核准,以及拒絕後如何回報。實驗設定提供安排這些檢查的方法,最終規則仍要符合應用自己的角色與權限。

若同一代理同時讀取外部文件與內部工作指令,也應分別測試兩種來源。外部文件可以提供待分析內容,卻不應只因其中寫了一段命令,就取得內部指令同等的行動依據,這正是來源資訊要由應用掌握的原因。

工具拿到清楚的授權後,長時間執行還需要能結束的範圍。否則即使操作本身獲准,無限等待或無法取消仍會讓工作難以管理。

逾時有邊界,主機回呼仍要自己的限制

Hyperlight 訪客程式有預設執行時限,但主機回呼和初始化不在相同中斷範圍。訪客程式是放在隔離執行環境裡運行的內容,主機回呼則是它向外請主程式代辦的功能。

這次預設訪客時限為三十秒,設定值也必須是正數且有限。取消時會中斷訪客執行,等待環境回復到快照狀態,再處理後續工作,避免只停止等待卻留下未整理的執行環境。

但初始化與主機回呼無法用同一道中斷機制處理。若回呼正在等待外部網路,仍要為那個網路工作安排自己的上限。只設訪客時間,不能推論外部服務也會在相同秒數內結束。

這也是驗收時需要區分情境的原因。純訪客運算超時,和外部服務沒有回應,雖然在畫面上都像等待,實際上需要不同的取消與復原方式,錯誤紀錄也應保留各自來源。

相關能力還依賴底層 SDK 的中斷介面。團隊應按發布說明核對相應版本,不應只因套件能安裝,就假設每個執行功能都已具備。依賴解析成功與功能條件符合,仍有差別。

取消後的環境也應納入回歸。測完超時再執行一個簡單工作,確認先前狀態沒有讓下一項任務讀到不該存在的資料,才能把中斷與恢復當成一條完整路徑,而不只是看到一次錯誤就結束檢查。

除了當次執行,升級也可能影響下一次接回的記憶資料。這部分若沒有事先核對,問題可能要等代理再次使用舊內容時才出現。

記憶介面有棄用期,檔案不會自動遷移

舊實驗記憶介面先提出棄用警告,原有匯入與檔案仍能使用。發布說明安排在 2026 年十二月三十一日之後移除相應舊介面,讓團隊有時間調整,並非更新當天所有資料立刻失效。

新的 FileMemoryProvider 並不是把名稱換掉就能維持全部舊行為。它使用不同檔案安排,也不會自動擷取舊記憶、帶入原本歷史或搬移既有檔案,因此不能把能成功建立物件當成遷移完成。

舉例來說,舊流程若從對話中整理長期偏好,新流程只讀取指定檔案,就需要另外決定誰負責整理內容。否則雖然檔案依然存在,代理實際拿到的資訊卻可能比以前少。

工作階段範圍也是一項差異。新介面預設按工作階段使用,若應用需要多個工作階段共享記憶,必須明確指定範圍。這能避免開發者以為所有紀錄都自然共用,或反過來把應分開的資料放在一起。

較可控的遷移方式,是先保留原檔,再以同一組測試問題比較代理取回哪些內容。除了問得到原本答案,也要確認不應跨工作階段出現的資訊沒有被帶進另一個使用情境。

記憶遷移還應包含原本沒有答案的測試。如果新流程把其他工作階段的內容誤當成可共用資料,回答可能變多卻更不合適。因此比較時除了原本取得到的記憶,也要列出應繼續隔開的內容,確認資料範圍沒有擴大。

把儲存格式、擷取方式與工作階段範圍逐一確認,才能避免搬完檔案卻失去原本行為。這種核對比單純消除棄用警告,更接近使用者實際需要的連續性。

Agent Framework 1.26 常見問題與升級順序

只更新 Python 套件就可以使用新 Copilot 整合嗎?

還要確認實際啟動的 Copilot CLI 達到最低版本,且能被辨認。若有自訂執行路徑,應按那個路徑核對,不能只看另一個安裝位置。

有結構化結果,就能直接交給工具執行嗎?

結構解析能確認資料形式,工具核准與業務限制仍要另外處理。分類欄位存在,不等於分類正確,也不代表應用已同意採取外部行動。

舊記憶會在升級後自動轉換嗎?

不會自動完成全部遷移。新介面的檔案、擷取與工作階段設定都有差異,需要保存原資料並逐項比較,才能確認既有用途仍能接續。

先保住既有資料與核准流程,再把新格式接進正式任務,升級才有可比較的結果。這版適合先在固定輸出與明確權限的工作上驗收,再逐步擴大代理承接的範圍。

延伸閱讀:Microsoft Agent Framework1.25收緊MCP探索與工作流共用:Python升級要改什麼?

延伸閱讀:Claude Managed Agents 開放自架私人測試:控制服務、憑證與紀錄放在哪裡?

原始資料來源