重要
/beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。
エージェント登録 API を使用すると、開発者と管理者は、Microsoft 365 環境内でエージェントをプログラムで登録および管理できます。 API を使用すると、関連付けられたメタデータとエージェント カードを使用してエージェント登録を作成できます。 開発者は、新しい登録の作成、構成の更新、登録の詳細の取得、必要に応じて登録の削除などのエージェント ライフサイクル操作を管理できます。
主な機能
- メタデータとエージェント カード マニフェストを使用してエージェントの登録を作成します。
- エージェント登録の完全な詳細を ID で取得します。
- 既存のエージェント登録の特定のプロパティを更新します。
- 不要になったエージェントの登録を削除します。
シナリオ例
- Contoso の開発者は、CRM システムと統合するカスタム Sales Assistant エージェントを登録したいと考えています。 エージェント登録 API を使用して、エージェントのメタデータを使用して登録を作成し、エージェントにカードを提供し、所有者のアクセス許可を設定できます。
- 管理者は、既存のエージェント登録の詳細を取得して、その構成とエージェントのカードを確認します。
- 開発者は、製品の名前変更後に、既存のエージェント登録の表示名と説明を更新します。
- 管理者は、使用されなくなった古いエージェントの登録を削除します。
API リスト
| 操作 | HTTP メソッド | 説明 |
|---|---|---|
| agentRegistration を作成する | POST /copilot/agentRegistrations |
新しいエージェント登録を作成します。 |
| agentRegistration を取得する | GET /copilot/agentRegistrations/{id} |
特定のエージェント登録の詳細を取得します。 |
| エージェントの更新Registration | PATCH /copilot/agentRegistrations/{id} |
既存のエージェント登録を更新します。 |
| agentRegistration を削除する | DELETE /copilot/agentRegistrations/{id} |
エージェントの登録を削除します。 |