在这个快速入门中，你通过在编码助理中使用 Agent 365技能 ，将现有的代理连接到Agent 365。 路径从注册代理开始，然后添加你选择的功能，最后以验证结束。 如果你构建了一个需要Frontier预览程序的AI队友，也可以在本地测试。
每一步都会标明处理该任务的技能，并展示一个示例请求。 你通过说明结果来调用技能，而不是输入技能名称。
Prerequisites
- 支持的栈上的现有代理：Python、Node.js或.NET。
- 一个启用了 Agent 365 的 Microsoft 租户。 以全局管理员身份登录，或者在有全局管理员协助完成 OAuth 权限授予的情况下，以 Agent ID 开发人员身份登录。
- 一个带有创建资源权限的 Azure 订阅。
- 支持的编码助手：Claude Code、GitHub Copilot CLI 或 VS Code 代理模式。
- GitHub CLI（
gh），用于安装这些技能。
Note
Agent 365 的设置会使用 Microsoft 管理的 Agent 365 企业级 CLI 应用，前提是租户中有该应用。 你不需要为这条路径创建自定义客户端应用。 如果企业应用不可用，设置会退回到一个名为 Agent 365 CLI 的租户自有应用。 明确配置的自定义客户端应用依然被支持。 更多信息请参见 Agent 365 CLI 的自定义客户端应用注册。
授权取决于你采用的具体功能：
- Identity. 没有额外的许可。 租户必须启用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要求确认它是使用 OBO（代表已登录用户）进行身份验证，还是使用 S2S（作为自身进行身份验证，没有已登录用户）。 继续注册代理。 -
AI 队友，确实如此。 它是以自己的用户账户进行认证，所以
a365-setup不会要求设置认证模式。 跳转到添加消息和通知。 这条路径需要使用Frontier预览程序。
两条路径随后在仪器处继续进行 可观测性。 要选择方式和认证模式，请参见 代理类型和认证模式。
注册代理
如果 a365-setup 将你引导至标准代理路径，请完成此步骤。
技能：make-a365-agent
将此代理注册到 Agent 365
完成该技能后，你的代理在 Microsoft Entra 中拥有一个已注册的蓝图、一个由该蓝图创建的代理标识，以及它所需的权限：用于 OBO 的委派权限或用于 S2S 的应用权限。 注册提供目录可见性；可观测性这一步会添加遥测数据。
添加消息和通知
如果 a365-setup 将你引导至 AI 队友路径，请完成此步骤。
技能：make-ai-teammate
向该代理添加消息和通知
该技能会添加托管层和消息路由，并注册代理。 人们可以通过Teams、Outlook、Word评论和电子邮件联系它。
Important
这一步会让你的客服代理拥有自己的用户账户，包括邮箱和Teams存在。 该功能仅对参与 Frontier 预览计划的租户开放。 如果你的租户没有注册，可以跳过这一步。
可观测仪器
无论哪条路径，都要完成这一步。 如果 a365-setup 还没记录这些信息，技能会询问你使用的代理类型和认证模式。
技能：instrument-observability
为该代理添加可观测性
该技能支持所有三种认证模式：
- OBO（代表登录用户）
- S2S（服务到服务，用于背景操作）
- Agentic-User（代理专用的用户账户，需要 Frontier 预览计划）
在所有模式下，导出器都通过 S2S 路由使用仅应用访问令牌发送遥测数据，因此注册的代理实例不需要可观测性权限或管理员同意。 该模式仅决定你的代理如何获得该令牌。 参见使用 S2S 启用 Agent 365和Agent 身份。
测试运行后，您的代理的跨度会显示在 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 权限，您的代理才能调用它们。 参见 添加和管理工具。
添加数据丢失防护
如果您的代理需要 Microsoft Purview 数据丢失防护（DLP），请完成此可选步骤。 该技能支持智能体委托身份验证，以及采用客户端机密的 Node.js S2S FMI 身份验证。
技能：purview-dlp-integration
将Purview DLP添加到该代理中
该技能新增了 Microsoft Graph processContent 检查，在匹配到输入阻止策略时，会在提示到达 LLM 之前将其拦截，并指导配置权限和 DLP 策略。 可选响应会检查审计响应，但不会过滤敏感输出。 默认情况下，错误和超时都会终止当前轮次；如果响应未通过审核，还将不返回该响应。
Important
此步骤要求在您的租户中启用 Purview DLP for AI，包括许可、即用即付计费，以及 DSPM for AI 载入配置。 对于 .NET，请验证你的 SDK 版本是否采用最佳防护措施。
在本地测试
如果你使用的是 AI 队友路径，请完成此步骤；该路径需要 Frontier 预览计划。 Agents Playground 是通过代理消息终端连接的，所以不适用于标准代理。
技能：test-local
在本地测试该代理
你的代理可在 Agents Playground（一个本地测试框架）上运行，因此你可以在部署前先进行冒烟测试。
验证结果
您的客服应像入职前一样开始并回复，并以注册身份出现在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，然后再运行相关技能。 |