会話でデータを分析する

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

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

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

始める前に

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

  2. Spanner、Data Analytics API with Gemini、Gemini for Google Cloud APIs. を有効にします。

    API を有効にするために必要なロール

    API を有効にするには、serviceusage.services.enable 権限が必要です。プロジェクトを作成した場合は、オーナーロール（roles/owner）を通じてこの権限が付与されている可能性があります。それ以外の場合は、Service Usage 管理者ロール（roles/serviceusage.serviceUsageAdmin）を通じてこの権限を取得できます。ロールを付与する方法をご覧ください。

    API を有効にする

必要なロール

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

ユースケース 必要なロール
エージェントの作成、編集、公開、共有、削除
  • プロジェクトでデータ エージェントを作成するには: プロジェクトに対する Gemini データ分析データ エージェント作成者（roles/geminidataanalytics.dataAgentCreator）。このロールにより、作成したデータ エージェントに対する Gemini データ分析データ エージェント オーナー ロールが自動的に付与されます。
  • データ エージェントを編集、共有、削除するには: エージェントまたはプロジェクトに対する Gemini データ分析データ エージェント オーナー（roles/geminidataanalytics.dataAgentOwner）。
  • プロジェクトでデータ エージェントを編集するには: プロジェクトに対する Gemini データ分析データ エージェント編集者（roles/geminidataanalytics.dataAgentEditor）。
  • プロジェクトでデータ エージェントを表示するには: プロジェクトに対する Gemini データ分析データ エージェント閲覧者（roles/geminidataanalytics.dataAgentViewer）。
  • また、データ エージェントを作成または編集するには、次のロールが必要です。
Gemini Enterprise でエージェントをプロビジョニングする

公開されたエージェントを Gemini Enterprise のユーザーが利用できるようにするには、Gemini Enterprise 管理コンソールで A2A エージェントを登録して管理する権限が必要です。
エージェントの検出と使用
  • データ エージェントとチャットするには: Gemini データ分析データ エージェント ユーザー（roles/geminidataanalytics.dataAgentUser）。
  • プロジェクト内のすべてのデータ エージェントを表示するには: Gemini データ分析データ エージェント閲覧者（roles/geminidataanalytics.dataAgentViewer）。

Spanner リソースを操作するには、 Spanner のロールと権限をご覧ください。

会話の作成

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

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

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

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

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

    Spanner に移動

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

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

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

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

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

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

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

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

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

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

会話を管理する

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

既存の会話を開く

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

    Spanner に移動

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

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

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

会話の名前を変更する

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

    Spanner に移動

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

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

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

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

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

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

会話を削除する

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

    Spanner に移動

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

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

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

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

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

ロケーション

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

次のステップ