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

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

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

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

Copilot コネクタ

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

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

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

SharePoint および OneDrive

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

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

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

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

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

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

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

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

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

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

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

埋め込みファイルの詳細については、「 埋め込みファイルの内容」を参照してください。

Dataverse

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

Dataverse ナレッジを追加する

エージェント ツールキットと Visual Studio Code を使用してエージェントを作成する場合、Dataverse ナレッジを有効にするには、次の例に示すように、エージェント マニフェスト ファイルの capabilities プロパティに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 つの共有フォルダーのみを参照できます。

{
  "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> の直接レポートの一覧表示" などのクエリに応答できます。 このナレッジ ソースのスコープは設定されていません。

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

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

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

Teams メッセージ

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

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

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

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

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

{
  "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 チャットへのディープ リンク」を参照してください。

Teams 会議

Teams 会議の知識を使用すると、エージェントの範囲を指定して会議に関する質問に回答できます。 たとえば、エージェントは、"昨日の会議とリスト アクション アイテムをまとめる" や "明日の会議は何ですか" などのクエリに応答できます。 このナレッジ ソースのスコープは設定されていません。

会議のナレッジ ソースを追加する

Copilot Studioを使用してエージェントを作成する場合は、[構成] タブの [ナレッジ] セクションで検索バーを選択し、グループ、チャネル、会議から [My Teams チャット] を選択します。

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

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

関連コンテンツ

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