Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

会話でデータを分析する

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

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

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

始める前に

プロジェクト Google Cloud に対して課金が有効になっていることを確認します。
AlloyDB for PostgreSQL、Gemini を使用した Data Analytics API、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 データ分析データエージェント作成者（`roles/geminidataanalytics.dataAgentCreator`）。このロールにより、作成したデータエージェントに対する Gemini データ分析データエージェントオーナーロールが自動的に付与されます。データエージェントを編集、共有、削除するには: エージェントまたはプロジェクトに対する Gemini データ分析データエージェントオーナー（`roles/geminidataanalytics.dataAgentOwner`）。プロジェクトでデータエージェントを編集するには: プロジェクトに対する Gemini データ分析データエージェント編集者（`roles/geminidataanalytics.dataAgentEditor`）。プロジェクトでデータエージェントを表示するには: プロジェクトに対する Gemini データ分析データエージェント閲覧者（`roles/geminidataanalytics.dataAgentViewer`）。また、データエージェントを作成または編集するには、次のロールが必要です。データベースレベルでクラスタに追加された IAM ユーザーまたはサービスアカウント。詳細については、データベースユーザーを管理するをご覧ください。プロジェクトレベルで IAM ユーザーに付与された `alloydb.databaseUser` ロールと `serviceusage.serviceUsageConsumer` 権限。詳細については、プロジェクトの IAM ポリシーバインディングを追加するをご覧ください。
Gemini Enterprise でエージェントをプロビジョニングする	公開されたエージェントを Gemini Enterprise のユーザーが利用できるようにするには、Gemini Enterprise 管理コンソールで A2A エージェントを登録して管理する権限が必要です。
エージェントを検出して使用する	データエージェントとチャットするには: Gemini データ分析データエージェントユーザー（`roles/geminidataanalytics.dataAgentUser`）。プロジェクト内のすべてのデータエージェントを表示するには: Gemini データ分析データエージェント閲覧者（`roles/geminidataanalytics.dataAgentViewer`）。

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

会話の作成

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

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

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

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

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

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

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

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

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

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

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

会話を管理する

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

既存の会話を開く

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

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

会話の名前を変更する

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

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

会話を削除する

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

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

ロケーション

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