宣言型エージェントはMicrosoft 365 Copilotを拡張して、ユーザーのエクスペリエンスをカスタマイズします。 宣言型エージェントを構築するときに、SharePoint コンテンツを追加し、ナレッジ ソースとしてファイルをアップロードできます。 この記事では、エージェントが SharePoint と埋め込みコンテンツナレッジ ソースからデータを返す方法を最適化するために適用するベスト プラクティスについて説明します。
注:
SharePoint データと埋め込みファイルに固定されたエージェントは、Copilot Studio測定が有効になっているテナント内のユーザー、またはMicrosoft 365 Copilot ライセンスを持つユーザーのみが使用できます。 詳細については、「Microsoft 365 Copilot開発者ライセンス」を参照してください。
関連する SharePoint ファイルのみを参照する
特定の SharePoint ファイルは、エージェント マニフェストの OneDriveAndSharePoint オブジェクトを使用して、URL または ID で参照できます。
最大 20 個のファイルを指定すると、Copilot はすべてのファイルの完全な内容を検索します。 Copilot は、すべてのファイル コンテンツへのフル アクセス権を持ち、クエリに基づいて適切なコンテンツをユーザーに返します。
Copilot から返されるコンテンツを最適化するには、マニフェストで指定する最も関連性の高い SharePoint ファイルを選択します。 たとえば、フォルダーに 8 つのファイルが含まれており、ユーザーのタスクに関連するファイルが 5 つだけの場合は、フォルダーを参照するのではなく、5 つのファイルを個別に指定します。 Copilot がファイルの完全な内容を確実に検索するには、指定した関連ファイルの合計ページ数を 300 ページ以下に制限することをお勧めします。
SharePoint ファイル サイズを制限する
エージェント マニフェストの URL で SharePoint サイトまたはフォルダーを参照し、サイトまたはフォルダーに含まれるファイルが大きい場合、Copilot がユーザーに返す適切なコンテンツを特定できない可能性があります。 参照するサイトやフォルダーに Copilot が適切なコンテンツを見つけることができないリスクを軽減するには、SharePoint ファイルを最大 36,000 文字 (約 15 ~ 20 ページ) に保ちます。 ファイルが 36,000 文字を超える場合は、Copilot が完全なコンテンツをスキャンするのに役立つ短いファイルに分割することを検討してください。
または、特定の SharePoint ファイルを ID で参照することもできます。 20 個以下のファイルを指定した場合、Copilot はすべてのファイルの完全な内容を検索します。 20 個を超えるファイルを指定すると、最も関連性の高い 20 個のファイルの完全な内容が検索されます。
特殊な書式設定を削除する
Copilot は現在、SharePoint コンテンツ内のテーブルやその他の特別な書式設定を解析できません。 Copilot が SharePoint コンテンツを使用できるようにするには、エージェント マニフェストで参照する前に、コンテンツからテーブルやその他の特別な書式を削除します。
埋め込みファイル コンテンツの取得を最適化する
埋め込みファイル コンテンツを含むエージェントの場合、Copilot は各埋め込みファイルの最初の 750 から 1,000 ページ (180 万文字) のインデックスを作成します。
Copilot 取得用の埋め込みファイル コンテンツを最適化するには、750 から 1,000 ページ以下のファイルをアップロードします。 詳細については、「 Copilot に提供するドキュメントの長さ」を参照してください。
Copilot 取得用に Excel コンテンツを最適化するには、すべてのデータをブック内の 1 つのシートに格納します。