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