会話でデータを分析する

このドキュメントでは、BigQuery で会話を作成、編集、削除する方法について説明します。会話とは、選択したデータ エージェントまたはデータソース（テーブル、ビュー、グラフなど）との永続化されたチャットです。

会話とは、データ エージェントまたはデータソースとの永続化されたチャットです。テーブル フィールド名を指定したり、データのフィルタ条件を定義したりすることなく、「売上」や「最も人気がある」といった一般的な言葉を使用してデータ エージェントにマルチパートの質問をすることができます。PDF などのオブジェクトにあるデータについて質問することもできます。エージェントは、レスポンスを構築するときに、クエリするデータソースを特定し、テーブル パーティションや検索インデックスなどの最適化を利用できます。エージェントは、列値の既存のエンベディングを使用して、質問を適切なデータに対応付けることができます。たとえば、「Texas」について質問すると、「TX」として保存されている行が検索されます。

返されるチャット レスポンスには、次の機能があります。

• 質問に対する回答（テキスト、コード、画像（マルチモーダル））。回答には、サポートされている BigQuery AI 関数と ML 関数を含めることができます。
• 必要に応じてグラフを生成しました。
• 結果の背後にあるエージェントの推論。
• 使用されたエージェントやデータソースなど、会話に関するメタデータ。

データソースとの直接会話を作成すると、Conversational Analytics API は、データ エージェントから提供されるコンテキストと処理の指示を使用せずにユーザーからの質問を解釈します。そのため、直接会話の結果は正確さが低い可能性があります。正確さが求められる場合は、データ エージェントを使用してください。

BigQuery で会話を作成して管理するには、Cloud de Confiance コンソールを使用します。詳細については、会話でデータを分析するをご覧ください。

始める前に

1. Cloud de Confiance プロジェクトに対して課金が有効になっていることを確認します。

2. BigQuery API、Gemini Data Analytics API、Gemini for Cloud de Confiance by S3NS API がまだ有効になっていない場合は、有効にします。

   API を有効にするために必要なロール

   API を有効にするには、serviceusage.services.enable 権限が必要です。プロジェクトを作成した場合は、オーナーロール（roles/owner）を介してこの権限がすでに付与されている可能性があります。それ以外の場合は、Service Usage 管理者ロール（roles/serviceusage.serviceUsageAdmin）を介してこの権限を取得できます。ロールを付与する方法を確認する。

   API を有効にする

必要なロール

会話を作成するには、次のいずれかの Conversational Analytics API IAM ロールが必要です。

• 共有されているデータ エージェントとの会話を表示および作成するには、プロジェクト レベルで Gemini データ分析データ エージェント ユーザー（roles/geminidataanalytics.dataAgentUser）ロールと Gemini for Google Cloud ユーザー（roles/cloudaicompanion.user）ロールが必要です。
• 直接会話を作成するには、Gemini データ分析 Stateless Chat User（roles/geminidataanalytics.dataAgentStatelessUser）ロールが必要です。

また、次の状況では、次のロールが必要です。

• データ エージェントがデータセットをナレッジソースとして使用する場合は、データセットに対する BigQuery データ閲覧者（roles/bigquery.dataViewer）ロールが必要です。
• データ エージェントが SQL クエリを実行する場合は、プロジェクトに対する BigQuery ジョブユーザー（roles/bigquery.jobUser）ロールが必要です。
• データ エージェントがテーブルまたはビューをナレッジソースとして使用する場合は、テーブルまたはビューに対する BigQuery データ閲覧者（roles/bigquery.dataViewer）ロールが必要です。
• テーブルで列レベルのアクセス制御を使用している場合は、きめ細かい読み取り（roles/datacatalog.categoryFineGrainedReader）ロールが必要です。このロールは、ポリシータグの構成の一環としてプリンシパルに割り当てられます。詳細については、列レベルのアクセス制御で使用されるロールをご覧ください。
• データテーブルで行レベルのアクセス制御が使用されている場合は、そのテーブルに対するロールレベルのアクセス ポリシーを介してアクセス権が付与されている必要があります。詳細については、行レベルのアクセス ポリシーを作成または更新するをご覧ください。
• データテーブルでデータ マスキングが使用されている場合は、適切なデータポリシーを通じてマスクされた読み取り（roles/bigquerydatapolicy.maskedReader）ロールが付与されている必要があります。詳細については、マスクされたデータに対してクエリを実行するためのロールをご覧ください。
• データセットと会話するには、プロジェクトに対する Data Catalog 閲覧者（roles/datacatalog.viewer）が必要です。

データ エージェントで使用されるソースデータ テーブルに対する適切なロールがない場合、データ エージェントとチャットすると、次のエラーが返されます。

Schema_Resolution: Access Denied

ベスト プラクティス

会話分析は、ユーザーに代わってクエリを自動的に実行し、質問に回答します。クエリ費用が増加する可能性がある次の要因を考慮してください。

• テーブルサイズが大きい
• クエリでのデータ結合の使用
• クエリ内での AI 関数の頻繁な呼び出し

データ エージェントとの会話を作成する

データ エージェントとの会話を作成するには、まずデータ エージェントを作成して公開します。他のユーザーが共有したエージェントとの会話を開始することもできます。

Cloud de Confiance コンソールで既存のデータ エージェントとの会話を作成する手順は次のとおりです。

1. BigQuery の [エージェント] ページに移動します。

   [エージェント] に移動

2. [エージェント カタログ] タブを選択します。

3. [マイ エージェント] または [組織内の他のユーザーが共有] セクションで、チャットするエージェントのエージェント カードをクリックします。

   新しいチャットパネルが開きます。

4. [質問する] フィールドに質問を入力し、モードを選択します。

   • 高速モード（デフォルト）: ほとんどの質問に最適です。
   • 思考: 詳細な推論。

   Gemini が提案した質問のいずれかをクリックして開始することもできます。

5. [send_spark 送信] をクリックします。

   Conversational Analytics API は質問を処理し、結果を返します。

データソースとの直接会話を作成する

これらの BigQuery データソース（ナレッジソースとも呼ばれます）との直接会話を作成できます。直接会話を作成すると、Conversational Analytics API は、データ エージェントから提供されるコンテキストと処理の指示を使用せずにユーザーからの質問を解釈します。

次のデータソースとの会話を作成できます。

• テーブル
• 表示
• データセット（プレビュー）
• グラフ

[エージェント] ページを使用してデータソースと会話する

Cloud de Confiance コンソールの [エージェント] ページを使用してデータソースとの会話を作成する手順は次のとおりです。

[エージェント] ページからデータソースとの直接会話を作成する手順は次のとおりです。

1. BigQuery の [エージェント] ページに移動します。

   [エージェント] に移動

2. [会話] タブで、[新しい会話] をクリックします。

3. [データとチャットする] ペインで、[ナレッジ ソース] タブをクリックします。データソースがリストに表示されない場合は、検索できます。

4. 1 つ以上のデータソースを選択し、[チャット] をクリックします。

BigQuery Studio を使用してデータソースと会話する

BigQuery Studio を使用してデータソースとの直接的な会話を作成するには、次のいずれかのオプションを選択します。

データセット、テーブル、ビュー、グラフについて AI と会話する

データセット、テーブル、ビュー、グラフとの直接会話を作成する手順は次のとおりです。

1. Cloud de Confiance コンソールで、[BigQuery Studio] ページに移動します。

   [BigQuery Studio] に移動

2. 左側のペインで、explore [エクスプローラ] をクリックします。

3. [エクスプローラ] ペインでプロジェクトを開き、[データセット] をクリックして、データセットを選択します。[データセット] ページが開きます。

4. データセットをクリックして開きます。

5. データセットとチャットするには、chat_spark [チャット] をクリックします。

6. データセット内のテーブルまたはビューとチャットする手順は次のとおりです。

   1. [概要] タブで [テーブル] をクリックします。

   2. [テーブル ID] 列で、テーブルまたはビューへのリンクをクリックします。

   3. chat_spark [チャット] をクリックします。

7. グラフとチャットする手順は次のとおりです。

   1. [概要] タブで、[グラフ] をクリックします。

   2. [グラフ ID] 列で、グラフへのリンクをクリックします。

   3. chat_spark [チャット] をクリックします。

データセット

データセットとの会話を作成すると、データソースを明示的にリストすることなく、データに関する質問を行うことができます。データセットとの会話を作成すると、データ エージェントはそのデータセット内のすべてのテーブルにアクセスできます。質問すると、データ エージェントは関連するテーブルを探し、必要に応じてそれらを結合して回答を生成します。

クエリ結果と会話する

クエリを実行した後、結果を使用して新しい会話を作成できます。データソースは、通常 24 時間保持されるキャッシュに保存された結果の一時テーブルです。キャッシュに保存された結果の有効期限が切れると、データに関する質問はできなくなります。

クエリ結果から会話を作成する手順は次のとおりです。

1. Cloud de Confiance コンソールで、[BigQuery Studio] ページに移動します。

   [BigQuery Studio] に移動

2. [search_insights] クエリエディタ タブに切り替えるか、arrow_drop_down > [SQL クエリ] をクリックします。

3. SQL クエリを入力し、[play_circle 実行] をクリックします。

4. [結果] タブで、chat_spark [チャット] をクリックします。

データソースと会話する方法

データソースの [チャット] オプションをクリックすると、会話を開始できます。会話を行う手順は次のとおりです。

1. [質問する] フィールドに質問を入力し、モードを選択します。

   • 高速モード（デフォルト）: ほとんどの質問に最適です。
   • 思考: 詳細な推論。

2. send_spark [送信] をクリックします。

   Conversational Analytics API は質問を処理し、結果を返します。データに適している場合は、回答に画像、グラフ、表、その他の可視化が提供されます。

3. 質問に対する回答を提供するためにデータ エージェントが実行した各ステップを確認するには、回答の [思考を表示] オプションを開きます。

   

4. 結果の計算方法に関する情報を確認するには、keyboard_arrow_down [算出方法] をクリックします。

   

   [概要] セクションには、生成されたクエリとクエリ結果が表示されます。必要に応じて、クエリエディタでクエリを開くことができます。

会話からデータ エージェントを作成する

データ エージェントは、テーブルまたはビューとの会話から作成できます。データセットとの会話からカスタム エージェントを作成することはできません。

会話からデータ エージェントを作成する手順は次のとおりです。

1. 会話の [詳細] ペインで、[エージェントを作成] をクリックします。

2. [エディタ] セクションの [エージェント名] フィールドに、データ エージェントのわかりやすい名前（Q4 sales data、User activity logs など）を入力します。

3. [エージェントの説明] フィールドに、データ エージェントの説明を入力します。適切な説明を付けておくと、エージェントの機能や使用するデータがわかり、チャット相手とするデータ エージェントを選択する際に役立ちます（例: Ask questions about customer orders and revenue）。

4. [ナレッジソース] セクションで、[ナレッジソース] のエントリを確認します。既存のデータソースをカスタマイズすることも、[ソースを追加] をクリックしてデータソースを追加することもできます。データソースがリストに表示されない場合は、検索できます。

5. 変更を加えたら、[下書きを保存] をクリックします。

6. [公開] をクリックします。

会話を管理する

[エージェント] ページで会話を開いたり、名前を変更したり、削除したりできます。また、BigQuery Studio エクスプローラで会話を管理することもできます。

既存の会話を開く

1. Cloud de Confiance コンソールで、BigQuery の [エージェント] ページに移動します。

   [エージェント] に移動

2. [会話] タブの会話リストで、開く会話をクリックします。

会話の名前を変更する

1. Cloud de Confiance コンソールで、BigQuery の [エージェント] ページに移動します。

   [エージェント] に移動

2. [会話] タブの会話リストで、名前を変更する会話をクリックします。

3. more_vert [アクションを表示] > [名前を変更] をクリックします。

4. [会話の名前を変更する] ダイアログの [会話名] フィールドに、会話の新しい名前を入力します。

5. [名前を変更] をクリックします。

会話を削除する

会話内の質問の結果は、基になるデータソースが削除されても保持されます。会話とその会話に含まれるすべての結果を削除する手順は次のとおりです。

1. Cloud de Confiance コンソールで、BigQuery の [エージェント] ページに移動します。

   [エージェント] に移動

2. [会話] タブの会話リストで、削除する会話をクリックします。

3. more_vert [アクションを表示] > [削除] をクリックします。

4. [会話を削除しますか？] ダイアログで、[削除] をクリックします。

180 日間会話を更新しないと、BigQuery は会話を自動的に削除します。

BigQuery Studio Explorer を使用して会話を管理する

BigQuery Studio エクスプローラを使用して会話を管理します。この会話リストは、会話の検索、開始、作成を一元的に行う場所です。会話 ID をコピーしたり、会話リストを更新したりすることもできます。

会話を管理する手順は次のとおりです。

1. [BigQuery Studio エクスプローラ] ページに移動します。

   [エクスプローラ] に移動

2. [エクスプローラ] ペインで、プロジェクト名を開きます。

3. [会話] をクリックします。

   1. 会話リストをフィルタするには、フィルタ フィールドにプロパティ名または値を入力します。
   2. 会話を開くには、more_vert（アクションを表示）> [開く] をクリックします。
   3. 会話 ID をコピーするには、more_vert [アクションを表示] > [ID をコピー] をクリックします。
   4. 会話を作成するには、メニューバーで [会話を作成] をクリックします。
   5. リストを更新するには、メニューバーの [更新] をクリックします。

次のステップ

• BigQuery の会話型分析について学習する。
• Conversational Analytics API について学習する。
• データ エージェントを作成する。