ヒント
推奨事項: サポートされているプロコード宣言型エージェントとプラグイン シナリオ用の Work IQ 開発ツール から始めます。 WIQD クイックスタートを参照してください。 Toolkit ベースの手順は、それらを必要とする既存のプロジェクトおよびワークフローで引き続き使用できます。 ツールを選択する前に 、機能とターゲット エクスペリエンスのサポート を確認します。WIQD はカスタム エンジン エージェントを対象としません。
Web からのナレッジ ソースと Microsoft 365 組織データからの応答を生成するためにエージェントが利用できるナレッジを制御できます。 使用可能なナレッジ ソースの完全な一覧については、「 宣言型エージェントへのナレッジ ソースの追加」を参照してください。
重要
このガイドは、「 Microsoft 365 Agents Toolkit と JSON を使用して宣言型エージェントを作成する 」チュートリアルを完了していることを前提としています。
エージェントに Web 検索を追加する
エージェントに Web 検索を追加すると、Web を検索して回答を生成できます。 必要に応じて、ナレッジの範囲を特定の Web サイトに限定できます。
appPackage/declarativeAgent.jsonファイルを開き、次の内容を含むcapabilities配列を追加します。"capabilities": [ { "name": "WebSearch" } ]詳細については、「 Web 検索オブジェクト」を参照してください。
Microsoft 365 Agents Toolkit のライフサイクル ウィンドウで [プロビジョニング] を選択します。
宣言型エージェントは、ページを再読み込みした後に Web コンテンツにアクセスして回答を生成できます。
SharePoint サイトをエージェントに追加する
OneDrive のファイルまたは SharePoint サイトのコンテンツをナレッジ ソースとして追加できます。
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 コンテンツがエージェントで利用できるようになります。
Agents Toolkit の [ライフサイクル] ウィンドウで [プロビジョニング] を選択します。
宣言型エージェントは、ページの再読み込み後に回答を生成するために OneDrive と SharePoint コンテンツにアクセスできます。
Teams メッセージをエージェントに追加する
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 チャット、およびグループ チャットがエージェントで利用できるようになります。
-
Agents Toolkit の [ライフサイクル] ウィンドウで [プロビジョニング] を選択します。
宣言型エージェントは、ページの再読み込み後に回答を生成するために Teams データにアクセスできます。
People Knowledge をエージェントに追加する
People ナレッジ ソースを使用すると、エージェントの範囲を設定して、organization内の個人に関する質問に回答できます。
appPackage/declarativeAgent.jsonファイルを開き、Peopleエントリをcapabilities配列に追加します。{ "name": "People" }詳細については、People オブジェクトを参照してください。
Agents Toolkit の [ライフサイクル] ウィンドウで [プロビジョニング] を選択します。
宣言型エージェントは、ページを再読み込みした後、People ナレッジにアクセスできます。
エージェントにメール メッセージを追加する
電子メール ナレッジ ソースを使用すると、ユーザーのメールボックスまたは共有メールボックスからの電子メールを使用してクエリに回答するようにエージェントの範囲を設定できます。
appPackage/declarativeAgent.jsonファイルを開き、Emailエントリをcapabilities配列に追加します。{ "name": "Email", "folders": [ { "folder_id": "inbox" } ] }詳細については、「Email オブジェクト」を参照してください。
注
- この例では、エージェントのメールボックスのユーザーにアクセスします。 代わりに共有メールボックスにアクセスするには、省略可能な
shared_mailboxプロパティ セットを共有メールボックスのメール アドレスに追加します。 -
folders配列は、メールボックスへのアクセスを特定のフォルダーに制限します。 メールボックス全体にアクセスするには、folders配列を省略します。
- この例では、エージェントのメールボックスのユーザーにアクセスします。 代わりに共有メールボックスにアクセスするには、省略可能な
Agents Toolkit の [ライフサイクル] ウィンドウで [プロビジョニング] を選択します。
宣言型エージェントは、ページを再読み込みした後、電子メールのナレッジにアクセスできます。
Copilot コネクタをエージェントに追加する
Copilot コネクタを追加すると、そのコネクタによって取り込まれた項目がエージェントがナレッジ ソースとして利用できるようになります。
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 コネクタ コンテンツがエージェントで利用できるようになります。
-
Agents Toolkit の [ライフサイクル] ウィンドウで [プロビジョニング] を選択します。
宣言型エージェントは、Copilot コネクタのコンテンツにアクセスして、ページの再読み込み後に回答を生成できます。