会話でデータを分析する

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

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

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

始める前に

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

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

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

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

    API を有効にする

必要なロール

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

ユースケース 必要なロール
エージェントの作成、編集、公開、共有、削除
  • プロジェクトにデータ エージェントを作成する: プロジェクトに対する 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 MySQL データベース リソースへのアクセスを管理する場合は、次の権限レイヤを考慮してください。

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

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

会話の作成

Cloud SQL for MySQL の Google Cloud コンソールで、[エージェント] ページの [エージェント カタログ] タブから、エージェントまたはデータソースとの永続的な会話を作成できます。

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

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

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

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

    Cloud SQL に移動

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

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

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

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

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

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

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

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

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

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

会話を管理する

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

既存の会話を開く

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

    Cloud SQL に移動

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

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

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

会話の名前を変更する

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

    Cloud SQL に移動

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

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

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

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

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

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

会話を削除する

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

    Cloud SQL に移動

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

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

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

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

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

ロケーション

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

次のステップ