パッケージは、organization カタログ内のエージェントを表します。 パッケージ管理 API を使用すると、IT 管理者はorganization全体のエージェントを表示および管理できます。 この API は、すべてのエージェントを一覧表示し、メタデータや詳細要素など、個々のエージェントに関する詳細情報を取得するためのエンドポイントを提供します。
重要
パッケージ管理 API にアクセスするには、Microsoft Agent 365 ライセンスが必要です。
主な機能
- organization内のすべてのエージェントのインベントリを取得し、オプションで次のようにフィルタリングします。
- ホスト (Copilot、Outlook、Teams)
- プラットフォーム (Copilot Studio、Microsoft 365 Copilot エージェント ビルダー)
- 最終更新時刻
- エージェント パッケージに含まれる要素の種類 (ボット、宣言型エージェントなど)。
- リクエストステータスまたはリクエストタイプを使用して、organization内のユーザーがリクエストしたエージェントを確認します。
- 特定のエージェントのメタデータをさらに取得します。
- パッケージの所有権をブロック、ブロック解除、再割り当てします。
シナリオ例
- 組織管理者は、すべてのエージェントのインベントリを取得します。
- 管理は、可用性やデプロイの状態など、パッケージの詳細を確認します。
- 管理は、ユーザーが要求したエージェントを確認して、保留中の要求をトリアージできるようにします。
- 管理は、declarativeAgent または customEngineAgent 要素オブジェクトを含む、エージェント要素の詳細を確認します。
- 管理はパッケージをブロックして、organization全体で使用できないようにします。
- 管理は、従業員が organization を辞めたときにパッケージの所有権を再割り当てします。
API リスト
| 操作 | HTTP メソッド | 説明 |
|---|---|---|
| リスト パッケージ | GET /copilot/admin/catalog/packages |
Get all agents in the 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 |
パッケージの所有権を別のユーザーに再割り当てします。 |
| エージェント要求を一覧表示する | GET /copilot/admin/catalog/packages |
Get all active agent requests in the organization. |
| エージェント要求の詳細の取得 | GET /copilot/admin/catalog/packages/{id} |
特定のエージェント要求の詳細なメタデータを取得します。 |