会話でデータを分析する

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

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

データ エージェントとの会話を作成できます。直接会話を作成すると、 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 を有効にする

必要なロール

データ エージェントを操作するには、次のいずれかの 会話型分析 API Identity and Access Management（IAM）ロールが必要です。

  • QueryData メソッドを使用して、サポートされているデータベース ソースからデータをクエリする: プロジェクト レベルの Gemini データ分析データ クエリ ユーザー（roles/geminidataanalytics.queryDataUser）。
  • プロジェクト内のすべてのデータ エージェントを作成、編集、共有、削除する: プロジェクト レベルの Gemini データ分析データ エージェント オーナー（roles/geminidataanalytics.dataAgentOwner）。
  • プロジェクトで独自のデータ エージェントを作成する: プロジェクト レベルの Gemini データ分析データ エージェント作成者（roles/geminidataanalytics.dataAgentCreator）。このロールにより、作成したデータ エージェントに対する Gemini データ分析データ エージェント オーナーのロールが自動的に付与されます。
  • プロジェクト内のすべてのデータ エージェントを表示、編集する: プロジェクト レベルの Gemini データ分析データ エージェント編集者（roles/geminidataanalytics.dataAgentEditor）。
  • プロジェクト内のすべてのデータ エージェントを表示する: プロジェクト レベルの Gemini データ分析データ エージェント閲覧者（roles/geminidataanalytics.dataAgentViewer）。

また、データ エージェントを作成または編集するには、次のロールが必要です。

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

  • Google Cloud IAM: クラウド リソースとしてデータベース インスタンスへのアクセスを制御します。これには、executeSql 権限を使用して SQL クエリを実行する権限など、接続、インスタンスの管理、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. コンソールで、Cloud SQL for MySQL のページに移動します。 Google Cloud

    Cloud SQL に移動

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

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

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

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

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

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

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

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

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

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

会話を管理する

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

既存の会話を開く

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

    Cloud SQL に移動

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

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

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

会話の名前を変更する

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

    Cloud SQL に移動

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

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

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

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

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

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

会話を削除する

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

    Cloud SQL に移動

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

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

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

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

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

ロケーション

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

次のステップ