重要
你需要成为Frontier 预览计划的一员,才能获取 Microsoft Agent 365 的提前访问权限。 Frontier将你直接连接到Microsoft最新的人工智能创新。 Frontier 预览版受客户协议中现有预览条款的约束。 由于这些功能仍在开发中,其可用性和功能可能会随时间而变化。
在开发生命周期中,你会建造两个工件。 Agent 365 代理要求以下工件存在:
- 代理身份 ——使用 Agent 365 CLI 来设置代理蓝图。 设置蓝图后,你可以在 Microsoft 365 管理中心和 Teams 中创建代理实例和代理用户。 了解更多关于代理身份的信息。
- 代理代码 ——使用 Agent 365 SDK 扩展您的代理代码,包含可观察性、工具和通知功能。 开源的 Agent 365 Samples 仓库 提供了帮助您快速启动 Agent 365 开发的样本。
以下部分列出了在 Agent 365 开发生命周期中构建这些工件的步骤:
提示
想自动化第2到第5步? AI 引导式设置使用 AI 编码代理(如 GitHub Copilot、Claude Code 或 OpenAI Codex)以交互方式引导你完成 CLI 安装、配置、蓝图创建、部署和发布。 所有这些都来自一个指令文件。
1. 构建并运行代理
设置代理代码来存储你的代理逻辑。 这些代码可以是现有的代理,也可以是新的代理。
使用任何代理SDK构建你的代理,并托管在任何云服务上。 如果您还没有代理,可以使用一些最常用的代理SDK的示例快速入门:microsoft/Agent365-Samples。
根据您想为代理添加哪些 Agent 365 功能,可以使用 Agent 365 SDK 添加:
可观测 性——这里有两个选项:
通知 – 使你能够生成可以响应来自 Microsoft 365 应用程序的事件和通知的代理。
工具 – 使你能够向代理(如电子邮件、日历和 Word)添加 各种功能强大的工具功能 。
- 通过使用 模拟工具服务器,在本地开始开发和测试,无需身份验证或外部依赖。
- 准备就绪后,切换到具有完整身份验证和 Microsoft 365 集成功能的生产 MCP 服务器,以实现实时功能。
代理标识 - 使你能够生成代理,这些代理可以使用其自己的唯一代理标识进行工具调用、可观察性等。
完成后,代理应在 Visual Studio Code 或其他 IDE 中运行,且不会出错。 学习本地测试代理,并在部署到云端之前, 使用开发隧道(Dev Tunnels)测试 Microsoft 365 应用 。
2. 配置 Agent 365 配置
Agent 365 CLI需要知道你的租户、订阅和其他细节,才能创建如Agent Blueprint等所需的代理资源。
对于代理,可以跳过创建配置文件并直接传递给 --agent-name <name>a365 setup all. 对于 AI 团队成员,请在运行安装程序之前在工作目录中手动创建 a365.config.json 。 或者,AI 引导式设置可以使用 AI 编码代理(如 GitHub Copilot、Claude Code 或 OpenAI Codex)自动执行此步骤和所有剩余步骤。
注释
如果你已经部署了代理,你需要在配置中指定消息端点,就像 设置代理消息端点描述的那样。
完成后,你的工作目录中应该出现a365.config.json,其中已经正确填充了所有详细信息。
3. 设置代理蓝图
蓝图定义代理的标识、权限和基础结构要求。 每个被导入的代理实例都是基于这个代理蓝图创建的。
你需要从 第二步获得有效的Agent 365配置文件。
完成后,你拥有所有必要的Azure资源:代理蓝图、蓝图上的MCP权限、服务主体。
注释
如果以代理 ID 管理员或代理 ID 开发人员(而不是全局管理员)身份运行, a365 setup all 则完成除 OAuth2 权限授予之外的所有步骤。 全局管理员必须运行 a365 setup admin 才能完成剩余的授权,然后代理才能完全运行。
4. 部署
将你的代理代码部署到在线应用程序中,这样每个代理实例都能运行。
如果你的代理已经运行在Azure或其他云服务上,比如亚马逊网络服务(AWS)或谷歌云平台(GCP),这一步是可选的。
要部署,你需要从第1步获取可用的代理代码。
完成后,您在 Azure(或其他云)中将拥有一个运行 Agent 365 代理代码的可用 Web 应用。 你可以通过增加更多服务器实例来进一步配置,以提升可靠性和可用性。
5.将代理发布到Microsoft 365管理中心
发布代理时,管理员可以通过Microsoft 365管理中心创建实例和管理治理。
完成后,你应该会在 Microsoft 管理中心的注册表上看到代理。
6. 创建代理实例
从用作模板的代理蓝图创建代理实例。
需要准备好以下各项:
完成后,你的代理人会出现在组织架构图中,向你汇报,并可通过Teams或电子邮件进行沟通。 此过程可能需要几分钟。
7. 将代理发布到 Microsoft 市场
在一个或多个租户中全面开发并测试您的代理后,使其在 Microsoft 市场上可用。
要执行此操作,您需要在 Partner Center 中拥有一个微软 AI 云合作伙伴计划帐户。 如果没有帐户,请创建一个帐户以获取 PartnerID。 接下来,注册 Microsoft 365 和 Copilot 计划,以便获取发布代理要约所需的资源和支持。 注册后,查看提交清单和验证指南,然后通过合作伙伴中心分步提交指南提交代理。
了解如何使用合作伙伴中心将代理提交到 Microsoft 市场。
完成后,代理将发布到Microsoft市场,可供客户发现和部署。