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

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

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

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

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

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

データエージェントを作成する際に、次の種類のコンテキストを [指示] フィールドに指定できます。

  • 主なフィールド: 分析に関して最も重要なフィールド
  • 除外済みフィールド: データ エージェントが回避するフィールド
  • フィルタリングとグループ化: エージェントがデータのフィルタリングとグループ化に使用するフィールド
  • 類義語: 主なフィールドの代替用語

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

  • 特に指定がない限り、常に Order Items Created Year = 2024 でデータをフィルタする
  • 「ロイヤル」顧客とは、Order Items Count > 5 の顧客を指す
  • 「場所」について言及している場合は、ユーザーの都市を意味する
  • 質問で「シニア」に言及している場合は、User Age > 65 のユーザーを指す
  • 収益に関する質問の場合は、合計売上を使用する
  • 「商品別」と指定されている場合は、「名前」と明示的に指定されていない限り、product category でグループ化する
  • 「成功」した注文とは、注文アイテムのステータスが「完了」であることを意味する
  • タイムラインに関する質問や、時間の経過に伴う質問の場合は、常に Order Item Created Date をグループ化するフィールドとして使用する

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

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

変更をプレビューに反映するには、[更新] をクリックする必要があります。保存ステータスが 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. 選択したエージェントのメニューを開くには、 アイコンを選択し、[復元] をクリックします。