微软发布 AX Practitioner Playbook 与配套技能

2026年10月9日

0 条反应

首席开发者布道师

AX Practitioner Playbook 是我们评估 AI 编码代理如何使用你的技术、诊断它们为何出错，并从源头修复的方法。它把我们从上数百次代理会话中学到的一切汇集于一处。请在 aka.ms/ax-playbook 下载。

让一个编码代理用你所研究的技术构建一些东西，然后观察会发生什么。它生成的代码看起来合理，甚至可能编译通过。再仔细看，你会发现 SDK 版本错误、已弃用的身份验证模式，或者产品团队中没人会推荐的设置。代理并不是随机犯错。它只是完全按照其训练数据告诉它的去做。

开发者越来越多地让代理选择 SDK、版本和模式，然后根据结果来评判你的技术。等待模型变得更好并不是一种策略：知识截止日期几乎无法说明模型对你的产品了解多少。你能改变的是代理所依赖的来源：文档、MCP 工具、技能、插件、指令、CLI 和 API。困难之处在于知道哪项改变真正有帮助。

从系列文章到一种方法

自 2025 年秋季以来，我们微软 DevRel 团队使用真实开发者会用的同类提示，衡量了代理在 Azure、Cosmos DB、SharePoint Framework (SPFx) 和 Microsoft 365 Copilot 扩展上的表现。我们在 Agent Experience 系列中逐步分享了所学到的内容。每篇文章涵盖该方法的一部分。这本 playbook 将这些部分端到端地整合在一起，以便你可以在自己的技术上运行它。

你能从中获得什么

这本 playbook 遵循从设置到交付修复的评估流程。

经得起推敲的结果

评估可能会以令人信服的方式欺骗你。我们见过从未编译过的代码获得满分，也见过无论代理是否使用 Platform X 都能通过的“使用了 Platform X”检查。这本 playbook 的评估模型规定了在你可以信任结果之前，结果需要满足什么条件，从判断含义的标准到证明代码可运行的关卡。

衡量关键事项的标准

编写标准是你将领域专业知识变得可衡量的地方，也是最困难的一步。这本 playbook 展示了如何编写让评判者每次都按同样方式裁决的标准，如何在信任它们之前进行校准，以及当你的产品变化时如何对它们进行版本管理。它还涵盖了各种陷阱，比如让模型替你编写标准。

从症状到原因的更短路径

读数告诉你什么失败了，而轨迹告诉你为什么失败。你将学会区分从未加载的扩展、加载了但从未被调用的扩展，以及被调用了但应用错误的扩展，因为每一种都需要不同的修复。在我们评估过的每种技术中反复出现的九种失败模式，各自指向应首先检查的表面。

可交付的修复

除非有人改变行为的源头，否则评估不会产生任何影响。这本 playbook 涵盖了如何在交付之前将每项提议的变更作为假设进行测试，以及如何向负责团队提供证据，无论那是你自己的团队、你直接合作的团队，还是你贡献的开源项目。

来自真实评估的示例

手册中的每一步都基于我们在 Cosmos DB、SPFx 及其他技术上运行过的场景。这些评估促成了对文档和代理扩展的数十项已发布修复，包括对 Azure Cosmos DB Agent Kit 的 46 项改进。SPFx 项目升级在手册中端到端运行，从场景到已发布的修复。当你准备好运行自己的评估时，一份质量检查清单可以帮助你先进行审查。

适用对象

本手册适用于任何构建 AI 编码代理所使用的技术或扩展的人。如果你构建 SDK、API、服务、CLI、MCP 服务器、技能、插件或指令集，或者编写它们背后的文档，你就掌控着代理发现和应用的内容。如果你是为某项技术做推广而非拥有它，你带来的是评估它的场景知识，以及帮助拥有团队决定要更改什么的证据。

该方法不依赖于特定的评估系统。你可以使用团队自建的或现有的系统，手册列出了需要检查的能力。

通过 AX Practitioner 技能进行交互式学习

除了 PDF，我们还发布了 AX Practitioner 技能，让你在应用方法的同时学习它。将其安装到你的编码代理中，并在进行自己的评估时向它提问，比如如何措辞一条标准，或者为什么代理忽略了你的扩展。它还可以根据手册的标准审查你的场景和标准。

该技能仅根据手册作答。当问题超出其范围时，技能会说明这一点，并在使用任何其他来源之前先询问。在 330 个问题中，其答案与手册内容相比平均得分 95%。

开始评估

下载 AX Practitioner 手册并运行你的第一次评估。要边做边学，安装 AX Practitioner 技能并在工作时随时使用。

你已经知道你的技术正确是什么样子。手册会告诉你如何查明代理是否也知道。

作者

首席开发者布道师

Waldek 是 Microsoft 的首席开发者布道师，专注于 AI 编码代理。他研究 AI 编码代理，并为 Microsoft 的产品和服务评估和改进代理体验。