会話でデータを分析する

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

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

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

始める前に

Google Cloud プロジェクトに対して課金が有効になっていることを確認します。
Cloud SQL、Data Analytics API with Gemini、Gemini for Google Cloud API を有効にします。
API を有効にするために必要なロール
API を有効にするには、serviceusage.services.enable 権限を含む Service Usage 管理者 IAM ロール（roles/serviceusage.serviceUsageAdmin）が必要です。詳しくは、ロールを付与する方法をご覧ください。
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）。

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

インスタンスに追加された IAM ユーザーまたはサービスアカウント。詳細については、Cloud SQL の IAM データベース認証でユーザーを管理するをご覧ください。
プロジェクトレベルで IAM ユーザーに付与された cloudsql.studioUser ロールと cloudsql.instanceUser ロール。詳細については、プロジェクトの IAM ポリシーバインディングを追加するをご覧ください。
postgres ユーザーとしてログインして、IAM ユーザーまたはサービスアカウントに付与されたデータベース権限。
```
GRANT ALL ON SCHEMA public TO public;
```
詳細については、個々の IAM ユーザーまたはサービスアカウントにデータベース権限を付与するをご覧ください。

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 データベース認証でユーザーを管理するをご覧ください。

会話の作成

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

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

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

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

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

Cloud SQL に移動
リストからインスタンスを選択します。
ナビゲーションメニューで [エージェント] をクリックします。
[自分のエージェント] セクションまたは [組織内の他のユーザーが共有] セクションで、チャットするエージェントのエージェントカードをクリックします。
[会話を開始] をクリックします。新しいチャットパネルが開きます。
[質問する] フィールドに、データエージェントに対する質問を入力します。たとえば、「前四半期の総売上はいくらでしたか？」や「セッション時間の長い上位 5 人のユーザーを表示して」などです。Gemini が提案した質問のいずれかをクリックして開始することもできます。

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

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

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

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

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

会話を管理する

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

既存の会話を開く

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

Cloud SQL に移動
リストからインスタンスを選択します。
ナビゲーションメニューで [エージェント] をクリックします。
[会話] タブの会話リストで、開く会話をクリックします。

会話の名前を変更する

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

Cloud SQL に移動
リストからインスタンスを選択します。
ナビゲーションメニューで [エージェント] をクリックします。
[会話] タブの会話リストで、名前を変更する会話をクリックします。
[アクションを表示] > [名前を変更] をクリックします。
[会話の名前を変更する] ダイアログの [会話名] フィールドに、会話の新しい名前を入力します。
[名前を変更] をクリックします。

会話を削除する

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

Cloud SQL に移動
リストからインスタンスを選択します。
ナビゲーションメニューで [エージェント] をクリックします。
[会話] タブの会話リストで、削除する会話をクリックします。
[アクションを表示] > [削除] をクリックします。
[会話を削除しますか？] ダイアログで、[削除] をクリックします。

ロケーション

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

次のステップ

Cloud SQL for PostgreSQL の会話分析の詳細を確認する。
会話型分析 API について詳細を確認する。
Cloud SQL for PostgreSQL にデータエージェントを作成します。