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