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

ヒント

推奨事項: サポートされているプロコード宣言型エージェントとプラグイン シナリオ用の Work IQ 開発ツール から始めます。 WIQD クイックスタートを参照してください。 Toolkit ベースの手順は、それらを必要とする既存のプロジェクトおよびワークフローで引き続き使用できます。 ツールを選択する前に 、機能とターゲット エクスペリエンスのサポート を確認します。WIQD はカスタム エンジン エージェントを対象としません。

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

重要

このガイドは、「 Microsoft 365 Agents Toolkit と JSON を使用して宣言型エージェントを作成する 」チュートリアルを完了していることを前提としています。

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

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

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

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

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

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

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

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 コンテンツにアクセスできます。

SharePoint と OneDrive のコンテンツを含む宣言型エージェントからの応答を示すスクリーンショット

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 データにアクセスできます。

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 コネクタのコンテンツにアクセスして、ページの再読み込み後に回答を生成できます。

Copilot コネクタのコンテンツを含む宣言型エージェントからの応答を示すスクリーンショット

次のステップ