Microsoft／官方：推出 Agent Experience（AX）實務手冊——評估 AI 編程代理是否用對你的技術；Cosmos DB Agent Kit 已落地四十六項改進

重點摘要

Microsoft 開發者關係團隊於二零二六年十月九日公開《Agent Experience（AX）Practitioner Playbook》第一版，把自二零二五年秋起對 Azure、Cosmos DB、SharePoint Framework 與 Microsoft 365 Copilot 擴充的代理評估方法，收斂成可下載的實務手冊與可安裝的 AX Practitioner skill。官方指出 AI 編程代理已替開發者選定 SDK、版本與認證模式；產品團隊若只等模型變聰明，無法改善代理對自家技術的表現，必須校正文件、MCP 工具、skill 與外掛等代理依賴來源。來源真實性已核對自 Microsoft for Developers 公告、aka.ms 手冊與 skill 連結。

Microsoft／官方：推出 Agent Experience（AX）實務手冊——評估 AI 編程代理是否用對你的技術；Cosmos DB Agent Kit 已落地四十六項改進

Microsoft 開發者關係團隊於二零二六年十月九日公開《Agent Experience（AX）Practitioner Playbook》第一版，把自二零二五年秋起對 Azure、Cosmos DB、SharePoint Framework 與 Microsoft 365 Copilot 擴充的代理評估方法，收斂成可下載的實務手冊與可安裝的 AX Practitioner skill。官方指出 AI 編程代理已替開發者選定 SDK、版本與認證模式；產品團隊若只等模型變聰明，無法改善代理對自家技術的表現，必須校正文件、MCP 工具、skill 與外掛等代理依賴來源。來源真實性已核對自 Microsoft for Developers 公告、aka.ms 手冊與 skill 連結。

對正在把 AI 編程代理接入內部平台、私有 API 或香港企業知識庫的團隊，這份手冊把「代理有否用對你的技術」變成可量測、可診斷、可交付修復的流程，並以 Cosmos DB Agent Kit 四十六項已落地改進等真實案例佐證。

Microsoft／官方：推出 Agent Experience（AX）實務手冊——評估 AI 編程代理是否用對你的技術；Cosmos DB Agent Kit 已落地四十六項改進

Microsoft 於二零二六年十月九日（協調世界時約九時四十四分）在 Microsoft for Developers 部落格發布《Introducing the Agent Experience (AX) Practitioner Playbook》，作者為 Principal Developer Advocate Waldek Mastykarz。同日提供可下載 PDF（aka.ms/ax-playbook，標示 v1.0、October ’26）以及對應的 AX Practitioner skill（aka.ms/ax-playbook/skill）。來源真實性已驗證。本文整理手冊核心機制、技術含義，以及對香港與亞洲企業導入代理開發的啟示。

一、核心事件：代理開始替你選技術棧

技術細節

手冊開宗明義指出：無論你建造技術或協助開發者採用技術，受眾已包含 AI 編程代理。開發者愈來愈常描述目標，由代理決定用哪個 SDK、安裝哪個版本、跟哪個認證模式、套哪個設定；開發者只審結果，決策已由代理完成。

Microsoft DevRel 自二零二五年秋起，用接近真實開發者的提示詞，量測代理在 Azure、Cosmos DB、SharePoint Framework（SPFx）與 Microsoft 365 Copilot 擴充上的表現，並以 Agent Experience 系列文章分段公開方法。十月九日這份 playbook 把評估從設定一路走到已交付修復，收成完整流程。

公告強調評估結果可能「看起來很漂亮卻不可信」：團隊見過從未編譯成功的程式碼仍拿滿分，以及「已使用 Platform X」檢查無論代理有否真用 Platform X 都過關。因此 playbook 的評估模型要求結果必須具備可信任條件——包括能判斷語意的準則，以及證明程式碼真能運行的閘門（gates）。

二、技術原理深度解析

AX 方法把代理錯誤拆成可對應修復面的診斷鏈：

  1. 準則（criteria）：把領域專家對「正確」的定義寫成法官（judge）可穩定裁決的規則；須先校準再信任，產品變更時要版本化。官方特別警告：不要讓模型替你寫準則。
  2. 軌跡（trajectory）：讀數告訴你失敗了什麼，軌跡告訴你為什麼。需區分「擴充從未載入」「載入了但從未被呼叫」「被呼叫但套用錯誤」——三者修復面不同。
  3. 九種重複失敗模式：跨所評估技術反覆出現，各自指向該介入的表面（文件、工具描述、skill、外掛等）。
  4. 假設式修復：評估本身無影響，除非有人改動行為來源；每項擬議改動須先當假設驗證，再把證據交給負責團隊（自家、協作方或開源專案）。

官方稱方法不綁定特定評估系統，可自建或沿用既有系統，playbook 列出應具備的能力檢查項。伴隨 PDF 釋出的 AX Practitioner skill，可在編程代理內邊做邊問（例如如何措辭準則、為何代理忽略你的擴充），並可對照 playbook 標準審視你的情境與準則。官方稱 skill 只根據 playbook 作答；超出手冊範圍會先聲明並徵詢後才用其他來源。在三百三十道問題測試中，答案相對 playbook 內容平均得分百分之九十五。

落地數字方面，公告寫明評估帶動文件與代理擴充「數十項」已交付修復，其中包括 Azure Cosmos DB Agent Kit 的四十六項改進；SPFx 專案升級則作為 playbook 內由情境走到已交付修復的端到端範例。

四、日常應用場景

1. 開發者與技術團隊

若你維護 SDK、API、服務、CLI、MCP server、skill、外掛或指令集，或撰寫其背後文件，你控制代理「發現並套用」什麼。可用 playbook 對自家技術跑第一輪評估：用真實業務提示詞，檢查代理是否選錯版本、沿用已棄用認證，或產出產品團隊不會推薦的設定，再把失敗對應到文件與工具描述修復。

2. 企業與隱私敏感行業

金融、法律、醫療等行業若把代理接上內部 API 與私有文件，錯誤模式往往不是「模型不夠聰明」，而是企業知識未進入代理可依賴的來源。AX 流程要求以可運行閘門驗證產出，適合作為上線前的治理檢查清單，避免「分數滿分、程式碼卻不能編譯」進入生產。

3. 一般用戶

一般用戶較少直接下載 playbook，但會間接受影響：當供應商用 AX 方法校正文件與擴充後，Chat／IDE 內的代理較不容易推薦過時套件或錯誤整合步驟，降低跟教學貼文踩雷的機會。

4. 香港與亞洲市場視角

香港企業正把 Copilot、Claude、自建代理與私有模型一併導入研發與客服。本地團隊常面對英文文件與內部中文流程並存、合規要求高、外包與內部平台混用等情況。以 AX 思維先評估「代理對我們自家 API／套件的表現」，再決定要不要擴大代理自治範圍，比直接放開自動提交更穩妥。若需在香港境內部署可治理的私有模型與代理工具鏈，可參考 YSK Limited 的企業私有 LLM 全託管（年費由港幣八萬八千元起，Dataset → QLoRA／LoRA → 私有 API，宣稱百分之百數據不出境）：https://ysk.hk/services/ai-automation

五、專業評價與潛在考量

優勢

  • 把「Agent Experience」從口號變成可重複的評估—診斷—修復閉環，並附帶可安裝 skill，降低落地門檻。
  • 有真實產品線案例（Cosmos DB Agent Kit 四十六項、SPFx 端到端），不是純概念文。
  • 明確反對「等模型升級」作為策略，切中企業現況：知識截止日無法保證模型懂你的產品。

需要留意的地方

  • Playbook 出自 Microsoft DevRel，案例集中於 Azure／M365 生態；套用到其他雲或自研框架時，準則與失敗模式仍須自行校準。
  • 評估品質高度依賴準則設計；若團隊讓模型代寫準則，可能重現官方警告的「虛假滿分」。
  • Skill 標榜只依 playbook 作答，但仍屬輔助工具；關鍵閘門（編譯、整合測試、權限邊界）仍須企業既有 CI／保安流程把關。
  • 公告未聲稱某一個第三方評估平台為唯一標準，採購或自建時應對照 playbook 所列能力清單，避免工具綁架方法。

結語

AI 編程代理已實質參與技術選型。Microsoft 以 AX Practitioner Playbook 與 skill，把「代理有否用對你的技術」變成可驗證的工程問題，並用 Cosmos DB 與 SPFx 案例示範文件與擴充修復如何量化交付。對香港企業而言，下一步不是再多裝一個代理外掛，而是先量測代理在自家棧上的真實表現，再決定開放哪些自主權。若你正在規劃私有模型、內部 API 與代理編排，可從 https://ysk.hk/services/ai-automation 了解 YSK Limited 如何在香港境內完成資料集、微調與私有 API 託管。

參考來源

  1. Microsoft for Developers（主來源）：Introducing the Agent Experience (AX) Practitioner Playbook — https://developer.microsoft.com/blog/introducing-the-agent-experience-ax-practitioner-playbook/
  2. AX Practitioner Playbook PDF（aka.ms／GitHub microsoft/scope）：https://aka.ms/ax-playbook （解析至 https://github.com/microsoft/scope/blob/main/docs/ax-playbook/ax-playbook.pdf ）
  3. AX Practitioner skill：https://aka.ms/ax-playbook/skill （解析至 https://github.com/microsoft/scope/tree/main/docs/ax-playbook/ax-practitioner ）
  4. Agent Experience 標籤彙整：https://aka.ms/agent-experience （解析至 https://developer.microsoft.com/blog/tag/agent-experience/ ）
  5. 探索來源：Microsoft Source RSS — https://news.microsoft.com/source/feed/

延伸閱讀 · 相關服務與產品

相關文章