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