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

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

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

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

始める前に

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

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

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

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

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

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

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

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

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

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

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

エージェントの指示を記述する

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

[指示] フィールドで指定できるコンテキストの種類の例を次に示します。

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

エージェントの指示を記述する際のヒントとベスト プラクティスについては、Looker で会話型分析を設定するのベスト プラクティスをご覧ください。

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

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

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

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

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

  • model（文字列）: クエリの生成に使用された LookML モデル。これは必須フィールドです。
  • explore（文字列）: クエリの生成に使用された Explore。これは必須フィールドです。
  • fields[] （文字列）: ディメンションや measure など、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. 変更を保存するには、[更新] をクリックします。

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

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

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

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

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

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

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

  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. というメッセージが表示されます。

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

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

1.On the [**会話**] page, click spark[**エージェントを管理**] in the left panel. 1. 選択したエージェントの [**その他のオプション**] アイコンをクリックしてメニューを開き、[**削除**] をクリックします。 1. [エージェントを削除しますか？] ウィンドウで、[ゴミ箱に移動] をクリックしてデータ エージェントを削除します。

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

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

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

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

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

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

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