トピックで生成応答を使用する

生成応答ノードを使用することで、エージェントはトピック レベルのサポート情報ソースに基づいてユーザーに応答することができます。 サポート情報ソースは、ユーザーがエージェントに提供した情報に基づいて、信頼できる回答を提供できるようになります。

エージェントを最初に作成する際、エージェントが応答を生成する際に使用する URL を入力することができます。 この URL はエージェントのすべての機能で使用されます。 しかし、個々のトピック内で複数の社内および社外のサポート情報ソースを活用することで、エージェントの会話力を向上させることができます。

フォールバックとしての生成応答

ユーザーのクエリに一致するインテント (トピックで定義) をエージェントが見つけられない場合、生成応答を使用して質問に回答しようとします。 この動作は、フォールバックとして生成応答として知られています。 ユーザーの意図がトピックや生成応答と一致しない場合は、フォールバック システム トピック が使用されます。 システム トピックは、エージェントに対するクエリをエスカレーションできます。

生成応答のサポート情報ソース

エージェントのトピック内に、生成応答ノードを追加できます。 このノードを使用すると、入力に基づいてノードが検索するソースをさらに指定できます。 生成応答ノードで定義されたソースは、エージェントレベルで指定したサポート情報ソースを上書きします。 最良の結果を得るには、特定のサポート情報ソースを使用して生成応答ノードを構成します。

これらのソースには以下が含まれます:

  • 外部リソース:

  • 内部リソースの追加:

    • データ上の Azure OpenAI
    • Dataverse にアップロードされたドキュメント
    • SharePoint (特定のファイル形式 のみに対応)
    • カスタム データ (内部または外部): Power Automate フローまたはスキルからなど、独自のソースを提供します。

サポートされるサポート情報ソース

サポート情報ソースが異なれば、その機能も異なります。 これらの機能には、入力数のほか、データのタイプや形式、ソースがデータにアクセスする際に認証が必要かどうか (あるいはどのような方法で認証を行うか) などが含まれます。

名前 Source 内容 生成応答でサポートされている入力の数 認証
公開 Web サイト 外部 Bing でクエリ入力を検索し、指定された Web サイトからの結果のみを返します 生成モード: 25 の Web サイト
クラシックモード: 4 つの公開 URL (例: microsoft.com)
なし
ドキュメント 内部 Dataverse にアップロードされたドキュメントを検索し、ドキュメントの内容から結果を返します 生成モード: すべてのドキュメント
クラシック モード: Dataverse ファイルのストレージ割り当てによる制限
なし
SharePoint Internal SharePoint URL に接続し、GraphSearch を使って結果を返します 生成モード: 25 個の URL
クラシック モード: 生成応答トピック ノードごとに 4 つの URL
エージェント ユーザーの Microsoft Entra ID 認証
Dataverse 内部 構成された Dataverse 環境に接続し、Dataverse の検索拡張生成技術を使用して結果を返します ジェネレーティブモード:無制限
クラシック モード: 2 つの Dataverse サポート情報ソース (サポート情報ソースごとに最大 15 個のテーブル)
エージェント ユーザーの Microsoft Entra ID 認証
コネクタを使用したエンタープライズ データ 内部 組織のデータのインデックスが Microsoft 検索によって作成されているコネクタに接続します ジェネレーティブモード:無制限
クラシック モード: カスタム エージェント ごとに 2 つ
エージェント ユーザーの Microsoft Entra ID 認証

注意

  • サポート情報ソースに対するエージェント ユーザー認証とは、特定のユーザーがエージェントに質問すると、エージェントは特定のユーザーがアクセスできるコンテンツのみを表示することを意味します。

  • 生成応答ノードのサポート情報ソースは、現在、Bing Custom Search、Azure OpenAI、カスタム データをサポートしていません。 代わりに、生成応答ノードのプロパティから、Bing Custom SearchAzure OpenAI、または カスタム データ ソースの クラシック データ オプションを使用します。

  • Web サイトについては、Copilot Studio を使用して Bing が検索する組織所有の Web サイトを確認する必要があります。

  • サポートされているすべてのファイルの種類と言語で、言語に依存しないクエリを実行できます。

  • 個々の SharePoint ファイルとフォルダー、OneDrive のファイルとフォルダー、コネクタなど、非構造化データを使用している場合は、さまざまな制限と解除があります。 詳細については、制約と制限を参照してください。

  • 現時点では、サポート情報ソースから返された引用は、他のツールやアクションへの入力として使用できません。

生成応答ノードを追加する

  1. トピック ページに移動し、目的のトピックを開きます。

  2. 生成応答を使用したいノードの下にあるノードを追加アイコン を選択し、詳細設定にカーソルを合わせ、生成応答を選択します。 生成応答を作成するという新しいノードが表示されます。

  3. ノードの 3 つのドット () を選択し、プロパティ を選択します。 生成応答の作成プロパティ ペインが表示されます。

    新しいデータ ソースを指定して構成できます:

エージェントの応答をカスタマイズする

このセクションでは、エージェントの応答をすぐに返すのではなく、変数に格納する方法について説明します。これにより、その応答をアダプティブ カードに組み込むことができます。

  1. 生成応答の作成ノードで、入力として、システム変数 Activity.Text を選択します。

  2. 生成応答の作成プロパティ パネルで、

    1. 詳細 セクションを展開します。

    2. グローバル変数を作成します。 変数にわかりやすい名前を入力してください。 この変数には、ユーザーからのクエリに応じて生成応答が格納されます。

    3. メッセージを送信 ボックスをオフにします。

      メモ

      このオプションのチェックを外すと、エージェントが生成応答を即座に返すことを防ぎ、回答をカスタマイズできるようになります。 制限: このエージェントを Teams に公開する場合は、カスタマイズされた回答の引用表示を明示的に含める必要があります。 Teams では、Copilot Studio のエージェントは、カスタマイズされていない回答に対してのみ、引用リンクを自動的に返します。 詳細については、カスタマイズされた回答では引用が表示されませんをご覧ください。

  3. 質問 ノードまたは メッセージ ノードを追加し、このノードに アダプティブ カードを追加します

  4. アダプティブ カードのプロパティ パネルで 数式 に切り替え、既定のコンテンツをグローバル変数とカスタマイズを使った Power Fx 数式に置き換えてください。

認証

チャット ウィンドウ内でエージェントがユーザーに代わって呼び出しを行うため、一部のソースでは認証が必要となります。 これらの呼び出しでは、copilotstudio.microsoft.com のアカウント認証情報を使用します。

エージェントで構成する認証設定では、Microsoft Entra IDサービス プロバイダーとして指定した場合、手動による認証が必要となります。

認証を構成し、Microsoft Entra ID を作成するには、以下を参照してください。

Microsoft Graph に対して次の委任されたアクセス許可を含める必要があります:

  1. Files.Read.All
  2. Sites.Read.All

サポートされているコンテンツ

生成応答は、以下の形式で保存されたコンテンツを取得します。

  • SharePoint ページ (モダン ページ)
  • Word 文書 (docx)
  • PowerPoint ドキュメント (pptx)
  • PDF ドキュメント (pdf)

注意

制限とサポートされている SharePoint 機能の一覧については、SharePoint Web アプリの制限を参照してください。

コンテンツ モデレーション

プロパティペインから、生成応答ノードのコンテンツ モデレーション設定を行うことができます。 コンテンツ モデレーション設定により、エージェントはより多くの回答を提供できます。 ただし、回答の増加は、エージェントからの有害コンテンツの許可に影響を与える可能性があります。

  1. ノードの 3 つのドット () を選択し、プロパティ を選択します。

  2. 希望するモデレーション レベルを選択します。

    モデレーション レベルは、最小から最高まであります。 最も低いレベルでは最も多くの回答が生成されますが、有害なコンテンツが含まれている可能性があります。 最高レベルのコンテンツ モデレーションでは、生成される回答が少なくなり、有害なコンテンツを制限するためのより厳しいフィルターが適用されます。 既定のモデレート レベルはです。

  3. ページ上部にある 保存 を選択します。

ヒント

生成応答ノードをコンテンツのモデレートに設定すると、回答が返されない場合があります。 回答が返されない原因を診断する方法の詳細については、コンテンツ モデレーションによってブロックされたコンテンツを参照してください。