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

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

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

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

Copilot コネクタ

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

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

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

SharePoint および OneDrive

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

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

Microsoft 365 Copilotで 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"
        }
      ]
    }
  ]
}

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

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

Microsoft 365 Copilotを使用してエージェントをビルドする場合は、デバイスまたはクラウドから直接ファイルをアップロードして、エージェントがナレッジとして使用するコンテンツを埋め込むことができます。 埋め込みファイルコンテンツは 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ナレッジを使用すると、エージェントのスコープを個人用メールボックスまたは共有メールボックス、および必要に応じて特定のメールボックス フォルダーに限定できます。

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

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

エージェント ツールキットと 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 アドレスを使用します。

[group_mailboxes] フィールドでは、エージェントのスコープを設定する共有メールボックスまたは Microsoft 365 グループの SMTP アドレスを含む文字列のarray (最大 25 個) を指定できます。

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

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

連絡先

エージェントをPeopleデータに取り込んで、よりパーソナライズされたコンテキスト対応の応答を提供できます。 Peopleデータは、個人に関する公開情報 (名前、役職、スキル、組織の関係など) と、ユーザーの接続、コラボレーター、関連する分析情報の個人ビューを結合します。 このナレッジ ソースを使用すると、エージェントは次のことが可能になります。

• レポート構造や連絡先の詳細など、ユーザーと同僚のプロファイルを検索します。
• organization内のドメインエキスパートと主要なコラボレーターを特定します。
• ユーザーの関係、過去の対話、好みに基づいて応答をカスタマイズします。
• 特定のチームまたは個人に合わせて調整された推奨事項とコミュニケーションのヒントを提供します。

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

Copilot Studioを使用してエージェントを作成する場合、Peopleナレッジ ソースは、Microsoft 365 Copilot ライセンスを持つユーザーに対して既定で有効になっています。

エージェント ツールキットと Visual Studio Code を使用してエージェントを作成する場合、ユーザーの知識を有効にするには、次の例に示すように、エージェント マニフェスト ファイルの capabilities プロパティにPeople値を追加します。 基本のPeople機能のみを宣言すると、エージェントは、プロファイル カードで使用できるデータなど、基本的なorganization データのみを推論できます。 エージェント ユーザーと organization 内の参照先ユーザーとの間に関連するチーム メッセージ、電子メール、ファイルなどのコンテンツを含める場合は、バージョン 1.6 を参照して、include_related_content プロパティを使用します。

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

関連するチーム のメッセージ、メール、ファイルなど、関連するコンテンツ (エージェント ユーザーと参照先のユーザーの間) をエージェントが推論する必要がある場合は、 include_related_contentを利用できます。 既定値は false です。

{
  "capabilities": [
    {
      "name":"People",
      "include_related_content": true
    }
  ]
}

Teams メッセージ

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

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

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

Microsoft 365 Copilotを使用してエージェントを作成する場合は、[構成] タブの [ナレッジ] セクションで検索バーを選択し、[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 会議の知識を使用すると、エージェントの範囲を指定して、単一の会議や会議シリーズなど、会議に関する質問に回答できます。 たとえば、エージェントは、"昨日の会議とリスト アクション アイテムをまとめる" や "会議で Project X について何が言われたか" などのクエリに応答できます。 このナレッジ ソースは、必要に応じて、最大 5 つの特定の会議にスコープを設定できます。 このナレッジ ソースを使用すると、エージェントは会議メタデータ (件名、開催者、出席者、タイトル)、トランスクリプト コンテンツ、会議チャットにアクセスできます。

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

Microsoft 365 Copilotを使用してエージェントを作成する場合は、[構成] タブの [ナレッジ] セクションで検索バーを選択し、[My Teams のチャットと会議] を選択します。 会議のスコープを設定する機能は、Microsoft 365 Copilot近日公開予定です。

エージェント ツールキットと Visual Studio Code を使用してエージェントを作成する場合、会議の知識を有効にするには、次の例に示すように、エージェント マニフェスト ファイルの capabilities プロパティにMeetings値を追加します。 エージェントを特定の会議にスコープを設定する場合は、会議の UID を items_by_id プロパティに追加します。 会議の ID を見つける手順については、「会議の ID を取得する」を参照してください。

{
  "capabilities": [
    {
      "name":"Meetings",
      "items_by_id": [
        {
          "id": "010000002300A00045B6C7890D12E0030000000040056F7GH890IJ01000000000000000020000000J3L45M6A7NO8PQ9R0S12TUV340XY5Z00",
          "is_series": true
        }
      ]
    }
  ]
}

関連コンテンツ

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