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

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

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

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

始める前に

会話分析の使用は、コンテンツ アクセス、データアクセス、機能アクセスの組み合わせによって管理されます。データ エージェントは、ダッシュボード、Look、フォルダなどの Looker コンテンツの一種と考えることができます。データ エージェントを操作するには、個々の Explore の基盤となるモデル、またはデータ エージェントがクエリを実行するモデルに必要な権限を含む Looker ロールが割り当てられている必要があります。場合によっては、エージェント自体へのアクセスも必要になります。ユーザーデータ エージェントの管理と使用に必要な権限とアクセス権について詳しくは、Looker で会話分析を設定するのドキュメント ページの権限の表をご覧ください。

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

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

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

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

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

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

  5. 必要に応じて、エージェントとのすべての会話で高度な分析を有効にするには、[高度な分析を有効にする] を選択します。

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

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

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

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

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

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

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

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

Looker のゴールデン クエリを定義する

特定の Explore の各 Looker ゴールデン クエリを定義するには、次の両方のフィールドに値を指定します。

  • natural_language_questions: ユーザーが尋ねる可能性のある自然言語の質問
  • looker_query: 自然言語の質問に対応する Looker のゴールデン クエリ

natural_language_questions フィールドには、そのデータ探索についてユーザーが質問する可能性のある質問を自然言語で記述します。このフィールドの値には複数の質問を含めることができます。looker_query フィールドの値は、Explore のクエリ メタデータから取得できます。

ゴールデン クエリは次のフィールドをサポートしています。

  • model（文字列）: クエリの生成に使用された LookML モデル。必須フィールドです。
  • explore（文字列）: クエリの生成に使用された Explore。このフィールドは必須です。
  • fields[]（文字列）: ディメンションや測定値など、Explore から取得するフィールド。このフィールドは省略できます。
  • filters[]（文字列）: Explore に適用するフィルタ。このフィールドは省略できます。
  • sorts[]（文字列）: Explore に適用する並べ替え。このフィールドは省略可能です。
  • limit（文字列）: Explore に適用するデータ行の上限。このフィールドは省略可能です。

次の手順で、Explore のクエリ メタデータを Explore から直接取得できます。

  1. Explore で、[Explore アクション メニュー] を選択し、[LookML を取得] を選択します。
  2. [ダッシュボード] タブを選択します。
  3. LookML からクエリの詳細をコピーします。たとえば、次の画像は、Order Items という Explore の LookML を示しています。

選択したメタデータをコピーして、Looker のゴールデン クエリで使用します。

  model: thelook
  explore: order_items
  fields: [order_items.order_id, orders.status]
  sorts: [orders.status, order_items.order_id]
  limit: 500

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

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

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

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

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

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

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

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

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

  1. [会話] ページの左側のパネルで、[spark] [エージェントを管理] を選択します。
  2. 選択したエージェントの [その他のオプション] アイコンをクリックしてメニューを開き、[共有] をクリックします。
  3. [このエージェントにアクセスできるユーザー] セクションに個人またはグループを追加し、権限レベルを選択したら、[追加] をクリックして共有リストに追加します。
  4. 新しいユーザーまたはグループに通知メールを送信する場合は、[Email the people you have just added] チェックボックスをオンにします。
  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. Discovery Engine 管理者（IAM ロール）: Google Cloud コンソールでエージェントへのアクセス権を付与します。
  3. Gemini Enterprise ユーザー（IAM ロール）、データ エージェント ユーザー（Looker 機能）: Gemini Enterprise インスタンスでエージェントとチャットする。

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

  • Looker 管理者は、[管理] パネルの [Gemini in Looker] ページで [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 インスタンスへのアクセス権を付与するには、Discovery Engine 管理者が、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] ウィンドウで、各ユーザーを追加し、[Agent User] ロールを割り当てます。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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