将代理发布到 Microsoft 管理中心

使用 a365 publish 命令打包代理，然后将包上传到Microsoft 365 管理中心。 发布后，可以在组织中创建代理实例并管理代理。

先决条件

开始之前，请确保你准备好以下物品。

所需账户和权限

  • 拥有以下角色之一的Microsoft 365 租户（上传至管理员中心的步骤所需）：

    • 全局管理员

所需的工具

所需的设置步骤

发布之前，请完成以下步骤：

  1. 创建代理蓝图 ——按照 设置步骤 创建代理蓝图。
  2. 在本地测试代理 - 使用 Agents Playground 验证代理是否正常工作（请参阅 本地测试代理）。
  3. 准备配置文件 - 确保 a365.config.json 并 a365.generated.config.json 处于最新状态。

发布命令

执行以下a365 publish命令：

a365 publish

注意

运行 a365 publish -h 将显示此命令支持的所有选项。

这个命令的作用：

  1. 更新清单 - 使用代理蓝图 ID 进行更新 manifest.json 。
  2. 创建包 - 将manifest.json和图标打包为manifest.zip。
  3. 打印说明 - 显示通过Microsoft 365 管理中心上传的分步说明。

注意

该 a365 publish 命令适用于代理和 AI 团队成员。 对于使用 --agent-name （无配置）预配的代理，请确保 a365.generated.config.json 在运行 a365 publish之前存在于工作目录中，因为命令从此文件中读取蓝图 ID。

上传到管理中心

a365 publish完成后，按照打印的说明上传代理：

  1. 转到Microsoft 365 管理中心。
  2. 导航到 代理>所有代理。
  3. 选择“ 上传自定义代理”。
  4. 从项目中的manifest.zip文件夹上传manifest文件。

有关详细信息，请参阅 将代理加载到 Microsoft 365 管理中心。

验证成功发布

请使用以下清单来验证您的代理人是否成功发表：

✅ CLI 发布成功
✅ manifest 使用 manifest.json 和 manifest.zip 创建的文件夹
✅ 代理显示在Microsoft管理中心

命令行界面 (CLI) 输出

发布命令成功后，会看到以下输出消息：

✅ Manifest updated successfully
✅ manifest.zip created successfully
✅ 打印的分步上传说明

如果命令失败，请查看错误消息并确保已完成蓝图设置。

可能的错误：

Error 解决步骤
Agent blueprint ID not found 运行 a365 setup 以完成蓝图设置。
Permissions missing 用命令a365 setup permissions重新运行设置。

当出版失败时，请遵循 以下步骤 。

清单文件

可以使用 manifest PowerShell 命令测试文件夹中的以下文件。

# Check manifest folder and contents exists
Test-Path <deploymentProjectPath>/manifest/
Test-Path <deploymentProjectPath>/manifest/manifest.json
Test-Path <deploymentProjectPath>/manifest/manifest.zip
# All should return: True

注意

如果看不到这些文件，再试一次执行命令a365 publish。

代理出现在管理中心

注意

上传后，代理可能需要 5-10 分钟 才能显示在管理中心和 Teams 中。 这种延迟是正常的。

使用以下步骤确认代理是否存在：

  1. 转到 Microsoft 365 管理中心。
  2. 导航到 代理>所有代理。
  3. 代理显示在列表中。

下表展示了您可以找到的详细信息：

领域 需要注意的事项
名称 您的代理名称（来自 manifest.json）
版本 版本号（例如 1.0.0）
Publisher 你的组织名称
可用 性 可用/所有用户

另请参阅

后续步骤

发布代理后，创建一个实例，方便你在租户中配置和使用。

创建一个代理实例

故障排除

将代理发布到 Microsoft 365 管理中心时的常见问题。

提示

Agent 365 故障排除指南 包含高层次的故障排除建议、最佳实践以及针对 Agent 365 开发生命周期各阶段的故障排除内容链接。

发布命令失败

症状：

  • 在 a365 publish 期间发生错误
  • manifest.zip 尚未创建

根本原因：

  • 设置还没完成
  • 清单验证错误
  • 权限不足

Solution:

  1. 确认设置完成。

    Get-Content a365.generated.config.json | ConvertFrom-Json | Select-Object agentBlueprintId

  2. 运行 发布命令 ，按照提示作。

管理中心中的上传失败

症状：

  • 在 Microsoft 365 管理中心上传 manifest.zip 时出错
  • 上传后代理未出现

根本原因：

  • 管理中心中权限不足
  • 无效或过时 manifest.zip

Solution:

  1. 确保具有全局管理员角色。
  2. 再次运行 a365 publish 以生成新的 manifest.zip。
  3. 请尝试按照 上传步骤再次上传。

有关更多帮助，请参阅 将代理加载到 Microsoft 365 管理中心。

  • Last updated on