このドキュメントでは、Spanner で会話を作成、編集、削除する方法について説明します。会話とは、 データエージェントとの 永続的なチャットです。
テーブル フィールド名を指定したり、データのフィルタ条件を定義したりすることなく、「売上」や「最も人気がある」といった一般的な言葉を使用してデータ エージェントにマルチパートの質問をすることができます。チャット回答では、質問に対する回答がテキストとコードで提供され、必要に応じてグラフが生成されます。回答には、それらの結果の背後にある推論も含まれます。
データ エージェントとの会話を作成できます。直接会話を作成すると、 会話型分析 API は、データエージェントから提供されるコンテキストと処理の指示を使用せずにユーザーからの質問を解釈します。
始める前に
-
Spanner、Data Analytics API with Gemini、Gemini for Google Cloud APIs. を有効にします。
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 ユーザーまたはサービス アカウント。詳細については、 「 IAM ロールを適用する」をご覧ください。
- プロジェクト レベルで IAM ユーザーに付与された
spanner.databaseReaderロール。詳細については、 プロジェクトの IAM ポリシー バインディングを追加するをご覧ください。 - 必要なデータベースに対して、プロジェクト レベルで IAM ユーザーに付与されたロールと権限。詳細については、 ロールと権限を付与するをご覧ください。
Spanner リソースの操作については、 Spanner のロールと権限をご覧ください。
会話の作成
Spanner 用コンソールの [エージェント] ページの [エージェント カタログ] タブで、エージェントまたはデータソースとの永続的な会話を作成できます。 Google Cloud
データ エージェントとの会話を作成する
データ エージェントとの会話を作成するには、まず データ エージェントを作成 して公開します。他のユーザーが共有したエージェントとの会話を開始することもできます。
コンソールでデータ エージェントとの会話を作成する手順は次のとおりです。 Google Cloud
コンソールで、[Spanner] ページに移動します。 Google Cloud
リストからインスタンスを選択し、データベースを選択します。
ナビゲーション メニューで、[エージェント] をクリックします。
[自分のエージェント] セクションまたは [組織内の他のユーザーと共有] セクションで、チャットするエージェントのエージェント カードをクリックします。
[会話を開始] をクリックします。新しいチャットパネルが開きます。
[質問する] フィールドに、データ エージェントへの質問を入力します。 たとえば、「前四半期の総売上はいくらでしたか？」や「セッション時間の上位 5 人のユーザーを表示してください」などです。Gemini が提案した質問のいずれかをクリックして開始することもできます。
データ エージェントは、質問に対処するために実行するアクションを述べ、結果を返します。
データ エージェントが質問に対する回答を提供するまでの各ステップを確認するには、[推論を表示] をクリックして、エージェントの推論プロセスの各メッセージを表示します。
結果の計算方法に関する情報を確認するには、 [How was this calculated?] をクリックします。[概要] セクションに、生成されたクエリとクエリ結果が表示されます。コードをコピーして [Studio] をクリックすると、クエリエディタにコードを貼り付けることができます。
データに適している場合は、データ エージェントがグラフ、表、その他の可視化も提供します。チャットの履歴を表示するには、[会話の管理] リストに移動します。
エージェント情報を表示するには、[詳細] パネルに移動します。このパネルには、エージェントとそのナレッジソースの説明が表示されます。
会話を管理する
会話は、[エージェント] ページで開いたり、名前を変更したり、削除したりできます。
既存の会話を開く
コンソールで、[Spanner] ページに移動します。 Google Cloud
リストからインスタンスを選択し、データベースを選択します。
ナビゲーション メニューで、[エージェント] をクリックします。
[会話] タブの会話リストで、開く会話をクリックします。
会話の名前を変更する
コンソールで、[Spanner] ページに移動します。 Google Cloud
リストからインスタンスを選択し、データベースを選択します。
ナビゲーション メニューで、[エージェント] をクリックします。
[会話] タブの会話リストで、名前を変更する会話をクリックします。
[アクションを表示] > [名前を変更] をクリックします。
[会話の名前を変更する] ダイアログの [会話名] フィールドに、会話の新しい名前を入力します。
[名前を変更] をクリックします。
会話を削除する
コンソールで、[Spanner] ページに移動します。 Google Cloud
リストからインスタンスを選択し、データベースを選択します。
ナビゲーション メニューで、[エージェント] をクリックします。
[会話] タブの会話リストで、削除する会話をクリックします。
[アクションを表示] > [削除] をクリックします。
[会話を削除しますか？] ダイアログで、[削除] をクリックします。
ロケーション
会話型分析はグローバルに運用されており、使用するリージョンを選択することはできません。
次のステップ
- Spanner の会話型分析の詳細を確認する。
- 会話型分析 API について詳細を確認する。
- Spanner でデータ エージェントを作成する。