会話でデータを分析する

このドキュメントでは、Cloud SQL for PostgreSQL で会話を作成、編集、削除する方法について説明します。会話とは、 データ エージェントとの 永続的なチャットです。

ユーザーは、テーブル フィールド名を指定したり、データのフィルタ条件を定義したりすることなく、「売上」や「最も人気がある」といった一般的な言葉を使用してデータ エージェントにマルチパートの質問をすることができます。チャット回答では、質問に対する回答がテキストとコードで提供され、必要に応じてグラフが生成されます。回答には、それらの結果の背後にある推論も含まれます。

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

始める前に

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

  2. Cloud SQL、Data Analytics API with Gemini、Gemini for Google Cloud API を有効にします。

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

    API を有効にするには、serviceusage.services.enable 権限を含む Service Usage 管理者 IAM ロール（roles/serviceusage.serviceUsageAdmin）が必要です。詳しくは、ロールを付与する方法をご覧ください。

    API を有効にする

必要なロール

データ エージェントを使用するには、ユースケースに一致する IAM 権限が必要です。次の表に、エージェントの作成と公開、Gemini Enterprise でのエージェントのプロビジョニング、エージェントの検出と使用のいずれを行うかに応じて必要なロールを示します。詳細については、Conversational Analytics API の IAM ロールをご覧ください。

ユースケース 必要なロール
エージェントの作成、編集、公開、共有、削除
  • プロジェクトでデータ エージェントを作成するには: プロジェクトに対する Gemini データ分析データ エージェント作成者（roles/geminidataanalytics.dataAgentCreator）。このロールにより、作成したデータ エージェントに対する Gemini データ分析データ エージェント オーナーのロールが自動的に付与されます。
  • データ エージェントを編集、共有、削除するには: エージェントまたはプロジェクトに対する Gemini データ分析データ エージェント オーナー（roles/geminidataanalytics.dataAgentOwner）。
  • プロジェクトでデータ エージェントを編集するには: プロジェクトに対する Gemini データ分析データ エージェント編集者（roles/geminidataanalytics.dataAgentEditor）。
  • プロジェクトでデータ エージェントを表示するには: プロジェクトに対する Gemini データ分析データ エージェント閲覧者（roles/geminidataanalytics.dataAgentViewer）。
  • また、データ エージェントを作成または編集するには、次のロールが必要です。
Gemini Enterprise でエージェントをプロビジョニングする

公開されたエージェントを Gemini Enterprise のユーザーが利用できるようにするには、Gemini Enterprise 管理コンソールで A2A エージェントを登録して管理する権限が必要です。
エージェントを検出して使用する
  • データ エージェントとチャットするには: Gemini データ分析データ エージェント ユーザー（roles/geminidataanalytics.dataAgentUser）。
  • プロジェクト内のすべてのデータ エージェントを表示するには: Gemini データ分析データ エージェント閲覧者（roles/geminidataanalytics.dataAgentViewer）。

Cloud SQL for PostgreSQL データベース リソースへのアクセスを管理する場合は、次の権限レイヤを考慮してください。

  • Google Cloud IAM: クラウド リソースとしてデータベース インスタンスへのアクセスを制御します。これには、executeSql 権限を使用して SQL クエリを接続、インスタンスを管理、実行する権限が含まれます。
  • データベース権限: テーブル、ビュー、スキーマなど、データベース内のオブジェクトへのアクセスを制御します。これらは、GRANT などの SQL コマンドと、データベース固有のユーザーとロールのシステムを使用して管理されます。

Cloud SQL for PostgreSQL の場合は、インスタンスに接続してクエリを送信する権限を付与するために、適切な Cloud SQL IAM ロールが必要です。テーブルやビューなどのオブジェクトを操作するには、接続するデータベース ユーザーに、Cloud SQL for PostgreSQL の GRANT システムを使用して必要な権限が付与されている必要があります。 詳細については、 PostgreSQL のユーザーとロールについてをご覧ください。 エージェントがサービス アカウントを使用している場合は、データベースロールを割り当てることができます。たとえば、IAM データベース認証でユーザーを管理するをご覧ください。

会話の作成

Cloud SQL for PostgreSQL の コンソール Google Cloud で、エージェントまたはデータソースとの永続的な会話を作成できます。これを行うには、[エージェント] ページの [エージェント カタログ] タブを使用します。

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

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

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

  1. コンソールで、Cloud SQL for PostgreSQL のページに移動します。 Google Cloud

    Cloud SQL に移動

  2. リストからインスタンスを選択します。

  3. ナビゲーション メニューで、[エージェント] をクリックします。

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

  5. [会話を開始] をクリックします。新しいチャットパネルが開きます。

  6. [質問する] フィールドに、データ エージェントへの質問を入力します。 たとえば、「前四半期の総売上はいくらでしたか？」や「セッション時間の上位 5 人のユーザーを表示してください」などです。 Gemini が提案した質問のいずれかをクリックして開始することもできます。

    データ エージェントは、質問に対処するために実行するアクションを述べ、結果を返します。

    データ エージェントが質問に対する回答を提供するまでの各ステップを確認するには、[推論を表示] をクリックして、エージェントの推論プロセスの各メッセージを表示します。

    結果の計算方法に関する情報を確認するには、 [How was this calculated?] をクリックします。[概要] セクションに、生成されたクエリとクエリ結果が表示されます。コードをコピーし、[Studio] をクリックして、クエリエディタにコードを貼り付けることができます。

    データに適している場合は、データ エージェントがグラフ、表、その他の可視化も提供します。 チャット履歴を表示するには、[会話の管理] リストに移動します。

    エージェント情報を表示するには、[詳細] パネルに移動します。このパネルには、エージェントとそのナレッジソースの説明が表示されます。

会話を管理する

[エージェント] ページで、会話を開いたり、名前を変更したり、削除したりできます。

既存の会話を開く

  1. コンソールで、Cloud SQL for PostgreSQL のページに移動します。 Google Cloud

    Cloud SQL に移動

  2. リストからインスタンスを選択します。

  3. ナビゲーション メニューで、[エージェント] をクリックします。

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

会話の名前を変更する

  1. コンソールで、Cloud SQL for PostgreSQL のページに移動します。 Google Cloud

    Cloud SQL に移動

  2. リストからインスタンスを選択します。

  3. ナビゲーション メニューで、[エージェント] をクリックします。

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

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

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

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

会話を削除する

  1. コンソールで、Cloud SQL for PostgreSQL のページに移動します。 Google Cloud

    Cloud SQL に移動

  2. リストからインスタンスを選択します。

  3. ナビゲーション メニューで、[エージェント] をクリックします。

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

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

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

ロケーション

会話型分析はグローバルに運用されており、使用するリージョンを選択することはできません。

次のステップ