エージェントは、ツールと知識を使用してユーザーに代わってアクションを実行し、関連するコンテキスト情報を収集します。 これらのツールとナレッジ ソースは、多くの場合、Microsoft Dataverse、Microsoft SharePoint、その他の API などの外部システムに格納されます。 これらのリソースに安全にアクセスするには、エージェントが認証して接続を確立する必要があります。 エージェントは、シナリオに応じて、エージェント作成者認証またはユーザー認証を使用できます。
Microsoft Copilot Studio では、 接続 を使用して、ツールと知識のために認証されたサービスに安全にアクセスします。 Microsoft Dataverse、Microsoft SharePoint、外部 API など、さまざまなデータ ソースへの接続を作成できます。
エージェント接続の表示と管理
Copilot Studio では、[ 接続設定] ページでエージェントによって使用される接続を表示および構成できます。
[ 接続設定 ] ページでは、エージェントによって使用される接続を構成および管理できます。 既存の接続を表示したり、新しい接続を作成したり、必要に応じて編集または切断したりできます。
[接続設定] ページで接続を表示する
Copilot Studio で [エージェント] を選択し、確認するエージェントを選択して、エージェント ページに移動します。
エージェントの概要ページが開きます。
[ 設定] を 選択して、エージェントの [設定] ページを 開きます。
左側のナビゲーション ウィンドウで、[ 接続設定] を選択します。
エージェントに関連付けられているすべての接続を含む一覧がテーブルに表示されます。 接続ごとに、接続、接続の状態、接続が最後に更新された日付を使用して、その名前、ツール、知識を表示できます。
接続を絞り込む
エージェントに多数の接続がある場合は、フィルタリングして、限定されたビューを取得し、処理する接続を見つけることができます。 さまざまなフィルターを適用して、アクティブ化/非アクティブ化、接続済み/未接続、非アクティブ化、有効期限切れ、接続エラーなどの状態に基づいて接続を表示できます。
接続を選択または作成する
一覧の接続エントリの [状態] で、[ 管理 ] を選択して[ 接続の作成または選択 ] ウィンドウを開きます。
接続構成を開きます。 一覧から既存の接続を選択するか、[ 新しい接続の作成 ] を選択して新しい接続を作成します。
[ 新しい接続の作成] を選択すると、接続のセットアップ ウィンドウが開きます。 必要に応じて、サービスにサインインするか、接続のセットアップを完了するための追加情報を指定するように求められる場合があります。
完了したら、[ 送信] を選択して変更を保存します。
これで接続がエージェントに関連付けられるようになり、エージェントは接続を使用してツールと知識にアクセスできます。
接続パラメーターの構成
一覧の [接続エントリの 管理 ] で、[ 詳細を表示 ] を選択して接続の詳細を表示します。
次の 2 つのタブに情報が表示されます。
- 詳細: 接続名、説明、状態、作成の詳細が表示されます。
- 接続パラメーター: 認証の詳細、API キー、その他の必要な情報などの接続パラメーターを表示し、詳細を構成できます。
On-Behalf-Of (OBO) 認証の接続パラメーターを共有する
シングル Sign-On (SSO) をサポートする一部の接続では、オンBehalf-Of (OBO) 認証を使用するように接続を設定できます。 OBO フローでは、ユーザーは、ユーザーの代わりにサービスで共有接続パラメーターを使用するようにエージェントを委任します。 これは、エージェントがユーザー固有のアクセス許可を必要とするリソースにアクセスする必要がある場合や、ユーザーの ID のコンテキストでアクションを実行する必要がある場合に便利です。
OBO のパラメーター共有を有効にする
リスト内の接続エントリの [接続パラメーター ] で、ユーザーが特定の接続パラメーターの共有を承認することを許可できます。
[ 接続パラメーター] で、[ パラメーターを共有するアクセス許可を許可する] をオンにします。
ユーザーが共有できるようにするパラメーターのチェック ボックスをオンにします。
エージェントが OBO 認証を使用するときに、これらのパラメーターのアクセス許可を付与するように求められます。
OBO 認証のユーザー エクスペリエンス
エージェントが OBO 認証を使用する場合、ユーザーはエージェントが接続パラメーターを使用するためのアクセス許可を付与するように求められます。 ユーザーは、このアクセス許可を許可または拒否することを選択できます。 ユーザーが許可した場合、エージェントはリソースにアクセスし、ユーザーに代わってアクションを実行できます。 エージェントは、共有接続パラメーターを使用して透過的にサービスに接続します。