Agent 365 引导代理设置技能

Agent 365 技能提供引导式设置路径,通过支持的编码助手将现有代理连接到 Agent 365。 你说明你想要的结果,比如 为该代理添加可观察性,技能会识别项目,收集所需值,进行集成修改,并检查结果。

这些技能运行在所有编码代理中,包括Claude Code、GitHub Copilot CLI和VS Code代理模式。

要安装技能并按照代理的入职流程,请参见 快速入门:将现有代理连接到代理365

注释

技能取代了之前使用 instructions.md 文件的设置流程。

何时使用技能

将现有代理连接到企业身份、可观察性、受控工具和通知需要多个有序的设置步骤。 这些步骤包括安装 Agent 365 CLI、验证 Azure 前置需求、注册蓝图、配置 Entra 资源、布线 OpenTelemetry 导出器、连接模型上下文协议(MCP)服务器以及本地测试。

技能人员按照所选路径的必要顺序执行这些步骤,并验证最终项目。

技能的运行方式

每个技能遵循相同的工作流程:

  1. 说出你想要的结果。
  2. 让技能识别项目栈和现有配置。
  3. 提供它请求的值,比如认证模式。
  4. 审查代码、清单和配置的更改。
  5. 确认项目仍在构建且集成正常。

七大技能

a365-setup 是入口。 验证先修条件后,会引导你走两条路径之一,你只需遵循这条路径:

  • 标准特工a365-setup 代表 到 make-a365-agent。 当代理需要注册和可观察但不需要用户账户时,使用这条路径。
  • AI队友a365-setup 将 委托到 make-ai-teammate,对于需要自己用户账户的代理。 这条路径需要使用Frontier预览程序。
Skill Purpose
a365-setup 安装 Agent 365 CLI,验证 Azure 前置条件,检测代理栈,然后委派给 make-a365-agentmake-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 命令。