在这个快速入门中，你通过在编码助理中使用 Agent 365技能 ，将现有的代理连接到Agent 365。 路径从注册代理开始，然后添加你选择的功能，最后以验证结束。 如果您构建了 AI 团队成员（这需要 Frontier 预览计划），您还可以在本地进行测试。
每一步都会标明处理该任务的技能，并展示一个示例请求。 你通过说明结果来调用技能，而不是输入技能名称。
先决条件
- 支持的栈上的现有代理：Python、Node.js或.NET。
- 一个启用了 Agent 365 的 Microsoft 租户。 以全局管理员身份登录，或者在有全局管理员协助完成 OAuth 权限授予的情况下，以 Agent ID 开发人员身份登录。
- 一个带有创建资源权限的 Azure 订阅。
- 支持的编码助手：Claude Code、GitHub Copilot CLI 或 VS Code 代理模式。
- GitHub CLI（
gh），用于安装这些技能。
注释
Agent 365 的设置会使用 Microsoft 管理的 Agent 365 企业级 CLI 应用，前提是租户中有该应用。 你不需要为这条路径创建自定义客户端应用。 如果企业应用不可用，设置会退回到一个名为 Agent 365 CLI 的租户自有应用。 明确配置的自定义客户端应用依然被支持。 更多信息请参见 Agent 365 CLI 的自定义客户端应用注册。
授权取决于你采用的具体功能：
- 身份。 没有额外的许可。 租户必须启用Agent 365。
- 可观测性。 租户中至少有一名用户分配了 Microsoft 365 E7 或 Microsoft Agent 365 许可证。 没有它，遥测数据会被静默丢弃。
- 工具（工作智商）。 智能 Microsoft 365 Copilot 副驾驶® 许可证。 工作智商MCP目前处于预览阶段。
- 通知。 代理的用户账户，仅在Frontier预览程序中对租户开放。
Tip
首先确认该 SDK 是否是适用于你的代理的正确集成机制。 参见 “选择你的集成选项”。 关于注册背后的身份模型，包括蓝图、权限和同意，请参见代理身份和 Microsoft Entra 智能体 ID 关键概念。
安装技能
将这些技能安装到你的编程助理中：
gh skill add microsoft/agent365-skills
同样的命令适用于 Claude Code、GitHub Copilot CLI 和 VS Code 代理模式。 之后重新启动你的助手，以便其加载新的技能。
搭建并检测项目
在编码助理中打开你的代理项目，然后运行：
技能：a365-setup
为 Agent 365 设置此项目
回答关于你经纪人的提问。 技能完成后，它会验证你的前置条件并检测你的堆栈。
安装程序会将生成的 ID 和端点保存到 a365.generated.config.json 中。 标准代理设置不需要手动编写的配置文件;AI队友配置需要手动创建 a365.config.json。
a365-setup 然后会引导你走两条配置路径之一。 完成它选择的那一个，然后继续执行以下共享步骤：
随后，这两条路径均在可观测性监控工具处继续。
注册代理
如果 a365-setup 将你引导至标准代理路径，请完成此步骤。
技能：make-a365-agent
将此代理注册到 Agent 365
该技能完成后，你的代理将拥有一个已在 Microsoft Entra 中注册的蓝图、一个基于该蓝图创建的代理标识，以及它所需的权限。 注册提供目录可见性；可观测性这一步会添加遥测数据。
添加消息和通知
如果 a365-setup 将你引导至 AI 队友路径，请完成此步骤。
技能：make-ai-teammate
向该代理添加消息和通知
该技能会添加托管层和消息路由，并注册代理。 人们可以通过Teams、Outlook、Word评论和电子邮件联系它。
Important
这一步会让你的客服代理拥有自己的用户账户，包括邮箱和Teams存在。 该功能仅对参与 Frontier 预览计划的租户开放。 如果你的租户没有注册，可以跳过这一步。
可观测性监控工具
无论哪条路径，都要完成这一步。 技能会问你用的是哪种类型的经纪人。
技能：instrument-observability
为该代理添加可观测性
提示时，选择代理使用的认证模式：OBO（代表登录用户）、Agentic-User（代理自身用户账户，需要 Frontier 预览程序）或 S2S（服务对服务，用于后台操作）。 导出器使用与代理认证相同的模式，所以选择与你权限模型相匹配的模式。 参见 代理身份。
测试运行后，您的代理的跨度会显示在 Microsoft Defender、Microsoft Purview 和 Microsoft 365 管理中心 中。
Important
有两种情况会让遥测看起来像消失了，尽管请求返回的是HTTP 200。 如果租户中没有用户分配了 Microsoft 365 E7 或 Microsoft Agent 365 许可证，整个请求将被放弃;仅仅存在 SKU 是不够的。 如果运行的根节点没有有效的 invoke_agent 跨度，这些跨度在 Defender 高级搜索中仍可查询，但不会出现在上述三个界面中的任何一个。 根区间是SDK对一个代理调用发出的顶层区间;每个工具调用和推理事件都嵌套在其中。
连接 Microsoft 365 数据
如果您的代理读取或操作 Microsoft 365 数据，请在任一路径上完成此步骤。 Work IQ 工具需要授权模型，所以如果你在可观察性步骤选择了 S2S，这一步会自动跳过。
技能：add-workiq-tools
连接 Work IQ 邮件和日历
说出你需要的工作负载，比如邮件、日历或Word。 该技能连接匹配的 Work IQ MCP 服务器，您的代理随后可以在管理员控制下访问该数据。
Important
Work IQ MCP 处于预览阶段，需要 智能 Microsoft 365 Copilot 副驾驶® 许可证。 全局管理员必须先授予 Work IQ 服务器的 OAuth 权限，您的代理才能调用它们。 参见 添加和管理工具。
在本地测试
如果你使用的是 AI 队友路径，请完成此步骤；该路径需要 Frontier 预览计划。 Agents Playground 是通过代理消息终端连接的，所以不适用于标准代理。
技能：test-local
在本地测试该代理
您的智能体在 Agents Playground（一个本地测试环境）上运行，因此您可以在部署前对其进行冒烟测试。
验证结果
您的智能体应像入职前一样启动并响应，并在 Agent 365 中以其注册身份显示。
如果你的编码助理暴露了 Agent 365 内部的验证与诊断功能，请它验证 该 Agent 365 集成 ，以对项目运行代码级预检。 它检查了仪器、Microsoft Entra 工件、消息传递、工具访问及相关配置中的漏洞。 该能力内部也被称为 a365-code-validator;可用性和精确路由取决于编码助手和安装的技能包。
在部署之前，先完成 Agent 365 SDK 验证检查清单。
Troubleshoot
请使用下表来识别并解决将您的代理连接到 Agent 365 时的常见问题。
| 症状 | 解决方案 |
|---|---|
| 编码助手描述命令，但不执行命令 | 使用带有终端访问权限的模式。 在 VS Code 中，使用代理模式。 询问和编辑模式无法运行终端命令。 |
| 安装程序报告缺少 Azure 先决条件 | 完成列出的 a365-setup 前置条件，然后重新运行该技能。 |
| 蓝图注册失败，或CLI命令返回授权错误 | 确认你已使用具有在租户中注册代理身份蓝图权限的账户登录。 |
| 未显示任何遥测数据 | 确认租户中至少有一名用户已分配 Microsoft 365 E7 或 Microsoft Agent 365 许可证，然后确认运行结果在其根节点处输出有效的 invoke_agent span 元素，最后确认你选择的身份验证模式与你的环境相匹配。 请你的编码助理验证Agent 365的集成;安装的验证器技能可以诊断仪器。 |
| 有一步看起来像是被跳过了 | 技能具备状态感知能力，会跳过已配置好的工作，因此这一步很可能已经完成。 重新运行该技能，明确说明结果。 |
| 配置值需要在设置后更改 | 如果你的设置使用了 a365.config.json，编辑并重新运行 a365 config init -c ./a365.config.json，然后再运行相关技能。 |