エージェント ビルダーを使用して宣言型エージェントにナレッジ ソースを追加する

Copilot Studio エージェント ビルダー エクスペリエンスは、宣言型エージェントをよりインテリジェントでコンテキストに対応させるために、ナレッジ ソースを統合するためのシンプルなインターフェイスを提供します。 これらのナレッジ ソースは、エージェントをエンタープライズ データ、パブリック コンテンツ、およびユーザー固有の情報に基づき、より正確で関連性の高い、パーソナライズされた応答を提供できるようにします。

この記事では、サポートされているナレッジ ソースと、エージェント ビルダーでそれらを構成する手順について説明します。 エージェント ビルダーの使用方法の一般的な情報については、「Copilot Studio エージェント ビルダーを使用してエージェントをビルドする」を参照してください。

サポートされているナレッジ ソースとライセンス要件の詳細については、「 ナレッジ ソース」を参照してください。

エージェント ビルダーでナレッジ ソースを追加する

エージェントにナレッジ ソースを追加するには:

1. Microsoft 365 Copilotで、[エージェントの作成] を選択し、[構成] タブに移動します。
2. [ ナレッジ ] セクションで、次のいずれかの方法を使用してナレッジ ソースを追加します。
   • 検索バー - SharePoint アイテムを検索するキーワードを入力します。
   • URL を入力 する - パブリック Web サイトまたは SharePoint リンクを追加します (クエリ パラメーターを指定せずに、2 レベルの深さである必要があります)。
   • ピッカー - ファイル ピッカー UI を使用して、SharePoint ファイルまたはフォルダーを参照して選択します。
3. 含める項目を選択します。 次の情報を追加できます。
   • 最大 4 つのパブリック Web サイト URL。
   • SharePoint ファイル、フォルダー、またはサイト。
   • 最大 5 つの Teams チャット URL。
   • デバイスからアップロードされた埋め込みファイル。
   • Microsoft 365 Copilot コネクタ (organizationの管理者によって有効になっている場合)。

公開された Web サイト

特定のパブリック Web サイトをエージェントのナレッジ ソースとして追加して、エージェントのコンテキストを認識させることができます。 Web サイトをナレッジ ソースとして参照する場合、次の制限が適用されます。

• パブリック Web サイトの URL は 2 つのレベルのみである必要があります。たとえば、 https://example.org/a/b/c は 2 つ以上のレベルであるため、無効な URL です。
• URL にクエリ パラメーターを含めることはできません。たとえば、 https://example.org?test=1 が無効です。
• 最大 4 つの URL を追加できます。

任意の Web データをナレッジとして使用するようにエージェントを構成するには、[ 構成 ] タブの [ ナレッジ ] ボックスをクリックし、[ すべての Web サイト] を選択します。

SharePoint コンテンツ

特定の SharePoint サイト、ファイル、フォルダーをエージェントのナレッジ ソースとして参照できます。 SharePoint からソースを参照する場合は、次の制限事項を考慮してください。

• エージェントごとに合計 100 個の SharePoint ファイルを選択できます。
• SharePoint に既にアップロードされているファイルには、既存のアクセス許可と 秘密度ラベルがある可能性があります。これは、エージェントが応答を生成するときに考慮されます。

SharePoint ナレッジ ファイルのサイズ制限については、「 ファイル サイズの制限」を参照してください。

SharePoint サイト、フォルダー、またはファイルの URL を入力する

contoso.sharepoint.com/sites/policiesなどの SharePoint サイト、フォルダー、またはファイルの URL を入力できます。 エージェントは URL とサブパスを検索します。 たとえば、 contoso.sharepoint.com/sites などの URL には、 contoso.sharepoint.com/sites/policies などのサブパスも含まれます。 エージェントは関連情報を使用して、適切な応答を提供します。

SharePoint URL を指定したら、 Enter キーを押してナレッジ ソースとして追加します。

SharePoint ファイル ピッカー

[ ナレッジ ] セクションでクラウド アイコンを選択して、SharePoint ファイル ピッカーからファイルまたはフォルダーを選択することもできます。 ピッカーの左側のウィンドウには、最近アクセスした SharePoint サイトが表示されます。 その他の SharePoint サイトを表示するには、[その他の場所] を選択します。 最近サイトを作成した場合は、数分後に表示されます。

サイトを選択したら、複数のファイルとフォルダーを選択できます。 これにより、SharePoint ファイルまたはフォルダーがエージェントのナレッジ ソースに追加されます。 同じサイトに複数のフォルダーが含まれている場合は、フォルダー名の横にあるボタンを選択して他のフォルダーを表示します。

ピッカーを使用して SharePoint にファイルをアップロードすることもできます。 ファイルは、アップロードが完了し、エージェント ビルダーで使用できる状態になったら、同じフォルダーに表示されます。

ファイルの準備

新しいファイルが SharePoint にアップロードされると、エージェントが応答に含められるようになるまで最大で数分かかる場合があります。 ソースの準備ができていない場合でも、テスト ウィンドウでエージェントをテストできます。 ただし、準備ができるまで、応答には、新しくアップロードされたファイルからの情報は含まれません。

ファイルの準備状況を確認するには、[構成] タブの [ナレッジ] セクションを参照します。ファイルの横に "準備中" という単語が表示されます。 SharePoint にアップロードされた基になるファイルの名前が変更または削除されると、エージェントは変更を取得します。 [ ナレッジ ] セクションの上部にある [再読み込み] ボタンを選択して、状態を手動で再読み込みすることもできます。

Teams のチャット メッセージ

Teams チャネル、グループ、会議チャット メッセージでエージェントを設定できます。 Teams チャット メッセージを追加するには、[ 構成 ] タブの [ ナレッジ ] セクションで検索バーをクリックします。 [ チャット ] タブには、ナレッジとして追加する特定のチャットを含めることができます。

エージェントの知識を特定のチャットに限定したくない場合は、[ Teams チャット] で [ グループ チャット、チャネル、会議から Teams チャット ] を選択して、アクセスできるすべてのチャット メッセージをナレッジとして使用します。

Outlook メール

Outlook メールでエージェントを起動できます。 ナレッジ ソースとしてメールを追加するには、[ 構成 ] タブの [ ナレッジ ] セクションで検索バーをクリックし、[ マイ メール] を選択します。

埋め込みファイルコンテンツ

エージェントがナレッジとして使用できるように、デバイスからファイルを直接アップロードできます。 アップロードするファイルは、エージェントの埋め込みコンテンツになります。 ファイルをアップロードするには、デバイスから [説明 ] タブまたは [ 構成 ] タブにドラッグ アンド ドロップします。[ 構成 ] タブの矢印アイコンを選択して、デバイスからファイルをアップロードすることもできます。 デバイスから個々のファイルをアップロードできますが、ファイル フォルダーはアップロードできません。

ナレッジ ソースとして最大 20 個のファイルを追加できます。

埋め込みファイルは、[ 構成 ] タブの [ アップロードされたファイル] に表示されます。 ファイルのアップロードには数分かかる場合があり、完全にアップロードされるまで灰色で表示されます。 アップロード時間は、ファイルサイズとインターネット速度によって異なる場合があります。 埋め込みファイルのサイズ制限については、「 ファイル サイズの制限」を参照してください。

アップロードしたファイルを削除するには、ファイルの横にある [X] を選択し、[ 削除] を選択します。

次のいずれかの特性を持つファイルはサポートされていません。

• 二重キー暗号化。
• ユーザー定義のアクセス許可を持つ秘密度ラベル。 ユーザー定義のアクセス許可を持つファイルをアップロードすると、エージェントの作成は失敗します。
• 抽出権限のアクセス許可が無効になっている秘密度ラベル。 これらのファイルをアップロードすると、エージェントの作成は失敗します。 エージェント ユーザーが埋め込みファイルに対する抽出権限を持っていない場合、ユーザーはエージェントにアクセスできません。
• 暗号化が有効になっている別のテナントのファイル。
• パスワード保護。

詳細については、「 サポートされていない秘密度ラベルのシナリオ」を参照してください。

埋め込みファイル コンテンツのインデックス作成と取得の詳細については、「 コンテンツの取得を最適化する」を参照してください。

エージェント埋め込みコンテンツの秘密度ラベル

アップロードされたファイルのいずれかが秘密度ラベルを持っている場合、またはテナントに既定の秘密度ラベルポリシーがある場合は、秘密 度ラベル がエージェントの埋め込みコンテンツに適用されます。 エージェントの埋め込みコンテンツに適用される秘密度ラベルは、エージェントがorganizationの Microsoft Purview ポリシーに準拠していることを確認します。

埋め込みコンテンツに適用される秘密度ラベルは、次のラベルの優先順位が高くなります。

• 埋め込みファイルに適用される最も優先度の高い秘密度ラベル。
• organizationによって適用される既定の秘密度ラベル ポリシー。

たとえば、General ラベルを持つファイルと機密ラベルを持つファイルがエージェントに埋め込まれている場合、機密機密ラベルが埋め込まれたコンテンツに適用されます。

埋め込みコンテンツに適用された秘密度ラベルに対する適切なアクセス許可を抽出したユーザーのみが、エージェントにアクセスして使用できます。 ラベルは、エージェント ストアの一覧には表示されません。 埋め込みコンテンツに対する適切なアクセス許可を抽出していないユーザーは、エージェントとエージェントの説明を表示できますが、エージェントをインストールして使用することはできません。

秘密度ラベルは、エージェントの応答にも適用されます。 このラベルは、次のラベルの優先順位が高くなります。

• 埋め込みコンテンツの秘密度ラベル
• SharePoint ファイルや OneDrive ファイルなど、他のエージェントのナレッジ ソースの秘密度ラベル。

現時点では、エージェント ビルダーはエージェントに秘密度ラベルを設定できません。

サポートされていない秘密度ラベルのシナリオ

次の表に、現在サポートされていない秘密度ラベルのシナリオを示し、ビルダーがファイルをエージェントにアップロードするときの動作を示し、ビルダーに推奨されるアクションを示します。

埋め込みファイルを使用したエージェントの共有

埋め込みファイルでエージェントを共有する場合、ファイルはエージェントを取得したときにのみユーザーと共有されます。 エージェントを取得した後、ユーザーはそれらのナレッジ ソースに基づいて Copilot から応答を取得できます。 埋め込みファイルをナレッジとしてエージェントを共有するには、次のオプションがあります。

• 組織内のすべてのユーザー
• organization内の特定のユーザー
• あなただけです

エージェントを共有するときに、埋め込みコンテンツに秘密度ラベルが設定されている場合は、[共有] 画面に秘密度ラベルが表示されます。

ファイル サイズの制限を超えている

次の表に、エージェントにナレッジとして追加できるファイルの種類と、各ファイルの種類のサイズ制限を示します。

Copilot コネクタ

Copilot コネクタを使用すると、エージェントは、顧客アカウント、インシデント チケット、コード リポジトリ、ナレッジ記事などの外部システムからナレッジにアクセスして適用できます。 エージェント ビルダーを使用すると、ワークスペースのエンタープライズ データをエージェントに直接統合し、ドメイン固有の知識を活用できます。

Copilot コネクタの詳細については、「Microsoft 365 Copilot コネクタの概要」を参照してください。

スコープ Copilot コネクタ のデータ ソース

エージェントの応答の正確性と関連性を高めるために、エージェントは広範な組織データだけでなく、特定の範囲のデータにも基にすることができます。 エージェント内のコネクタ データを特定の属性にスコープを設定するには:

1. [ 構成 ] タブの [ その他のデータ ソースの選択] で、データ ソースのコネクタを選択します。
2. そのコネクタのカードで、シナリオに関連する接続を追加します。
3. 矢印を選択して [ナレッジ ] セクションに戻ります。
4. 追加したコネクタを展開し、ナレッジのスコープを設定する属性 (プロジェクト、スペース、フォルダーなど) を選択し、属性名を検索または入力します。
5. 一覧から属性を選択して追加します。
6. これで、エージェントのナレッジのスコープがスコープ属性に関連付けられたデータに限定されるようになりました。

たとえば、 Azure DevOps Work Items コネクタを使用する場合、エージェントのスコープを特定の領域パスに設定して、エージェントが最も関連する作業項目のみに焦点を当てられるようにすることができます。

Azure DevOps 作業項目領域パスのスコープを設定するには:

1. [ 他のデータ ソースの選択] で、[ Azure DevOps 作業項目] を選択します。
2. タスクに関連する接続の横にある [ 追加] ボタンを選択します。
3. 矢印を選択して [ ナレッジ ] セクションに戻ります。
4. [ エリア パスの選択] を選択し、エリア パス 名を検索または入力します。
5. 領域パスを選択して追加します。

次の表に、スコープをサポートする Copilot コネクタと、データのスコープを設定するために使用できる属性を示します。

利用可能な Copilot コネクタの詳細については、「 コネクタ ギャラリー」を参照してください。

一般的な知識よりもナレッジ ソースに優先順位を付ける

SharePoint コンテンツや埋め込みファイルなど、ナレッジ ベースの検索を必要とするクエリに応答するときに、提供するナレッジ ソースに優先順位を付けるためにエージェントを構成できます。 ナレッジ ベースの検索は、特定の情報を検索するためのユーザー要求です。例えば：

• 現在の CEO は誰ですか?
• 次のビジネス会議はいつですか?
• 機能に関連する最新の更新プログラムは何ですか?

一部のユーザー要求では、ナレッジ ベースの検索は必要ありません。エージェントは、一般的な AI の知識に基づいて応答できます。 例:

• このフレーズをスペイン語に翻訳します。"こんにちは、お過ごしですか?
• 1+1 とは

この機能を有効にすると、エージェントは、一般的な知識に基づいて検索する必要はなく、検索ベースの質問にのみナレッジ ソースを使用する単純な質問に回答します。 エージェントが提供するナレッジ ソースに関連情報が見つからない場合は、情報が見つからないことを示すフォールバック メッセージで応答します。

ナレッジ ソースに優先順位を付けるためにエージェントを構成するには、[ 構成 ] タブで、[ 一般的なエージェントの知識よりも追加したナレッジ ソースの優先順位を付ける] の横にあるトグルを選択します。

関連コンテンツ

• Copilot Studio エージェント ビルダーの概要
• テンプレートからエージェントをビルドする