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

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

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

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

始める前に

データ エージェントは、ダッシュボード、Look、フォルダなど、他の種類の Looker コンテンツと考えることができます。

データ エージェントの使用は、コンテンツ アクセス、データアクセス、機能アクセスを組み合わせて管理されます。次の表に記載されているタスクを実行するには、データ エージェントがクエリを実行するモデルに必要な権限と、場合によってはエージェント自体へのアクセス権を持つ Looker ロールが割り当てられている必要があります。

タスク 必要な Looker の権限 必要なデータ エージェントのアクセスレベル
エージェントの作成、編集、共有、削除 追加日: 25.18 admin_agents コンテンツ アクセス権を付与しない
エージェントの作成、編集、共有、削除 追加日: 25.18 save_agents

ユーザーは、基盤となるモデルでこの権限が付与されている Explore のみを使用するエージェントを作成できます。他のユーザーが作成したデータ エージェントを編集、削除、共有するには、エージェントが使用するすべてのモデルでこの権限を含むロールが付与されている必要があります。		 アクセスの管理; 編集 （ユーザーがエージェントを作成すると、このアクセス権が自動的に付与されます。それ以外の場合は、エージェントの作成者がエージェントを共有して、アクセスの管理; 編集 アクセス権を付与する必要があります）
会話型分析の [エージェント] タブからデータ エージェントとチャットする access_data（データ エージェントが使用する Explore を含む各モデル）

追加日: 25.18 chat_with_agent（データ エージェントが使用する Explore を含む各モデル）		 表示 アクセス
会話型分析の [Explore] タブから Looker Explore とチャットする access_data（データ エージェントが使用する Explore を含む各モデル）

追加日: 25.18 chat_with_explore

Looker には、インスタンス上のすべてのモデルに対するこれらの権限のサブセットを含む次のデフォルト ロールもあります。

  • 会話型分析エージェント マネージャー: このロールを持つユーザーは、アクセスの管理; 編集 アクセス権を持つエージェントを作成、編集、共有、削除し、チャットできます。また、Explore とチャットすることもできます。
  • 会話型分析ユーザー: このロールを持つユーザーは、表示 アクセス権を持つエージェントとチャットできます。
  • 管理者: デフォルトでは、このロール（Looker 管理者）には、インスタンス全体のすべての権限とコンテンツ アクセス権が付与されています。

Looker 管理者は、Looker インスタンスの [管理] セクションの [ロール] ページでこれらのロールと権限を付与できます。Looker のロールの詳細については、管理者設定 - ロールのドキュメント ページをご覧ください。

データ エージェントの作成者は、エージェントを共有することで、エージェントに対する個々のユーザーのアクセス権を管理できます。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

エージェントで調整してテストするための指示の例を次に示します。

Agent Instructions

You are an expert e-commerce analyst. When answering questions about our sales
data, adhere to the following definitions and patterns:

Default Filtering: Unless stated otherwise, always filter the data on Order
Items Created Year = 2024. Customer Loyalty: We consider "loyal" customers to be
those with Order Items Count > 5. Business Terms:  "Successful" orders are those
where Order Items status = "Complete".  "Revenue" always refers to the Total
Sales field.  "Location" means User City. Grouping Rules: When someone says "by
product", unless they specifically say "name", group by product category.

Looker Golden Queries

Pay close attention to the patterns in the provided golden query below. Use it
as a primary reference for generating Looker queries that are
related to revenue and order status:

Question: "How much revenue did we generate from successful orders in 2024?"
Looker query:
    Model: thelook_ecommerce
    Explore: order_items
    Fields: [order_items.total_sales]
    Filters: [{field: order_items.status, value: "Complete"},
    {field: order_items.created_year, value: "2024"}]

Always keep these patterns and definitions in mind when generating your answers.

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

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

変更をプレビューに反映するには、[更新] をクリックする必要があります。保存ステータスが 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. [会話] ページの左側のパネルで、spark[エージェントを管理] をクリックします。 1. 選択したエージェントの [**その他のオプション**] アイコンをクリックしてメニューを開き、[**削除**] をクリックします。 1. [エージェントを削除しますか？] ウィンドウで、[ゴミ箱に移動] をクリックしてデータ エージェントを削除します。

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

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

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

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

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

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

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