Microsoft 365 Agents Toolkit で作成した宣言型エージェントにナレッジ ソースを追加する

Web からのナレッジ ソースと Microsoft 365 組織データからの応答を生成するためにエージェントが利用できるナレッジを制御できます。 使用可能なナレッジ ソースの完全な一覧については、「 宣言型エージェントへのナレッジ ソースの追加」を参照してください。

エージェントに Web 検索を追加する

エージェントに Web 検索を追加すると、Web を検索して回答を生成できます。 必要に応じて、ナレッジの範囲を特定の Web サイトに限定できます。

1. appPackage/declarativeAgent.json ファイルを開き、次の内容を含むcapabilities配列を追加します。

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

   詳細については、「 Web 検索オブジェクト」を参照してください。

2. Microsoft 365 Agents Toolkit のライフサイクル ウィンドウで [プロビジョニング] を選択します。

宣言型エージェントは、ページを再読み込みした後に Web コンテンツにアクセスして回答を生成できます。

SharePoint サイトをエージェントに追加する

OneDrive のファイルまたは SharePoint サイトのコンテンツをナレッジ ソースとして追加できます。

1. appPackage/declarativeAgent.json ファイルを開き、capabilities配列に次の値を追加します。https://contoso.sharepoint.com/sites/ProductSupportを Microsoft 365 organizationの SharePoint サイト URL に置き換えます。

   {
     "name": "OneDriveAndSharePoint",
     "items_by_url": [
       {
         "url": "https://contoso.sharepoint.com/sites/ProductSupport"
       }
     ]
   }
   

   詳細については、「 OneDrive と SharePoint オブジェクト」を参照してください。

   注:

   • URL は、SharePoint アイテム (サイト、ドキュメント ライブラリ、フォルダー、ファイル) へのフル パスである必要があります。 SharePoint の [直接リンクをコピー] オプションを使用すると、完全なパスまたはファイルとフォルダーを取得できます。 ファイルまたはフォルダーを右クリックし、[ 詳細] を選択します。 [ パス] に移動し、コピー アイコンを選択します。
   • items_by_url 配列 (または代替の items_by_sharepoint_ids 配列) を指定しない場合、ログインしているユーザーが使用できる Microsoft 365 organization内のすべての OneDrive および SharePoint コンテンツがエージェントで利用できるようになります。

2. Agents Toolkit の [ライフサイクル] ウィンドウで [プロビジョニング] を選択します。

宣言型エージェントは、ページの再読み込み後に回答を生成するために OneDrive と SharePoint コンテンツにアクセスできます。

Teams メッセージをエージェントに追加する

1. appPackage/declarativeAgent.json ファイルを開き、https://teams.microsoft.com/l/team/...をorganizationの Teams チャネルまたはチームの URL に置き換えて、capabilities配列に次の値を追加します。

   {
     "name": "TeamsMessages",
     "urls": [
       {
         "url": "https://teams.microsoft.com/l/team/..."
       }
     ]
   }
   

   詳細については、「 Microsoft Teams メッセージ オブジェクト」を参照してください。

   注:

   • url プロパティ内の URL は、Teams チャット、チーム、または会議チャットへの整形済みのリンクである必要があります。
   • urls配列を指定しないと、ログインしているユーザーが利用できる Microsoft 365 organization内のすべての Teams チャネル、チーム、会議、1:1 チャット、およびグループ チャットがエージェントで利用できるようになります。

2. Agents Toolkit の [ライフサイクル] ウィンドウで [プロビジョニング] を選択します。

宣言型エージェントは、ページの再読み込み後に回答を生成するために Teams データにアクセスできます。

People Knowledge をエージェントに追加する

People ナレッジ ソースを使用すると、エージェントの範囲を設定して、organization内の個人に関する質問に回答できます。

1. appPackage/declarativeAgent.json ファイルを開き、People エントリをcapabilities配列に追加します。

   {
     "name": "People"
   }
   

   詳細については、People オブジェクトを参照してください。

2. Agents Toolkit の [ライフサイクル] ウィンドウで [プロビジョニング] を選択します。

宣言型エージェントは、ページを再読み込みした後、People ナレッジにアクセスできます。

エージェントにメール メッセージを追加する

電子メール ナレッジ ソースを使用すると、ユーザーのメールボックスまたは共有メールボックスからの電子メールを使用してクエリに回答するようにエージェントの範囲を設定できます。

1. appPackage/declarativeAgent.json ファイルを開き、Email エントリをcapabilities配列に追加します。

   {
     "name": "Email",
     "folders": [
       {
         "folder_id": "inbox"
       }
     ]
   }
   

   詳細については、「Email オブジェクト」を参照してください。

   注:

   • この例では、エージェントのメールボックスのユーザーにアクセスします。 代わりに共有メールボックスにアクセスするには、省略可能な shared_mailbox プロパティ セットを共有メールボックスのメール アドレスに追加します。
   • folders 配列は、メールボックスへのアクセスを特定のフォルダーに制限します。 メールボックス全体にアクセスするには、 folders 配列を省略します。

2. Agents Toolkit の [ライフサイクル] ウィンドウで [プロビジョニング] を選択します。

宣言型エージェントは、ページを再読み込みした後、電子メールのナレッジにアクセスできます。

Copilot コネクタをエージェントに追加する

Copilot コネクタを追加すると、そのコネクタによって取り込まれた項目がエージェントがナレッジ ソースとして利用できるようになります。

1. appPackage/declarativeAgent.json ファイルを開き、capabilities配列に次の値を追加します。policieslocalを Microsoft 365 organizationの有効な Copilot コネクタ ID に置き換えます。 Copilot コネクタ ID を検索する方法の詳細については、「 宣言型エージェント マニフェストの機能 ID を取得する」を参照してください。

   {
     "name": "GraphConnectors",
     "connections": [
       {
         "connection_id": "policieslocal"
       }
     ]
   }
   

   詳細については、「 Copilot コネクタ オブジェクト」を参照してください。

   注:

   • connections 配列を指定しない場合、ログインしているユーザーが使用できる Microsoft 365 organization内のすべての Copilot コネクタ コンテンツがエージェントで利用できるようになります。

2. Agents Toolkit の [ライフサイクル] ウィンドウで [プロビジョニング] を選択します。

宣言型エージェントは、Copilot コネクタのコンテンツにアクセスして、ページの再読み込み後に回答を生成できます。

次の手順