データエージェントを作成する

このドキュメントでは、BigQuery でデータエージェントを作成、編集、削除する方法について説明します。データエージェントには、テーブルメタデータとユースケース固有のクエリ処理の指示が含まれています。これらにより、選択した一連のテーブルに関するユーザーからの質問に答える最適な方法を定義します。ユーザーは、このように構成されたデータエージェントと会話し、自然言語で BigQuery データに関する質問をすることができます。

始める前に

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
- Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector
Verify that billing is enabled for your Google Cloud project.
Enable the BigQuery, Gemini Data Analytics, and Gemini for Google Cloud API APIs.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.
Enable the APIs

必要なロール

データエージェントを操作するには、次のいずれかの Conversational Analytics API IAM ロールが必要です。

プロジェクト内のすべてのデータエージェントを作成、編集、共有、削除する: プロジェクトに対する Gemini データ分析データエージェントオーナー（roles/geminidataanalytics.dataAgentOwner）。
プロジェクトで独自のデータエージェントを作成、編集、共有、削除する: プロジェクトに対する Gemini データ分析データエージェント作成者（roles/geminidataanalytics.dataAgentCreator）。このロールを持つユーザーには、作成したデータエージェントに対する Gemini データ分析データエージェントオーナーのロールが自動的に付与されます。
プロジェクト内のすべてのデータエージェントを表示、編集する: プロジェクトレベルの Gemini データ分析データエージェント編集者（roles/geminidataanalytics.dataAgentEditor）。
プロジェクト内のすべてのデータエージェントを表示する: Gemini データ分析データエージェント閲覧者（roles/geminidataanalytics.dataAgentViewer）。

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

データエージェントがデータソースとして使用するテーブルに対する BigQuery データ閲覧者（roles/bigquery.dataViewer）。
プロジェクトに対する DataCatalog 検索管理者（roles/datacatalog.searchAdmin）。
データソーステーブルで列レベルのアクセス制御が使用されている場合は、適切なポリシータグに対するきめ細かい読み取り（roles/datacatalog.categoryFineGrainedReader）。詳細については、列レベルのアクセス制御で使用されるロールをご覧ください。
データソーステーブルで行レベルのアクセス制御が使用されている場合は、そのテーブルに対するロールレベルのアクセスポリシーが付与されている必要があります。詳細については、行レベルのアクセスポリシーを作成または更新するをご覧ください。
データソーステーブルでデータマスキングが使用されている場合は、適切なデータポリシーに対するマスクされた読み取り（roles/bigquerydatapolicy.maskedReader）。詳細については、マスクされたデータに対してクエリを実行するためのロールをご覧ください。

分析情報を生成する

必要に応じて、データソースとして使用するテーブルの分析情報を生成します。生成された分析情報は、データエージェントがユーザーからの質問に対する回答を生成するために利用できるテーブルメタデータを提供します。詳細については、BigQuery テーブルの分析情報を生成するをご覧ください。

分析情報を事前に生成していない場合は、データエージェントの作成時にテーブルをデータソースとして選択したときに、分析情報が自動的に生成されます。

データエージェントを作成する

データエージェントを作成する手順は次のとおりです。

BigQuery の [エージェント] ページに移動します。

[エージェント] ページに移動
[エージェント] タブを選択します。
[新しいエージェント] をクリックします。[新しいエージェント] ページが開きます。
[エディタ] セクションの [エージェント名] フィールドに、データエージェントのわかりやすい名前を入力します。
[エージェントの説明] フィールドに、データエージェントの説明を入力します。適切な説明を付けておくと、ユーザーがチャット相手とするデータエージェントを選択する際に役立ちます。
[データソース] セクションで、[データを追加] をクリックします。[データを追加] ページが開きます。
[最近使用したアイテム] セクションで、データソースとして使用するテーブルを選択します。
省略可: [最近使用したアイテム] セクションにリストされていないテーブルを追加します。
1. [検索] セクションの [テーブルを検索] フィールドにテーブル名を入力し、Enter キーを押します。テーブル名は正確でなくてもかまいません。
2. [検索結果] セクションで、1 つ以上のテーブルを選択します。
[データを追加] をクリックします。新しいエージェントページが再度開きます。
省略可: データエージェントの正確さを高めるために、追加のテーブルメタデータを提供できます。このメタデータはデータエージェントによってのみ使用されるもので、ソーステーブルには影響しません。
1. [データソース] セクションで、テーブルの [精度の向上] をクリックします。
2. テーブルの説明を作成します。[テーブルの説明] フィールドに説明を入力するか、Gemini からの提案を受け入れます。
3. [フィールド] セクションで、Gemini から提案されたフィールドの説明を確認します。受け入れる候補を選択して、[提案を承認する] をクリックします。却下する候補を選択して、[提案を拒否] をクリックします。
4. フィールドの説明を手動で編集するには、フィールドの横にある [編集] をクリックします。[フィールドを編集] ペインが開きます。
5. [説明] フィールドに、フィールドの説明を入力します。
6. [更新] をクリックします。
7. [更新] をクリックします。新しいエージェントページが再度開きます。
[手順] セクションの [エージェントへの指示] フィールドに、データエージェントへの指示を入力します。データエージェントは、これらの指示に基づいてユーザーからの質問のコンテキストを理解します。たとえば、次のような情報を指示に含めることができます。
- 主なフィールド: 分析に関して最も重要なフィールド。
- 類義語: 主なフィールドの代替用語。
- 除外済みフィールド: データエージェントが使用を避けるべきフィールド。
- フィルタリングとグループ化: エージェントがデータのフィルタリングとグループ化に使用するフィールド。
- 結合関係: 2 つ以上のテーブルが互いにどのように関連付けられているか、およびどの列で結合されているか。
[例を表示] をクリックすると、指示の例が表示されます。
省略可: データエージェントのゴールデンクエリを作成します。データエージェントはゴールデンクエリを使用して、選択されたデータソースに対してデータエージェントをチューニングします。これにより、データエージェントによって使用されるモデルが、組織で使用されているビジネスロジックを学習できます。
1. Gemini から提案されたゴールデンクエリを 1 つ以上選択します。
  1. [ゴールデンクエリ] セクションで、[候補の確認] をクリックします。[提案されたゴールデンクエリを確認する] ページが開きます。
  2. 提案されたゴールデンクエリを確認します。目的のユースケースに該当するものを選択します。
  3. [追加] をクリックします。新しいエージェントページが再度開きます。
2. 独自のゴールデンクエリを作成する場合は、[クエリを追加] をクリックします。[ゴールデンクエリの追加] ページが開きます。
  1. [質問] フィールドに、そのゴールデンクエリで回答するユーザーからの質問を入力します。
  2. [SQL を生成] をクリックして、指定したユーザーの質問に対応するゴールデンクエリを Gemini に生成させます。
  3. 必要に応じて、ゴールデンクエリを修正します。
  4. [実行] をクリックし、クエリが想定どおりの結果を返すことを確認します。
  5. [追加] をクリックします。新しいエージェントページが再度開きます。
3. 必要に応じて、上記の手順を繰り返して追加のゴールデンクエリを作成します。
省略可: データエージェントがユーザーの質問に対する回答を生成するときに、SQL ではなく Python を使用するように構成します。[設定] セクションで、[高度な分析] 切り替えボタンをクリックします。

このオプションは、予測、相関関係、因果関係を必要とするものなど、SQL では対処が困難または不可能な複雑な質問にデータエージェントが回答することを想定している場合に使用します。
省略可: データエージェントによって処理されるクエリのサイズ上限を設定します。[設定] セクションの [課金される最大バイト数] フィールドに値を入力します。

ここに値を指定しない場合、課金される最大バイト数は、プロジェクトの 1 日あたりのクエリ使用量の割り当てにデフォルト設定されます。カスタム割り当てを指定していない限り、1 日あたりの使用量の割り当ては無制限です。
[プレビュー] セクションの [質問する] フィールドにユーザーからの質問の例を入力し、Enter キーを押します。データエージェントの回答を読んで、想定どおりのデータが返されたことを確認します。回答が適切でない場合は、[エディタ] アクションで設定を変更して、満足のいく回答が得られるまでデータエージェントの構成を繰り返します。エージェントのテストと修正を反復することで、エージェントの結果を改善できます。
[保存] をクリックします。
データエージェントの構成を続ける場合は、 [戻る] をクリックして [エージェント] ペインに戻ります。

それ以外の場合は、次のステップに進みます。
[公開] をクリックしてデータエージェントを公開し、プロジェクトでデータエージェントを使用できるようにします。BigQuery Studio を使用してデータエージェントとの会話を作成できます。Looker Studio のサブスクリプションをお持ちの場合は、Looker Studio を使用して会話を作成することもできます。また、Conversational Analytics API を使用して、データエージェントとチャットする独自のインターフェースを構築することもできます。
[エージェントが公開されました] ダイアログで [共有] をクリックして、データエージェントを他のユーザーと共有します。
[共有権限] ペインで、[プリンシパルを追加] をクリックします。
[新しいプリンシパル] フィールドに、1 つ以上のプリンシパルを入力します。
[ロールを選択] プルダウンをクリックします。
[ロール] リストで、次のいずれかのロールを選択します。
- Gemini データ分析データエージェントユーザー（roles/geminidataanalytics.dataAgentUser）: データエージェントとチャットする権限を付与します。
- Gemini データ分析データエージェント編集者（roles/geminidataanalytics.dataAgentEditor）: データエージェントを編集する権限を付与します。
- Gemini データ分析データエージェント閲覧者（roles/geminidataanalytics.dataAgentViewer）: データエージェントを表示する権限を付与します。
[保存] をクリックします。
新しいエージェントページに戻るには、[閉じる] をクリックします。

データエージェントを編集する

データエージェントを編集する手順は次のとおりです。

BigQuery の [エージェント] ページに移動します。

[エージェント] ページに移動
[エージェント] タブを選択します。
変更するデータエージェントのエージェントカードを見つけます。
エージェントカードで [アクションを開く] > [編集] をクリックして、データエージェントをエージェントエディタで開きます。
データエージェントの構成を必要に応じて編集します。
[保存] をクリックして、変更を保存します。
[公開] をクリックして、変更を公開します。
[戻る] をクリックして、[エージェント] ペインに戻ります。

データエージェントを共有する

データエージェントを共有する手順は次のとおりです。

BigQuery の [エージェント] ページに移動します。

[エージェント] ページに移動
[エージェント] タブを選択します。
変更するデータエージェントのエージェントカードを見つけます。
エージェントカードで [アクションを開く] > [編集] をクリックして、データエージェントをエージェントエディタで開きます。
[共有] をクリックして、データエージェントを他のユーザーと共有します。
[共有権限] ペインで、[プリンシパルを追加] をクリックします。
[新しいプリンシパル] フィールドに、1 つ以上のプリンシパルを入力します。
[ロールを選択] プルダウンをクリックします。
[ロール] リストで、次のいずれかのロールを選択します。
- Gemini データ分析データエージェントユーザー（roles/geminidataanalytics.dataAgentUser）: データエージェントとチャットする権限を付与します。
- Gemini データ分析データエージェント編集者（roles/geminidataanalytics.dataAgentEditor）: データエージェントを編集する権限を付与します。
- Gemini データ分析データエージェント閲覧者（roles/geminidataanalytics.dataAgentViewer）: データエージェントを表示する権限を付与します。
[保存] をクリックします。
エージェントの編集ページに戻るには、[閉じる] をクリックします。
[戻る] をクリックして、[エージェント] ペインに戻ります。

データエージェントを削除する

データエージェントを削除する手順は次のとおりです。

BigQuery の [エージェント] ページに移動します。

[エージェント] ページに移動
[エージェント] タブを選択します。
[エージェント] タブの [自分のエージェント] セクションで、削除するデータエージェントのエージェントカードを見つけます。
[アクションを開く] > [削除] をクリックします。
[エージェントを削除しますか？] ダイアログで、[削除] をクリックします。

ロケーション

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

次のステップ

BigQuery の会話型分析について詳細を確認する。
Conversational Analytics API について詳細を確認する。
会話でデータを分析する。

データ エージェントを作成する

始める前に

必要なロール

分析情報を生成する

データ エージェントを作成する

データ エージェントを編集する

データ エージェントを共有する

データ エージェントを削除する

ロケーション

次のステップ

データエージェントを作成する

データエージェントを作成する

データエージェントを編集する

データエージェントを共有する

データエージェントを削除する