エージェント用の ツール を作成する際には、ユーザー認証を要求したり、エージェントがユーザーを代表して使用できる認証情報のセットを提供したりできます。
- ツールに関連付けられているサービスへのアクセスが暗黙的な場合、またはリスクの低いユース ケースの場合は、[ エージェント作成者認証 ] を選択します。 たとえば、この認証設定を使用して、特定の郵便番号のサポート チームの電話番号を検索します。 別のユース ケースとして、天気 API を使用して現在の予報を取得することが考えられます。
- ユーザー コミュニティ内の特定のグループまたは個人へのデータ アクセスを制限する必要がある場合は、ユーザー認証 を選択します。 たとえばエージェントが、ユーザーのみがアクセスできるデータを取得したり、ユーザーに代わって作業を実行したりする場合は、この認証設定を使用します。
会話中にサービスに接続する
エージェントがユーザー認証を使うツールを呼び出すと、Copilot Studioはユーザーがサービスに対して有効な接続を持っているかを確認します。 有効な接続があれば、エージェントはそれを利用します。 そうでなければ、エージェントはツールが必要とするサービスの接続カードを表示します。
接続を作成するには、ユーザーが「 Connect 」を選択し、必要なサインインや同意の手順を別のウィンドウで完了します。 接続リクエストは、現在のツールコールに必要なサービスのためのものです。
接続に成功するとウィンドウが閉じ、エージェントは自動的にツールを再試行します。 Copilot Studioが接続を確認できず、ツール呼び出しを続けられない場合、カードには「接続に失敗しました」と「再試行」と表示されます。 ユーザーは「 もう一度試す 」を選択して接続状態を更新し、ツールを再試すことができます。
標準ハーネスで動作するエージェント用のカスタムチャットキャンバスをホストする場合は、接続ポップアップと継続処理を実装してください。 カスタム キャンバスでのサポート接続設定について詳しく学びましょう。
データ アクセスとアクセス許可の管理
Copilot Studio には資格情報は格納されません。 エージェントはアクセストークンが期限切れまたはサービスによって取り消された際に、ユーザーに再接続を促します。 ユーザーは接続管理ページにアクセスして、許可の再承認や取り消しも可能です。
サポート対象のチャネル
以下の表は、ツールのユーザー認証をサポートする チャネル を示しています。
| Channel | Supported |
|---|---|
| Azure Bot Service チャネル | サポートしていません |
| カスタム Web サイト | Supported |
| デモ Web サイト | サポートしていません |
| フェイスブック | サポートしていません |
| Microsoft Teams1 | Supported |
| モバイル アプリ | サポートしていません |
| 顧客サービス用のオムニチャネル2 | Supported |
| SharePoint1 | Supported |
1 Teamsチャネルもご利用の場合は、「Teams内のエージェント向けにMicrosoft Entra IDでシングルサインオンを設定する」の指示に従ってください。 そうでなければ、Teams のユーザーでは、認証は必ず失敗します。
2 ライブ チャット チャネルのみがサポートされています。 詳細は「Dynamics 365 Customer Serviceへのハンドオフ構成」をご覧ください。