Agent 365 技能提供引导式设置路径,通过支持的编码助手将现有代理连接到 Agent 365。 你说明你想要的结果,比如 为该代理添加可观察性,技能会识别项目,收集所需值,进行集成修改,并检查结果。
这些技能运行在所有编码代理中,包括Claude Code、GitHub Copilot CLI和VS Code代理模式。
要安装技能并按照代理的入职流程,请参见 快速入门:将现有代理连接到代理365。
注释
技能取代了之前使用 instructions.md 文件的设置流程。
何时使用技能
将现有代理连接到企业身份、可观察性、受控工具和通知需要多个有序的设置步骤。 这些步骤包括安装 Agent 365 CLI、验证 Azure 前置需求、注册蓝图、配置 Entra 资源、布线 OpenTelemetry 导出器、连接模型上下文协议(MCP)服务器以及本地测试。
技能人员按照所选路径的必要顺序执行这些步骤,并验证最终项目。
技能的运行方式
每个技能遵循相同的工作流程:
- 说出你想要的结果。
- 让技能识别项目栈和现有配置。
- 提供它请求的值,比如认证模式。
- 审查代码、清单和配置的更改。
- 确认项目仍在构建且集成正常。
七大技能
a365-setup 是入口。 验证先修条件后,会引导你走两条路径之一,你只需遵循这条路径:
-
标准特工。
a365-setup代表 到make-a365-agent。 当代理需要注册和可观察但不需要用户账户时,使用这条路径。 -
AI队友。
a365-setup将 委托到make-ai-teammate,对于需要自己用户账户的代理。 这条路径需要使用Frontier预览程序。
| Skill | Purpose |
|---|---|
a365-setup |
安装 Agent 365 CLI,验证 Azure 前置条件,检测代理栈,然后委派给 make-a365-agent 或 make-ai-teammate。 |
make-a365-agent |
配置一个不需要自己用户账户的标准代理。 在 Microsoft Entra 中注册代理身份蓝图,从蓝图创建代理身份,配置代理所需的 Entra ID 权限,然后作为插件提供可观察性和工具。 |
make-ai-teammate |
将代理转变为拥有自己用户账户的AI队友。 注册代理身份蓝图并由此创建代理身份,然后添加托管层、消息路由和通知功能。 需要 a365-setup 先跑过。 |
instrument-observability |
将 OpenTelemetry 和 Agent 365 追踪导出器连接至 Microsoft Defender、Microsoft Purview 和 Microsoft 365 管理中心。 询问代理类型和认证模式;参见 代理身份。 |
a365-code-validator |
验证并诊断现有的 Agent 365 集成,包括仪器、Microsoft Entra 工件、消息传递、工具访问及相关配置。 默认情况下,只读。 用 instrument-observability 来从零开始添加可观测性。 |
add-workiq-tools |
连接 Work IQ MCP 服务器,包括 Mail、Calendar 和 Word,使代理能够读取并操作 Microsoft 365 数据。 需要授权模型,当认证模式为S2S时会自动跳过。 |
test-local |
本地运行 AI 团队代理,并开放 Agents Playground 进行交互测试,无需云部署。 适用于AI队友路径。 |
Important
make-ai-teammate 给你的客服用户账户,包括邮箱和Teams存在。 该功能仅对参与 Frontier 预览计划的租户开放。
你通常通过陈述结果来调用技能,而不是直接说出技能名称。 例如, 将可观测性添加到该代理 运行 instrument-observability。 如果你的编码助理暴露了内部 a365-code-validator 能力,请让它 验证该 Agent 365 集成;该功能内部也称为“验证与诊断”。 可用性和调用取决于助手和已安装的技能包。 关于每步使用的请求措辞,请参见 快速入门:将现有代理连接到代理365。
支持的堆栈
技能会自动检测项目栈,所以你不需要手动映射项目。 这些是技能检测到的堆叠。 该SDK也支持其他框架。
| 语言 | Frameworks |
|---|---|
| .NET | Microsoft Agent Framework, 语义内核, Azure AI Foundry |
| Node.js | LangChain, OpenAI Agents SDK, Claude Agent SDK, 语义内核, Google ADK |
| Python | Microsoft Agent Framework、LangChain、OpenAI Agents SDK、Claude Agent SDK、语义内核、Google ADK |
安全性与重复性
技能设计用于应用设置变更而不改变项目现有行为。 请用 Agent 365 SDK 验证检查表确认此行为。
- 加性和幂和性。 技能不会删除或重构现有代码,重运行技能也不会重复已完成的工作。
- 国家意识。 技能检测已经接线的内容,所以它们跳过而非重复已完成的步骤。
- 有护栏。 技能不会修改项目外的文件,并且会在完成前验证构建是否通过。
技能的使用方式:
- 你已经有一个现有的代理,想直接上线,而不是手动编写集成内容。
- 你的开发流程已经包含了一个编码助手。
- 你需要项目间的入职流程保持一致且可重复。
在以下情况下使用手动设置:
- 你的环境不标准,每个步骤都需要个人控制。
- 你的组织限制了编码助理的工作流程。
- 你正在排查故障,想自己操作每一步。
手动路径请使用快速启动中的设置步骤 :将现有代理连接到 Agent 365,并运行相应的 Agent 365 CLI 命令。