宣言型エージェントにナレッジ ソースを追加する

コード インタープリターやイメージ ジェネレーター、ナレッジ ソースなどの機能を追加して、エージェントの知識を強化およびカスタマイズすることで、宣言型エージェントのユーザー エクスペリエンスを向上させることができます。 マニフェスト リファレンスの capabilities オブジェクトと、Copilot Studio エージェント ビルダーの [ナレッジ] セクションには、ユーザーの機能のロックを解除するためのオプションがいくつか用意されています。 この記事では、エージェントに追加できるナレッジ ソースについて説明します。

次の表に、エージェント ビルダーまたは Microsoft 365 Agents Toolkit (Teams Toolkit の進化) を使用して構成できる機能とナレッジ ソースを示し、ユーザーがその機能またはナレッジ ソースを持つエージェントにアクセスするために、Microsoft 365 Copilotライセンスまたは従量制課金の使用を必要とするかどうかを示します。

機能またはナレッジ ソース	エージェント ビルダー	Agents Toolkit	ライセンスまたは従量制課金制の使用が必要ですか?
コード インタープリター	✅	✅	不要
画像ジェネレーター	✅	✅	不要
Copilot コネクタ	✅	✅	はい
SharePoint	✅	✅	はい
OneDrive	❌	✅	はい
埋め込みファイルコンテンツ	✅	❌	はい
Web 検索	✅	✅	不要
スコープ付き Web 検索	✅	✅	不要
Dataverse	❌	✅*	はい
電子メール	✅	✅*	はい (ライセンスのみ)
連絡先	❌	✅	はい (ライセンスのみ)
Teams メッセージ	✅	✅*	はい (ライセンスのみ)

*知識をスコープするためのオプションが利用可能です。

Copilot コネクタ

Microsoft 365 Copilot コネクタ (旧称 Microsoft Graph コネクタ) を使用すると、接地情報として組織データをエージェントに追加できます。 Copilot コネクタを使用して基幹業務データを Microsoft Graph に取り込むことができます。また、Copilot は、ユーザー プロンプトへの応答で、データを根拠情報として推論できます。 詳細については、「Microsoft 365 Copilot コネクタの概要」を参照してください。

エージェント ツールキットでエージェント マニフェストに知識として Copilot コネクタを追加する方法の詳細については、「 Copilot コネクタ オブジェクト」を参照してください。

エージェント ビルダーでエージェントに Copilot コネクタを追加する方法Copilot Studio詳細については、「Copilot コネクタ」を参照してください。

SharePoint および OneDrive

OneDrive と SharePoint のコンテンツをナレッジとして使用するようにエージェントを構成すると、Copilot は、ユーザーがアクセスできる SharePoint ファイル、フォルダー、またはサイトを検索して、情報を接地します。

エージェント ツールキットでエージェント マニフェストに OneDrive と SharePoint の知識を追加する方法の詳細については、「 OneDrive と SharePoint オブジェクト」を参照してください。

エージェント ビルダーで SharePoint ナレッジをエージェントに追加する方法Copilot Studio詳細については、「ナレッジ ソースを追加する」を参照してください。

Web およびスコープ付き Web 検索

Web 検索を使用すると、エージェントはBingの検索インデックスを使用してユーザー プロンプトに応答できます。 エージェントで Web 検索を有効にした場合は、応答で任意の Web データを返すことができます。 また、Web 検索の範囲を最大 4 つのパブリック Web サイトに設定することもできます。

Web とスコープ付き Web 検索を追加する

エージェント ツールキットと Visual Studio Code を使用してエージェントを作成する場合は、Web 検索を有効にするために、マニフェスト ファイルの capabilities プロパティにWebSearch値を追加します。 Web 検索のスコープを特定のサイトに設定する場合は、次の例に示すように、 sites プロパティを追加し、最大 4 つの URL を指定します。

注:

スコープ付き Web 検索をエージェントに追加するには、宣言型エージェント マニフェスト スキーマの バージョン 1.2 以降を使用している必要があります。

{
  "capabilities": [
    {
      "name": "WebSearch",
      "sites": [
        {
          "url": "cnn.com"
        }
      ]
    }
  ]
}

エージェント ビルダー Copilot Studio使用してエージェントを作成する場合は、[構成] タブの [ナレッジ] で、参照する Web サイト URL を一覧表示します。

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

エージェント ビルダー Copilot Studio使用してエージェントをビルドする場合は、デバイスまたはクラウドからファイルを直接アップロードして、エージェントがナレッジとして使用するコンテンツを埋め込むことができます。 埋め込みファイルコンテンツは SharePoint Embedded に格納されます。 これらのファイルは、テナント内の OneDrive と SharePoint の容量に対してカウントされます。

注:

ファイルアップロード機能は、従量制課金が有効になっているユーザー、またはMicrosoft 365 Copilotライセンスを持つユーザーが使用できます。

埋め込みファイルの詳細については、「 エージェント ビルダーでの埋め込みファイルコンテンツ」を参照してください。

Dataverse

Dataverse ナレッジを使用すると、エージェントは、CRM データまたは Microsoft Dataverse のテーブルからのデータに関するユーザー クエリに自然言語で応答できます。 Dataverse インスタンスをナレッジ ソースとして追加し、シノニムと用語集を追加して、システムがテーブル内のカスタマイズされたデータをより適切に解釈できるようにすることができます。 詳細については、「 Dataverse ナレッジ ソースの追加」を参照してください。

注:

Dataverse ナレッジは現在、Copilot Studio エージェント ビルダーでは使用できません。

Dataverse ナレッジを追加する

エージェント ツールキットと Visual Studio Code を使用してエージェントを作成する場合、Dataverse ナレッジを有効にするには、次の例に示すように、エージェント マニフェスト ファイルの capabilities プロパティにDataverse値を追加します。

注:

宣言型エージェント マニフェスト スキーマの バージョン 1.3 以降を使用して、 Dataverse ナレッジを追加する必要があります。

{
  "capabilities": [
    {
      "name": "Dataverse",
      "knowledge_sources": [
        {
          "host_name": "organization.crm.dynamics.com",
          "skill": "DVCopilotSkillName",
          "tables": [
            {
              "table_name": "account"
            },
            {
              "table_name": "opportunity"
            }
          ]
        }
      ]
    }
  ]
}

電子メール

Emailナレッジを使用すると、エージェントのスコープを個人用メールボックスまたは共有メールボックス、および必要に応じて特定のメールボックス フォルダーに限定できます。

メールのナレッジ ソースを追加する

エージェント ビルダー Copilot Studio使用してエージェントを作成する場合は、[ナレッジ] セクションの [構成] タブで [マイ メール] を選択します。

注:

エージェント ビルダーを使用する場合、現在、特定のフォルダーまたは共有メールボックスにメールのスコープを設定することはできません。

エージェント ツールキットと Visual Studio Code を使用してエージェントを作成する場合は、メールナレッジを追加するために、次の例に示すように、エージェント マニフェスト ファイルの capabilities プロパティにEmail値を追加します。 複数のメールボックス フォルダーと 1 つの共有フォルダーのみを参照できます。

注:

宣言型エージェント マニフェスト スキーマの バージョン 1.3 以降を使用して、 Email ナレッジを追加する必要があります。

{
  "capabilities": [
    {
      "name": "Email",
      "shared_mailbox": "sample@service.microsoft.com",
      "folders": [
        {
          "folder_id": "inbox"
        }
      ]
    }
  ]
}

[folder_id] フィールドでは、既知のフォルダー名またはフォルダー ID を参照できます。 既知のフォルダー名の一覧については、「 mailFolder リソースの種類」を参照してください。 フォルダー ID の一覧を取得するには、Graph エクスプローラーで次のクエリを使用します。

https://graph.microsoft.com/v1.0/me/mailFolders

[shared_mailbox] フィールドで、共有メールボックスの SMTP アドレスを使用します。

共有メールボックスとフォルダーの両方を参照する場合、エージェントは共有メールボックス内のフォルダーに応答をスコープします。 フォルダーのみを参照する場合、エージェントは個人用メールボックス内のフォルダーの内容に応答をスコープします。

共有メールボックスまたはフォルダーを参照しない場合、エージェント検索の対象範囲はフォルダーまたはメールボックスではなく、ユーザーのクエリに基づいてすべてのメール コンテンツの結果が返されます。

連絡先

Peopleナレッジを使用すると、エージェントの範囲を指定して、organization内の個人に関する質問に回答できます。 たとえば、エージェントは、"操作方法連絡先<person>" や "<person> の直接レポートの一覧表示" などのクエリに応答できます。 このナレッジ ソースのスコープは設定されていません。

注:

Peopleナレッジは、現在、エージェント ビルダー Copilot Studio使用できません。

ユーザーのナレッジ ソースを追加する

エージェント ツールキットと Visual Studio Code を使用してエージェントを作成する場合、ユーザーの知識を有効にするには、次の例に示すように、エージェント マニフェスト ファイルの capabilities プロパティにPeople値を追加します。

注:

宣言型エージェント マニフェスト スキーマの バージョン 1.3 以降を使用して、 People ナレッジ ソースを追加する必要があります。

{
  "capabilities": [
    {
      "name":"People"
    }
  ]
}

Teams メッセージ

Teams チャネル、会議チャット、グループ チャット、1:1 チャットをナレッジ ソースとして使用するようにエージェントを構成できます。 チャネル、グループ、1:1、または会議チャットへの最大 5 つのリンクを指定して Copilot 検索をスコープにすることも、エージェントがチャネル、会議、個人チャットやグループ チャットなど、すべてのユーザーの Teams コンテンツをナレッジ ソースとして使用できるようにすることもできます。

エージェントは、Teams メッセージで共有されているファイルへのリンクを返すことができますが、エージェントも有効になっていない限り、Teams チャネルに格納されているファイルへのリンク OneDriveAndSharePoint を返すことはできません。 Copilot 用に SharePoint コンテンツを最適化する方法については、「 SharePoint コンテンツ取得の最適化」を参照してください。

Teams メッセージのナレッジ ソースを追加する

エージェント ビルダー Copilot Studio使用してエージェントを作成する場合は、[構成] タブの [ナレッジ] セクションで検索バーを選択し、グループ、チャネル、会議から [マイ Teams チャット] を選択します。エージェントの範囲を特定のチャネル、会議、またはグループ チャットに限定するには、[チャット] タブで、ナレッジとして追加するチャットを選択します。

エージェント ツールキットと Visual Studio Code を使用してエージェントを作成する場合は、Teams メッセージの知識を有効にするには、マニフェスト リファレンスの capabilities プロパティにTeamsMessage値を追加します。 Teams の知識を最大 5 つの Teams リソースにスコープを設定する場合は、次の例に示すように、 urls プロパティへのリンクを追加します。

注:

宣言型エージェント マニフェスト スキーマの バージョン 1.3 以降を使用して、 TeamsMessage ナレッジ ソースを追加する必要があります。

{
  "capabilities": [
    {
      "name": "TeamsMessages",
      "urls": []
    }
  ]
}

チャネルまたは会議の URL を取得する

Teams チャネルの URL を取得するには、チャネル名の横にある 3 つのドット (...) を選択し、[ チャネルへのリンクを取得] を選択します。

Teams 会議の URL を取得するには、会議を開き、[ 参加] の横にある矢印を選択し、[ 参加リンクのコピー] を選択します。

グループまたは 1:1 チャットの URL を取得する

グループまたは 1:1 チャットの URL を取得するには、 chatId を含むディープ リンクが必要です。 ディープ リンクの形式は次のとおりです: https://teams.microsoft.com/l/chat/<chatId>/conversations。 chatId 値は、チャットごとに異なります。

グループまたは 1:1 チャットの chatId 値を取得するには:

1. Microsoft Teamsで、チャット内の任意のメッセージに移動します。
2. メッセージの上にマウス ポインターを合わせ、3 つのドット (...) を選択します。
3. [リンクのコピー] を選択します。
4. リンクをメモ帳または同様のアプリケーションに貼り付けます。 リンクは次の URL のようになります: https://teams.microsoft.com/l/chat/19:12ab3c4d-a123-12a3-a123-123ab12c12de_12a3bcd4-1234-1234-123a-1b2345c678d9@unq.gbl.spaces//1743033793614?context=%7B%22contextType%22%3A%22chat%22%7D。
5. chat/と次の/の間にある URL のセグメントをコピーします。 セグメントは一般に、 19:で始まる。 これは chatId です。 前の例では、 chatId が 19:12ab3c4d-a123-12a3-a123-123ab12c12de_12a3bcd4-1234-1234-123a-1b2345c678d9@unq.gbl.spacesされています。
6. chatId をディープ リンクに追加します。 例: https://teams.microsoft.com/l/chat/19:12ab3c4d-a123-12a3-a123-123ab12c12de_12a3bcd4-1234-1234-123a-1b2345c678d9@unq.gbl.spaces/conversations。

詳細については、「 Teams チャットへのディープ リンク」を参照してください。

関連コンテンツ

• 宣言型エージェントの概要
• 宣言型エージェント マニフェストリファレンス
• コード インタープリター機能をエージェントに追加する
• イメージ ジェネレーター機能をエージェントに追加する