包表示组织目录中的代理或 Microsoft 365 应用。 包管理 API 使 IT 管理员可以跨 Microsoft 365 查看和管理应用和代理。 此 API 提供终结点来列出所有应用和代理，检索有关单个应用或代理的详细信息，包括元数据和详细元素。
重要
访问包管理 API 需要Microsoft Agent 365许可证。
关键功能
- 检索组织内所有代理和应用的清单，可以选择按以下条件进行筛选：
- 主机 (Copilot、Outlook、Teams)
- 上次更新时间
- 应用包中包含的元素类型 (机器人、声明性代理等 ) 。
- 检索特定应用或代理的更多元数据。
- 阻止、取消阻止和重新分配包的所有权。
示例场景
- 组织管理员检索所有 Copilot 代理和Microsoft 365 应用的清单。
- 管理员评审包详细信息，包括可用性和部署状态。
- 管理员评审代理元素详细信息，包括 declarativeAgent 或 customEngineAgent 元素对象。
- 管理员阻止包，以防止其在整个组织中使用。
- 管理员员工离开组织时重新分配包所有权。
API 列表
| 操作 | HTTP 方法 | 说明 |
|---|---|---|
| 列出包 | 获取 /copilot/admin/catalog/packages |
获取组织中的所有应用和代理。 |
| 获取包详细信息 | 获取 /copilot/admin/catalog/packages/{id} |
获取特定应用或代理的详细元数据。 |
| 更新包 | 修补 /copilot/admin/catalog/packages/{id} |
更新包元数据。 |
| 阻止 | 发布 /copilot/admin/catalog/packages/{id}/block |
阻止包以防止其使用。 |
| 取消阻止 | 发布 /copilot/admin/catalog/packages/{id}/unblock |
取消阻止包以允许其使用。 |
| 分配 | 发布 /copilot/admin/catalog/packages/{id}/reassign |
将包的所有权重新分配给其他用户。 |