将智能体发布到 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. 更新清单 - 将 manifest.json 替换为您智能体蓝图的 ID。
  2. 创建包 - 将 manifest.json 和图标打包到 manifest.zip 中。
  3. 打印说明 - 显示通过 Microsoft 365 管理中心上传的分步说明。

备注

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

上传至管理中心

a365 publish 完成后，请按照打印的说明上传您的智能体：

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

有关详细信息，请参阅 将智能体上传至 Microsoft 365 管理中心 。

验证发布是否成功

使用以下检查清单来验证智能体是否已成功发布：

✅ CLI 发布成功
✅ manifest 已创建包含 manifest.json 和 manifest.zip 的 文件夹
✅ 智能体出现在 Microsoft 管理中心

CLI 输出

当发布命令成功时，您将看到以下输出消息：

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

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

可能的错误：

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

发布失败时，请按照 这些步骤 操作。

清单文件

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

# 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）
发布者 组织名称
可用性 可用/所有用户

另请参阅

后续步骤

发布智能体后，请创建一个实例，以便在您的租户中进行配置和使用。

创建智能体实例

故障排除

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

提示

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

发布命令失败

症状：

  • 在 期间出错a365 publish
  • manifest.zip 未创建

根本原因：

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

解决方案：

  1. 请确认设置是否已完成。

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

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

在管理中心上传失败

症状：

  • 在 Microsoft 365 管理中心上传 manifest.zip 时出现错误
  • 上传后智能体未显示

根本原因：

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

解决方案：

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

如需更多帮助，请参阅 将智能体上传到 Microsoft 365 管理中心。

  • Last updated on