会話でデータを分析する

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

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

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

始める前に

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

  2. AlloyDB for PostgreSQL、Gemini を使用した Data Analytics API、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.dataAgentCreator）。このロールにより、作成したデータ エージェントに対する Gemini データ分析データ エージェント オーナー ロールが自動的に付与されます。
  • プロジェクト内のすべてのデータ エージェントを編集、共有、削除する: プロジェクト レベルの Gemini データ分析データ エージェント オーナー（roles/geminidataanalytics.dataAgentOwner）。
  • プロジェクト内のすべてのデータ エージェントを表示、編集する: プロジェクト レベルの Gemini データ分析データ エージェント編集者（roles/geminidataanalytics.dataAgentEditor）。
  • プロジェクト内のすべてのデータ エージェントを表示する: プロジェクト レベルの Gemini データ分析データ エージェント閲覧者（roles/geminidataanalytics.dataAgentViewer）。

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

テーブルの表示やクエリの実行など、AlloyDB リソースを操作するには、 AlloyDB の IAM ロールと権限をご覧ください。

会話の作成

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

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

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

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

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

    AlloyDB に移動する

  2. リストからクラスタを選択します。

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

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

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

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

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

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

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

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

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

会話を管理する

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

既存の会話を開く

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

    AlloyDB に移動する

  2. リストからクラスタを選択します。

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

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

会話の名前を変更する

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

    AlloyDB に移動する

  2. リストからクラスタを選択します。

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

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

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

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

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

会話を削除する

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

    AlloyDB に移動する

  2. リストからクラスタを選択します。

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

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

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

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

ロケーション

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

次のステップ