パッケージは、organization カタログ内のエージェントまたは Microsoft 365 アプリを表します。 パッケージ管理 API を使用すると、IT 管理者は Microsoft 365 全体のアプリとエージェントを表示および管理できます。 この API は、すべてのアプリとエージェントを一覧表示し、メタデータや詳細な要素を含む個々のアプリまたはエージェントに関する詳細情報を取得するエンドポイントを提供します。
重要
Package Management API へのアクセスには、Microsoft Agent 365 ライセンスが必要です。
主な機能
- organization内のすべてのエージェントとアプリのインベントリを取得し、必要に応じて次のようにフィルター処理します。
- ホスト (Copilot、Outlook、Teams)
- 最終更新日時
- アプリ パッケージに含まれる要素型 (ボット、宣言型エージェントなど)。
- 特定のアプリまたはエージェントのメタデータをさらに取得します。
- パッケージの所有権をブロック、ブロック解除、再割り当てする。
シナリオ例
- 組織管理者は、すべての Copilot エージェントと Microsoft 365 アプリのインベントリを取得します。
- 管理は、可用性やデプロイの状態など、パッケージの詳細を確認します。
- 管理は、宣言型Agent や customEngineAgent 要素オブジェクトなど、エージェント要素の詳細を確認します。
- 管理は、パッケージをブロックして、organization全体でパッケージが使用されないようにします。
- 管理は、従業員がorganizationを離れるとパッケージの所有権を再割り当てします。
API リスト
| 操作 | HTTP メソッド | 説明 |
|---|---|---|
| パッケージの一覧表示 | GET /copilot/admin/catalog/packages |
organizationのすべてのアプリとエージェントを取得します。 |
| パッケージの詳細を取得する | GET /copilot/admin/catalog/packages/{id} |
特定のアプリまたはエージェントの詳細なメタデータを取得します。 |
| 更新プログラム パッケージ | PATCH /copilot/admin/catalog/packages/{id} |
パッケージ メタデータを更新します。 |
| Block | POST /copilot/admin/catalog/packages/{id}/block |
パッケージの使用を防ぐために、パッケージをブロックします。 |
| ブロックを解除 | POST /copilot/admin/catalog/packages/{id}/unblock |
パッケージの使用を許可するブロックを解除します。 |
| 割り当て | POST /copilot/admin/catalog/packages/{id}/reassign |
パッケージの所有権を別のユーザーに再割り当てします。 |