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