通过

发布代理到 Microsoft 管理中心

重要

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

使用命令 a365 publish 将你的代理发布到 Microsoft 365 管理中心。 发布代理后，你可以在组织内创建代理实例。 你也可以很容易地管理代理人。

先决条件

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

所需权限和访问权限

  • Microsoft Entra租户 ，担任以下角色之一：

    • 全局管理员
    • 代理ID管理员
    • 代理ID开发者

  • Azure 订阅，带有贡献者或所有者访问权限

必需工具

所需的设置步骤

发布前，请按顺序完成以下步骤：

  1. 创建代理蓝图 ——按照 设置步骤 创建代理蓝图。
  2. 本地测试代理——通过使用代理游乐场（参见本地测试代理）验证代理是否正确工作
  3. 准备配置文件——确保a365.config.jsona365.generated.config.json并保持最新

发布命令

执行以下a365 publish命令：

a365 publish

注释

运行时 a365 publish -h 会显示该命令支持的所有选项和子命令。

这个命令的作用：

  1. 更新清单 ——更新 manifest.json 以及 agenticUserTemplateManifest.json 与你的代理蓝图ID
  2. 自定义提示—— 打开默认编辑器，自定义版本、名称、描述和图标
  3. 创建包 - 将包 manifest.json、图标和代理用户模板整合成 manifest.zip
  4. 配置权限 ——为自定义客户端应用添加所需的API权限
  5. 上传到Titles服务 - 将包发布到Microsoft 365管理中心
  6. 配置产权访问 ——为租户中的所有用户设置访问权限
  7. 配置蓝图认证 ——设置工作负载身份和运行时认证
  8. 授予图谱权限 ——将Microsoft图谱权限应用到代理蓝图

自定义清单

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

=== MANIFEST UPDATED ===
Location: [path]\manifest\manifest.json

=== CUSTOMIZE YOUR AGENT MANIFEST ===
Please customize these fields before publishing:
  Version ('version')
    - Increment for republishing (e.g., 1.0.0 to 1.0.1)
    - REQUIRED: Must be higher than previously published version
  Agent Name ('name.short' and 'name.full')
    - Make it descriptive and user-friendly
    - Currently: [your-agent-name] Blueprint
    - IMPORTANT: 'name.short' must be 30 characters or less
  Descriptions ('description.short' and 'description.full')
    - Short: 1-2 sentences
    - Full: Detailed capabilities
  Developer Info ('developer.name', 'developer.websiteUrl', 'developer.privacyUrl')
    - Should reflect your organization details
  Icons
    - Replace 'color.png' and 'outline.png' with your custom branding

Open manifest in your default editor now? (Y/n):

验证成功发布

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

✅ CLI 发布成功✅manifest用 manifest.json 和 manifest.zip创建的文件夹
✅ 代理出现在 Microsoft 管理中心的注册表中
✅ 存在联合身份凭证

CLI输出

当发布成功时，你应该会看到这些输出消息：

✅ Upload succeeded 带有operationId和titleId
✅ Title access configured for all users
✅ Microsoft Graph permissions granted successfully
✅ Agent blueprint configuration completed successfully
✅ Publish completed successfully!

如果发布失败，请查看错误信息，确保蓝图设置已完成。

可能的错误：

错误 解决的步骤
Agent already exists 输入版本号 manifest.json 并重新发布。
Permissions missing 用命令a365 setup permissions重新运行设置。

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

清单文件

文件夹中会创建 manifest 以下文件，您可以使用 Test-Path 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。

代理出现在管理中心

注释

发布后，代理出现在管理中心和Teams上可能需要 5到10分钟 。 这种延迟是正常的。

您可以通过以下步骤确认代理是否在场：

  1. 转到：https://admin.cloud.microsoft/#/agents/all
  2. 你的代理人会出现在 注册标签 页中
  3. 可用性显示为 所有用户 （绿色勾选表示成功）

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

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

联邦身份的创建

您可以查看联邦身份（FIC）记录是在 Microsoft Entra 中创建的。

  1. 前往 应用注册> 您的代理人蓝图应用
  2. 导航至 “证书与秘密”联邦>凭证
  3. 你看到两个FIC

如果你没有看到这些记录，可以在Azure门户中查看Blueprint应用权限。

另请参阅

后续步骤

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

创建一个代理实例

Troubleshooting

向 Microsoft 管理中心发布代理时常见的问题。

小窍门

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

发布命令失败

症状：

  • 在 a365 publish
  • 代理不会出现在管理中心

根本原因：

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

Solution:

  1. 确认设置完成。

    a365 config display -g
# Check for: agentBlueprintId

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

  3. 当被提示时，定制清单：

    • 更新版本号（重新发布时必须是唯一的）
    • 设置代理姓名（30字符或更少）
    • 更新描述
    • 核实开发者信息

  4. 输入 continue 或 c 自定义后继续。

  • Last updated on