Explore データ エージェントを作成して管理する

データ エージェントを使用すると、ユーザー向けの会話型分析のエクスペリエンスをキュレートできます。エージェントを使用すると、特定のユースケースで質問に効果的に回答できるように、会話型分析にコンテキストと指示を提供できます。エージェントにより、アナリストはビジネス用語を特定のフィールドにマッピングし、フィルタリングに最適なフィールドを指定して、カスタム計算を定義できます。

このページでは、次のプロセスについて説明します。

Gemini for Google Cloud がデータを使用する方法とタイミングに関する説明をご覧ください。

始める前に

会話分析の使用は、コンテンツ アクセス、データアクセス、機能アクセスの組み合わせによって管理されます。データ エージェントは、ダッシュボード、Look、フォルダなど、別のタイプの Looker コンテンツと考えてください。データ エージェントを操作するには、個々の Explore の基盤となるモデル、またはデータ エージェントがクエリするモデルに必要な権限を持つ Looker ロールが割り当てられている必要があります。場合によっては、エージェント自体へのアクセスも必要になります。

データ エージェントの管理と使用に必要な権限とアクセス権の詳細については、Looker で会話分析を設定するのドキュメント ページの権限の表をご覧ください。

会話型分析の Explore エージェントは、Looker 管理者が [Gemini in Looker] 管理ページで次の機能を有効にしている場合に利用できます。

  • 会話分析:
    • 会話型分析（会話ページ）: この設定をオンにすると、Explore と Explore との直接チャットを行うデータ エージェントが [会話] ページにアクセスできるようになります。
  • その他のオプション:
    • 高度な分析: エージェントが高度な分析を使用できるようにするには、[高度な分析] 設定をオンにします。高度な分析では、自然言語の質問が Python コードに変換され、そのコードが実行されて高度な分析と可視化が提供されます。この設定は省略可能です。
  • Trusted Tester の機能を有効にする

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

新しいデータ エージェントを作成するには、次のステップを実施する:

  1. [会話] ページに移動します。
  2. [エージェント] タブで、[+ 新しいエージェント] を選択します。または、左側のパネルで spark[エージェントを管理] を選択し、[+ 新しいエージェント] を選択します。

  3. [新しいエージェント] ページで、データ エージェントに関する次の情報を入力します。

    • エージェント名: エージェントの名前を入力します。名前は一意で、わかりやすいものにする必要があります。
    • エージェントの説明: このエージェントでできることと、使用するデータについて簡単に説明します。この説明は、ユーザーがエージェントを選択して会話を開始するときや、エージェントを共有するときに表示されます。そのため、エージェントの目的と、エージェントがどのように役立つかを明確に説明してください。
    • データ: 次の手順に沿って、既存の Looker Explore に最大 5 つ接続します。
      1. [データ] フィールドで、[+ Explore を選択] をクリックします。
      2. [Search Explores] ウィンドウで、データ エージェントに含める Explore をクリックします。これらの Explore は、ウィンドウの [選択した Explore] パネルに表示されます。
      3. 選択した Explore をデータ エージェントに追加するには、[保存] をクリックします。

  4. 手順: 会話分析がデータを操作して正確で関連性の高い回答を提供する方法を理解できるように、コンテキストを指定します。入力できるコンテキストの種類の例については、エージェントの指示を作成するをご覧ください。

  5. 必要に応じて、[詳細オプション] を選択してセクションを開き、次の設定を構成します。

    • 高度な分析を有効にする: この設定をオンにすると、エージェントとのすべての会話で高度な分析が有効になります。
    • 思考を表示: この切り替えをオンにすると、エージェントは各会話のすべての回答で、推論ステップ、生成された Looker クエリ、基になるデータテーブルを表示できます。
    • デバッグ情報を表示: この切り替えをオンにすると、エージェントは各会話のすべての回答に対して実行したステップを表示できます。

  6. 必要に応じて、エージェントをテストして、手順とその設定を調整できます。

  7. 新しいデータ エージェントを保存するには、[保存] をクリックする。

データ エージェントを保存したら、他のユーザーとエージェントを共有したり、エージェントと会話を開始したりできます。

エージェントへの指示を作成する

データ エージェントを作成する際に、データ エージェントのコア動作を定義する自由形式の指示を追加し、ユーザーのプロンプトを処理する前に考慮すべき基本的なコンテキストを提供できます。

[手順] フィールドで指定できるコンテキストの例をいくつか示します。

  • 主なフィールド: 分析に関して最も重要なフィールド
  • 除外済みフィールド: データ エージェントが回避するフィールド
  • フィルタリングとグループ化: エージェントがデータのフィルタリングとグループ化に使用するフィールド
  • ペルソナ: エージェントに割り当てる役割、専門知識、キャラクター、トーン

エージェントの指示を作成する際のヒントとベスト プラクティスについては、Looker での会話分析の構成に関するベスト プラクティスのドキュメント ページをご覧ください。

検証済みクエリを定義する

検証済みクエリ（Google のドキュメントではゴールデン クエリとも呼ばれます）は、自然言語の質問と、それに対応する正確な Looker Explore クエリの事前定義されたペアです。これらの質問とクエリのペアは、エージェントに複雑なビジネス リクエストを推測せずに処理する方法を教える、検証済みの真実の「ゴールド スタンダード」として機能します。明確に定義された検証済みクエリを使用すると、Explore データ エージェントからのレスポンスの精度を高めることができます。

検証済みクエリの制限事項

検証済みクエリを使用する場合は、次の制限事項に注意してください。

  • 検証済みクエリは、Explore データ エージェントでのみ使用できます。Explore との直接チャットやダッシュボード データ エージェントでは使用できません。
  • エージェント用にすでに定義されている Explore を使用する必要があります。データ エージェントで使用されていない Explore を参照すると、エラー メッセージ This query will not be used as it references an Explore that has not been defined in this agent. For best results, make sure that verified queries are based on Explores used in this agent. が表示されます。
  • 検証済みクエリは、カスタム フィールドまたはピボットを含む Explore クエリをサポートしていません。
  • 追加できる確認済みクエリの数に上限はありませんが、エージェントごとに 30 ～ 50 個の質問とクエリのペアを含めることをおすすめします。

確認済みのクエリを作成する

検証済みのクエリを新規または既存のデータ エージェントに追加する手順は次のとおりです。

  1. 新しいデータ エージェントを作成するか、少なくとも 1 つの Explore をデータソースとして使用する既存のデータ エージェントを編集します。
  2. エージェントの作成ページまたは編集ページで、[+ 検証済みクエリを追加] を選択します。
  3. [検証済みクエリを追加] で、自然言語の質問とそれに対応する回答を入力します。
    • 質問: ユーザーが質問する可能性のある自然言語の質問を入力します。
    • 回答: 正しいクエリまたはビジュアリゼーションをキャプチャする Explore の URL を貼り付けます。
  4. Explore クエリを確認するには、[プレビュー] をクリックします。
    • 別の方法: [回答] フィールドを空白のままにして [プレビュー] をクリックし、Explore ビルダーでクエリを最初から作成して、結果の URL を保存して使用します。
  5. [保存] をクリックします。

検証済みクエリを編集する

既存の検証済みクエリを編集する手順は次のとおりです。

  1. エージェントとの会話で、[エージェントを編集] を選択します。
  2. [検証済みクエリ] で、編集する検証済みクエリを見つけます。
  3. [ 検証済みクエリを編集] をクリックします。
  4. [検証済みクエリの編集] ダイアログで、質問または回答を変更します。
  5. [保存] をクリックします。

確認済みのクエリを削除する

検証済みクエリを削除する手順は次のとおりです。

  1. エージェントとの会話で、[エージェントを編集] を選択します。
  2. [確認済みのクエリ] で、削除する確認済みのクエリを見つけます。
  3. [検証済みクエリを削除] をクリックします。

エージェントをテストする

エージェントを作成または編集するときに、エージェントの詳細ページに [エージェントをプレビュー] ペインが表示されます。エージェントの設定と指示をテストするには、エージェントとの会話を開始します。

変更をプレビューに反映するには、[更新] をクリックする必要があります。保存ステータスが Not saved の場合、設定の更新はプレビューに反映されません。

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

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

  1. [会話] ページで、[spark] [エージェントを管理] を選択します。
  2. [エージェントの管理] ページで、編集するデータ エージェントを選択します。
  3. 必要に応じて、エージェントの詳細を更新します。エージェントの作成時に指定した詳細（エージェント名、エージェントの説明、データ、指示、詳細オプションの設定など）を変更できます。エージェントのコード インタープリタを有効にすることもできます。
  4. 変更を保存するには、[更新] をクリックします。

共有データ エージェント

共有すると、他のユーザーがエージェントとその Explore とチャットできるようになります。データ エージェントを他のユーザーと共有するには、エージェントへのコンテンツ アクセス権を付与します。エージェントを共有できるのは、適切な権限とコンテンツ アクセス権を持つユーザーのみです。エージェントが作成されてから、共有可能になるまでに数分かかることがあります。

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

  1. [会話] ページで、左側のパネルにある spark[エージェントを管理] を選択します。
  2. 選択したエージェントの [その他のオプション] アイコンをクリックしてメニューを開き、[共有] をクリックします。
  3. [このエージェントにアクセスできるユーザー] セクションに個人またはグループを追加し、付与する権限レベルを選択したら、[追加] をクリックして共有リストに追加します。
  4. 新しいユーザーまたはグループに通知メールを送信する場合は、[追加したユーザーにメールを送信する] チェックボックスをオンにします。
  5. 変更がすべて完了したら、[保存] をクリックします。

作成したばかりのエージェントや編集中のエージェントを共有するには、エージェントの設定ページで [共有] をクリックし、前述の手順に沿って操作します。

データ エージェントへのアクセス権を取り消す

エージェントへのアクセスを取り消す手順は次のとおりです。

  1. [会話] ページで、左側のパネルにある spark [エージェントを管理] をクリックします。
  2. 選択したエージェントの [その他のオプション] アイコンをクリックしてメニューを開き、[共有] をクリックします。
  3. アクセス権を削除するユーザーまたはグループの横にある X をクリックします。
  4. 変更がすべて完了したら、[保存] をクリックします。

削除されたユーザーが進行中の会話に参加している場合、変更が反映されるまで 1 ～ 2 分間はアクセスできます。

エージェントへのアクセス権が削除された後にユーザーがさらに質問しようとすると、The agent in this conversation may not be shared with you, or may have been deleted. You can view any past conversations with the agent, but can't ask new questions. というメッセージが表示されます。

データ エージェントを公開する

Gemini Enterprise でデータ エージェントを公開すると、Looker インターフェースに慣れていないユーザーを含む、より多くのユーザーがエージェントの事前定義されたコンテキストと分析を利用できるようになります。Gemini Enterprise は、 Google Cloud アプリケーション全体で作成されたデータ エージェントをユーザーが管理できる中央ハブとして機能します。これにより、ユーザーは分析ニーズに最適なエージェントを見つけることができます。

始める前に

Looker でデータ エージェントを作成し、Gemini Enterprise のユーザーが利用できるようにする手順には、Looker インスタンス、 Google Cloud コンソールの Gemini Enterprise ページ、Gemini Enterprise インスタンスで実行するタスクが含まれます。

次のロールを持つユーザーは、関連するセクションで説明されている手順に沿って操作する必要があります。

  1. データ エージェント編集者（Looker 機能）: Looker でエージェントを公開する。
  2. ディスカバリー エンジン管理者（IAM ロール）: Google Cloud コンソールでエージェントへのアクセス権を付与します。
  3. Gemini Enterprise 企業ユーザー（IAM ロール）、Data Agent User（Looker 機能）: Gemini Enterprise インスタンスでエージェントとチャットする。

エージェントを公開するには、次の要件を満たす必要があります。

  • Looker 管理者は、[管理パネル] の [Gemini in Looker] ページで、[Trusted Tester の機能を有効にする]、[Gemini Enterprise に公開する]、[会話型分析（スレッドページ）] の各設定を有効にする必要があります。
  • Looker 管理者は、publish_agent_externally 権限を含むロールを付与する必要があります。また、データ エージェントを編集できる必要があります。
  • Gemini Enterprise エンジンをホストする Google Cloud プロジェクトの Looker サービス アカウントに、Discovery Engine 管理者の Identity and Access Management ロールを付与する必要があります。このロールを付与すると、最初のエージェントが公開されたときに、Gemini Enterprise ライセンスがアカウントに割り当てられます。Looker サービス アカウントに割り当てることができる Gemini Enterprise ライセンスがない場合、 Google Cloud コンソールの Gemini Enterprise エンジンのページに「エージェント作成の数量に基づく割り当てを割り当てることができませんでした」というエラーが表示されます。Discovery Engine 管理者の Identity and Access Management ロールを持つユーザーは、Looker サービス アカウントの新しい Gemini Enterprise ライセンスをプロビジョニングするか、既存のライセンスを再割り当てする必要があります。

データ エージェントを Gemini Enterprise に公開する

このセクションで説明する手順を完了するには、publish_agent_externally 権限と、データ エージェントを編集するための適切な権限とコンテンツ アクセスを含む Looker ロールが必要です。

エージェントを公開する手順は次のとおりです。

  1. エージェントを編集する。
  2. [公開設定] を選択して、[エージェントの公開設定] ウィンドウを開きます。
  3. [エージェントの公開設定] ウィンドウで、[Gemini Enterprise] 設定を有効にして [更新] を選択します。この設定を有効にすると、[管理者] パネルの [Gemini in Looker] ページに表示される Gemini Enterprise インスタンスにエージェントが公開されます。
  4. エージェントを公開したら、[共有] を選択して他の Looker ユーザーにデータ エージェントへのアクセス権を付与するか、[会話を開始] を選択してデータ エージェントとの新しい会話を開くことができます。

Gemini Enterprise でエージェントへのアクセス権をユーザーに付与する

このセクションで説明する手順を完了するには、Gemini Enterprise エンジンを含む Google Cloud プロジェクトの Discovery Engine 管理者の Identity and Access Management ロールが必要です。

Gemini Enterprise でエージェントとチャットするには、ユーザーが Gemini Enterprise インスタンスと個々のエージェントにアクセスできる必要があります。

ユーザーに Gemini Enterprise インスタンスへのアクセス権を付与するには、ディスカバリー エンジン管理者が、Gemini Enterprise エンジンを含む Google Cloud プロジェクトの Gemini Enterprise ユーザー IAM ロールをユーザーに割り当てる必要があります。

ユーザーに個別のエージェントへのアクセス権を付与するには、ディスカバリー エンジン管理者が Google Cloud コンソールで次の手順を完了する必要があります。

  1. Gemini Enterprise エンジンを含む Google Cloud プロジェクトに移動します。
  2. Gemini Enterprise の商品ページを開きます。
  3. メイン ナビゲーションから [アプリ] ページを選択し、Gemini Enterprise インスタンスの名前を選択します。
  4. メイン ナビゲーションで [エージェント] を選択します。
  5. アクセス権を付与するエージェントを選択します。
  6. [ユーザー権限] タブを選択します。
  7. [ユーザーを追加] を選択します。
  8. [Add user permissions roles to agent] ウィンドウで、各ユーザーを追加して、エージェント ユーザーロールを割り当てます。

Gemini Enterprise でエージェントとチャットする

このセクションで説明する手順を完了するには、Gemini Enterprise エンジンを含む Google Cloud プロジェクトに対する Gemini Enterprise 企業ユーザーの Identity and Access Management ロールが必要です。また、Looker インスタンスでエージェントとチャットするには、適切な権限とコンテンツ アクセスが必要です。

Gemini Enterprise インスタンスでデータ エージェントとチャットする手順は次のとおりです。

  1. Gemini Enterprise インスタンスを開きます。
  2. メイン ナビゲーションで [エージェント] を選択します。
  3. [エージェント] ページで、チャットするエージェントを選択します。エージェントを選択すると、会話ウィンドウが開き、データに関する質問を行うことができます。

エージェントと初めてチャットするときは、エージェントによる Looker ID へのアクセスを承認する必要があります。

Gemini Enterprise でデータ エージェントを再公開する

Looker がデータ エージェントの機能や能力を更新した場合は、Gemini Enterprise で変更が有効になるように、エージェントを更新または再公開する必要があります。

Looker 26.12 では、エージェントの回答でグラフがサポートされるようになりました。エージェントが Looker 26.12 より前に作成された場合は、エージェントを更新または再公開して、レスポンスでグラフを使用できるようにする必要があります。

エージェントを更新する手順は次のとおりです。

  1. データ エージェントを編集します。
  2. エージェントのメタデータを変更する。
  3. [Update] を選択します。

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

  1. データ エージェントを編集します。
  2. [公開設定] を選択して、[エージェントの公開設定] ウィンドウを開きます。
  3. [Gemini Enterprise] 切り替えをオフにして、[更新] を選択します。
  4. エージェントが Gemini Enterprise から削除されるまで待ちます。
  5. Looker でデータ エージェントを編集して、[エージェントの公開設定] ウィンドウを再度開きます。
  6. [公開設定] を選択し、[Gemini Enterprise] 切り替えボタンをオンにして、[更新] を選択します。

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

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

  1. [会話] ページで、左側のパネルにある spark [エージェントを管理] をクリックします。
  2. 選択したエージェントの [その他のオプション] アイコンをクリックしてメニューを開き、[削除] をクリックします。
  3. [エージェントを削除しますか？] ウィンドウで、[ゴミ箱に移動] をクリックしてデータ エージェントを削除します。

ゴミ箱に移動されたエージェントは、30 日後に完全に削除されます。データ エージェントを手動で完全に削除することも、完全に削除される前にゴミ箱からデータ エージェントを復元することもできます。何も操作を行わなかった場合、エージェントは 30 日後に自動的に完全に削除されます。

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

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

  1. [会話] ページに移動します。
  2. 左側のナビゲーション パネルで、[ゴミ箱] セクションを開きます。
  3. 選択したエージェントのメニューを開くには、 アイコンを選択し、[完全に削除] をクリックします。
  4. [よろしいですか？] ウィンドウで、[完全に削除] をクリックします。

ゴミ箱からデータ エージェントを復元する

ゴミ箱からデータ エージェントを復元する手順は次のとおりです。

  1. [会話] ページに移動します。
  2. 左側のナビゲーション パネルで、[ゴミ箱] セクションを開きます。
  3. 選択したエージェントのメニューを開くには、 アイコンを選択し、[復元] をクリックします。