会話でデータを分析する

プレビュー

この機能は、サービス固有規約の「一般サービス規約」セクションの「一般提供前のサービス規約」の対象となります。pre-GA の機能は「現状のまま」で提供されるものであり、サポートが制限されることがあります。 詳細については、リリース ステージの説明をご覧ください。

このドキュメントでは、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 権限が必要です。プロジェクトを作成した場合は、オーナーロール（roles/owner）を介してこの権限がすでに付与されている可能性があります。それ以外の場合は、Service Usage 管理者ロール（roles/serviceusage.serviceUsageAdmin）を介してこの権限を取得できます。ロールを付与する方法を確認する。

   API を有効にする

必要なロール

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

ユースケース	必要なロール
エージェントの作成、編集、公開、共有、削除	プロジェクトにデータ エージェントを作成する: プロジェクトに対する Gemini Data Analytics Data Agent Creator（roles/geminidataanalytics.dataAgentCreator）。このロールにより、作成したデータ エージェントに対する Gemini データ分析 Data Agent Owner のロールが自動的に付与されます。 データ エージェントを編集、共有、削除する: エージェントまたはプロジェクトに対する Gemini データ分析 Data Agent Owner（roles/geminidataanalytics.dataAgentOwner）。 プロジェクト内のデータ エージェントを編集する: プロジェクトに対する Gemini データ分析 Data Agent Editor（roles/geminidataanalytics.dataAgentEditor）。 プロジェクト内のデータ エージェントを表示する: プロジェクトに対する Gemini データ分析データ エージェント閲覧者（roles/geminidataanalytics.dataAgentViewer）。 さらに、データ エージェントを作成または編集するには、次のロールが必要です。 インスタンスに追加された IAM ユーザーまたはサービス アカウント。詳細については、Cloud SQL の IAM データベース認証でユーザーを管理するをご覧ください。 プロジェクト レベルで IAM ユーザーに付与された cloudsql.studioUser ロールと cloudsql.instanceUser ロール。詳細については、プロジェクトの IAM ポリシー バインディングを追加するをご覧ください。 省略可: データベース データ エージェントでコンテキスト セット（プレビュー）を使用する場合、コンテキスト セットを作成、アップロード、管理するには、プロジェクト レベルで IAM ユーザーに付与された Dataplex Catalog 編集者（roles/dataplex.catalogEditor）ロールまたは Dataplex Catalog 管理者（roles/dataplex.catalogAdmin）ロール。詳細については、コンテキスト セットの権限をご覧ください。 postgres ユーザーとしてログインして、IAM ユーザーまたはサービス アカウントに付与されたデータベース権限。 GRANT ALL ON SCHEMA public TO public; 詳細については、個々の IAM ユーザーまたはサービス アカウントにデータベース権限を付与するをご覧ください。
Gemini Enterprise でエージェントをプロビジョニングする	公開されたエージェントを Gemini Enterprise のユーザーが利用できるようにするには、Gemini Enterprise 管理コンソールで A2A エージェントを登録して管理する権限が必要です。
エージェントを見つけて使用する	データ エージェントとチャットする: Gemini データ分析データ エージェント ユーザー（roles/geminidataanalytics.dataAgentUser）。 プロジェクト内のすべてのデータ エージェントを表示する: Gemini Data Analytics Data Agent Viewer（roles/geminidataanalytics.dataAgentViewer）。

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

• Google Cloud IAM: クラウドリソースとしてデータベース インスタンスへのアクセスを制御します。これには、接続、インスタンスの管理、SQL クエリの実行（executeSql 権限の使用など）を行う権限が含まれます。
• データベース権限: テーブル、ビュー、スキーマなど、データベース内のオブジェクトへのアクセスを制御します。これらは、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. Google Cloud コンソールで、[Cloud SQL for PostgreSQL] ページに移動します。

   Cloud SQL に移動

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

3. ナビゲーション メニューで [会話] をクリックします。

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

5. [Start a Conversation] をクリックします。新しいチャットパネルが開きます。

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

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

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

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

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

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

会話を管理する

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

既存の会話を開く

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

   Cloud SQL に移動

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

3. ナビゲーション メニューで [会話] をクリックします。

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

会話の名前を変更する

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

   Cloud SQL に移動

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

3. ナビゲーション メニューで [会話] をクリックします。

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

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

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

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

会話を削除する

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

   Cloud SQL に移動

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

3. ナビゲーション メニューで [会話] をクリックします。

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

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

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

ロケーション

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

次のステップ

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