通过

部署和发布代理

重要提示

你需要是边境预览计划的一部分，才能提前访问 Microsoft Agent 365。 边界将你直接与Microsoft最新的 AI 创新联系起来。 边境预览版受客户协议现有预览条款的约束。 由于这些功能仍在开发中，其可用性和功能可能会随时间而变化。

你已在本地生成代理并对其进行了测试，现在是时候在云中实现它了。 部署和发布您的代理使其在整个组织中可用，使团队能够发现、创建代理实例并通过 Microsoft 365 进行交互。

本指南将指导你完成将代理代码部署到 Azure 并将其发布到Microsoft管理中心，其中它将成为组织的可发现资产。

概述

部署和发布过程涉及两个关键步骤：

  1. 部署 ——将你的代理部署到 Azure Web 应用（可选，如果代理已经运行并可访问，可以跳过）
  2. 发布 - 在 Microsoft 365 管理中心 上将代理发布到代理存储

发布后，通过 Microsoft Teams 创建代理实例完成入职程序。

重要提示

create-instance该命令暂时被移除。 它绕过了必要的注册步骤，从而限制了代理的功能。 一旦达到推荐工作流程水平，该命令可能会在后续版本中重新引入。 使用 publish 命令后，通过 Microsoft Teams 创建代理实例。

先决条件

在开始之前，确保你拥有：

所需权限和访问权限

  • Microsoft Entra租户 ，担任以下角色之一：
    • 全局管理员
    • 代理 ID 管理员
    • 代理 ID 开发人员
  • 对 Azure 订阅具有参与者访问权限的用户

所需的工具

所需的设置步骤

在部署和发布之前，请确保按顺序完成以下步骤：

  1. 已创建代理蓝图 ——在 注册代理 中完成设置步骤以创建代理蓝图
  2. 在本地 测试的代理 - 验证代理是否适用于代理场（请参阅 本地测试代理）
  3. 配置文件就绪 - 确保 a365.config.json 并 a365.generated.config.json 处于最新状态

步骤 1：部署到 Azure

该 a365 deploy 命令 将代理部署到在安装过程中创建的 Azure Web 应用。 这会将代理代码上传到 Azure，使其可在云中运行，并处理来自 Microsoft 365 的请求。

部署代理

下面是部署命令：

a365 deploy

.NET 代理的 deploy 命令：

  • 检测 .NET 项目文件（*.csproj或*.fsproj*.vbproj）
  • 使用 还原 NuGet 包 dotnet restore
  • 使用 dotnet publish 发布配置发布应用程序
  • 使用入口点 DLL 命令创建 Oryx 清单（例如 dotnet YourApp.dll）
  • 根据检测到的 .NET 版本配置 Azure 运行时（默认值： DOTNET|8.0
  • 通过 zip 进行实时部署

警告

机密管理：部署时，环境变量（包括 API 密钥和机密）存储为Azure 应用设置。 虽然环境变量通常用于配置，但它们以纯文本形式存储。 对于生产环境，Microsoft建议对敏感机密使用 Azure 密钥库。 有关详细信息，请参阅在 ASP.NET Core 开发中安全存储应用机密。 请将这些文件视为敏感信息，在任何情况下都不要将它们提交到源代码管理。

验证部署

部署完成后：

  1. 在 Azure 门户中导航到 Web 应用。
  2. 在应用中，转到设置>高级设置。
  3. 在部署中心检查部署日志

步骤 2：发布到 Microsoft 管理中心

该a365 publish命令将代理发布到Microsoft 365 管理中心上的代理存储，使其可发现并可安装。 这一最后一步使你的代理可供组织创建代理实例并在其 Microsoft 365 环境中使用。

4.发布代理

运行发布命令：

a365 publish

“发布”命令。

  • 从嵌入资源中提取清单模板（如果 manifest 文件夹不存在）
  • 使用代理蓝图 ID 进行更新manifest.json
  • 暂停以自定义清单字段（版本、名称、说明、开发人员信息、图标）
  • 包应用捆绑包 （manifest.zip）
  • 上传到 Microsoft 365 管理中心 上的代理存储
  • 为 Teams 集成创建联合标识
  • 分配必要的图形权限

自定义清单

CLI 在发布期间暂停，以允许自定义代理清单：

=== CUSTOMIZE YOUR AGENT MANIFEST ===

Your manifest has been updated at: [path]\manifest\manifest.json

When you're done customizing, type 'continue' (or 'c') and press Enter to proceed:

手动步骤：

  1. 在文本编辑器中打开 manifest.json。
  2. 自定义必填字段：
    • 更新版本号。 如果重新上传，则从上一个增量。
    • 设置有意义的代理名称。 名称应等于或小于 30 个字符。
    • 编写拉取请求描述
    • 开发人员信息
    • （可选）替换图标文件
  3. 创建清单文件
  4. 返回到 CLI 并键入 continue 或 c 按 Enter。

测试已部署的智能体

部署和发布代理后，可以在 Microsoft 365 中对其进行测试，以确保它在生产环境中正常工作。 部署后，代理与 Microsoft 365 服务（包括 Teams（聊天、频道、会议）、电子邮件和日历（发送/接收、日程安排）、SharePoint 和 OneDrive（文档访问、文件共享）和协作工具（组织状态、Planner 任务、文档注释）集成。

重要提示

代理用户需要适当的Microsoft 365 个许可证才能访问这些服务。 常见许可证包括Microsoft 365 E5、Teams Enterprise 和 Microsoft 365 Copilot。

在管理中心查看已部署的代理

发布后，代理会显示在Microsoft管理中心进行招聘。 传播可能需要一些时间。

导航到 MIcrosoft 365 管理中心。

  • 查看已发布的代理
  • 管理代理设置
  • 监视代理使用情况
  • 配置权限

Teams 中的测试代理

部署和发布代理后，可以直接在 Microsoft Teams 中对其进行测试：

注释

执照要求： 确保你的账户已分配了“Microsoft Agent 365 Frontier”许可证。 该许可证是创建代理实例和与 Microsoft Teams 代理交互的必要条件。 如果你没有这张许可证，请联系你的租户管理员。

  1. 打开开发人员门户

    • 导航到开发人员门户。
    • 按名称搜索代理
    • 如果无权访问此门户，请联系租户管理员

  2. 配置代理蓝图

    • 将 代理类型 设置为 基于机器人
    • 从a365 config display -g（使用agentBlueprintId值）
    • 保存配置

  3. 开始在 Teams 中使用

    • 使用帐户打开 Microsoft Teams
    • 与新创建的代理用户开始新的聊天
    • 发送测试消息以验证代理功能

  4. 示例测试消息

    发送此邮件以测试电子邮件功能（根据需要更新收件人电子邮件）：

    Send an email to recipient@contoso.com with subject "Hello from Teams" and message "This is a test message from my agent!"

    代理应处理请求并发送电子邮件，而无需进行更多确认。

后续步骤

恭喜！ 你的代理现在位于云中，可以与 Microsoft 365 中的团队一起工作。 最初作为本地代码的系统，现在已经变成了一个可发现、企业级的助手，用户可以在组织内创建代理实例。

代理处理实际请求时，请考虑以下后续步骤：

  • 监视性能：使用 可观测性功能 跟踪代理行为并优化响应
  • 添加更多工具：浏览 工具目录 以扩展代理的功能
  • 循环访问和改进：更新代理代码、重新部署和重新发布（请记住递增版本号！）
  • 跨组织进行缩放：分享代理的成功案例以推动采用

代理从开发到部署的过程已完成，但其影响刚刚开始。

相关内容

  • Last updated on