データ エージェントを使用すると、データの会話分析エクスペリエンスをキュレートできます。エージェントを作成する際に、特定のユースケースで質問に効果的に回答するためのコンテキストと指示を提供できます。エージェントを使用すると、アナリストはビジネス用語を特定のフィールドにマッピングし、フィルタリングに最適なフィールドを指定し、カスタム計算を定義できます。
会話分析データ エージェントのエクスペリエンスは、従来の会話分析と新しい会話分析で異なります。[レガシー] タブまたは [新規] タブを選択して、各エクスペリエンスでの会話の仕組みについてご確認ください。
新規
会話分析データ エージェントは、BigQuery で最初に作成され、データポータル ユーザーと共有された後、データポータルで使用できるようになります。
このタブでは、次のタスクについて説明します。
データ エージェントを作成して共有する
BigQuery でエージェントを作成し、他のユーザーに BigQuery とデータポータルでエージェントとチャットする権限を付与するには、データ エージェントを作成するの手順に沿って操作します。データ エージェントが公開されると、データポータルの [データとチャットする] ページの [エージェント] リストに自動的に表示されます。
BigQuery のエージェントへのリンクは、エージェント カードまたは [詳細] パネルからコピーすることもできます。エージェント カードで、 [操作を開く] を選択し、[リンクをコピー]、[データポータル] の順に選択します。[**詳細**] パネルで、[**エージェントのリンクをコピー**] を選択し、[**データポータル**] を選択します。
データ エージェントを編集する
データ エージェントは BigQuery で編集します。BigQuery でエージェントを直接編集することも、エージェントの [BigQuery で編集] パネルから [詳細] を選択してデータポータルからエージェントを開くこともできます。
BigQuery から、エージェントへのアクセス権を取り消したり、エージェントを削除したりできます。
エージェントとの会話を開始する
データ エージェントとの会話を開始する手順は次のとおりです。
- [データとチャットする] ページに移動します。
- 会話するデータ エージェントを選択します。必要に応じて、[エージェントを検索] バーを使用して検索を絞り込むことができます。
- 会話を開始するには、質問を入力して return（Mac）または Enter（PC）を押します。
[データとチャットする] ページに戻って別のデータ エージェントとチャットするには、メイン ナビゲーションから [+ 新しい会話] を選択します。
会話には、[ 最近] セクションから戻ることができます。
エージェント メタデータ
データポータルには、エージェントとチャットしているときに、エージェント カードと [詳細] パネルにデータ エージェントに関する情報が表示されます。
エージェント カード
エージェント カードは、[データとチャットする] ページに表示されます。データ エージェントに関する次の情報が表示されます。
- エージェント: エージェント作成者が記述したエージェントの名前
- 説明: エージェント作成者が記述したエージェントの説明
- 更新済み: BigQuery 内からエージェントが最後に公開されたときのタイムスタンプ
- [**操作を開く**]: 次のオプションを含むメニュー。
- [詳細]: [詳細] パネルを開きます
- BigQuery で編集: BigQuery でエージェント構成を開きます
- リンクをコピー: エージェントへのリンクをコピーします。このリンクをウェブブラウザに貼り付けると、エージェントとの新しい会話が開きます。
- フィードバックを送信: エージェントのエクスペリエンスに関するフィードバックを送信できるパネルを開きます
エージェントの詳細
データ エージェントとチャットしているときに、[詳細] パネルが表示されます。データ エージェントに関する次の情報が表示されます。
- エージェント: エージェント作成者が記述したエージェントの名前
- 説明: エージェント作成者が記述したエージェントの説明
- BigQuery でエージェントを編集するためのリンク
- データ エージェントの URL をコピーするためのリンク。このリンクをブラウザに貼り付けると、データ エージェントとの新しい会話が開きます。
- ナレッジソース: ナレッジソースとして使用する BigQuery のテーブル、ビュー、ユーザー定義関数（UDF）
- プロジェクト: データ エージェントを含む Google Cloud プロジェクト
- ラベル: BigQuery リソースに割り当てられたラベル（存在する場合）
- 最終公開日: BigQuery 内からエージェントが最後に公開されたときのタイムスタンプ
- 作成日: BigQuery でエージェントが作成されたときのタイムスタンプ
レガシー
このタブでは、次のタスクについて説明します。
データ エージェントを作成して編集する
新しいデータ エージェントを作成する手順は次のとおりです。
- 会話分析の [データとチャットする] ページで、[エージェント] タブを選択します。
- [**+ エージェントを作成**] を選択します。または、左側のナビゲーション パネルで、
[**エージェントを管理**] を選択し、[**+ エージェントを作成**] を選択します。 [新しいエージェント] ページで、データ エージェントに関する次の情報を入力します。
- エージェント名: エージェントの名前を入力します。名前は一意でわかりやすいものにする必要があります。
- 説明: このエージェントの機能と使用するデータを簡単に説明します。ユーザーがエージェントを選択して会話を開始するときや、エージェントを共有するときに、この説明が表示されます。エージェントの目的と、どのように役立つかを明確に説明してください。
データ : 次の手順に沿って、新しいデータソースまたは既存のデータソースに接続します。
- [データ] フィールドで [データを選択] をクリックします。
- [エージェントのデータを選択] ウィンドウで、データソースの名前をクリックします。
- [選択] をクリックして、選択したデータソースをデータ エージェントに追加します。
または、[エージェントのデータを選択] ウィンドウで [データに接続] を選択して、新しいデータソースを作成することもできます。
最初のデータソースを選択すると、新しいデータソースを選択することはできません。Looker Explore に表示されるフィールドは、 [フィールドを表示] を選択して管理できます。
指示: 会話分析がデータとやり取りして、正確で関連性の高い回答を提供できるように、コンテキストを提供します。提供できるコンテキストの種類の例については、エージェントへの指示を作成するをご覧ください。
新しいデータ エージェントを保存するには、[保存] をクリックします。
データ エージェントを保存したら、他のユーザーとエージェントを共有して、エージェントとの会話を開始できるようにします。
エージェントへの指示を作成する
データ エージェントを作成する際に、次の種類のコンテキストを [指示] フィールドに指定できます。
- 類義語: 主なフィールドの代替用語
- 主なフィールド: 分析に関して最も重要なフィールド
- 除外済みフィールド: データ エージェントが回避するフィールド
- フィルタリングとグループ化: エージェントがデータのフィルタリングとグループ化に使用するフィールド
エージェントを調整してテストするための指示の例を次に示します。
- 特に指定がない限り、常に
Order Items Created Year = 2024でデータをフィルタリングします。 - 「ロイヤル」顧客とは、
Order Items Count > 5の顧客を指します。 - 「場所」について言及している場合は、ユーザーの市区町村を意味します。
- 質問で「高齢者」に言及している場合は、
User Age > 65のユーザーを指します。 - 収益に関する質問の場合は、合計売上を使用します。
- 「商品別」と指定されている場合は、「名前」と明示的に指定されていない限り、
product categoryでグループ化します。 - 「成功」した注文とは、注文アイテムのステータスが「完了」であることを意味します。
- 期間に関する質問がある場合は、常に
Order Item Created Dateをグループ化するフィールドとして使用します。
エージェントをテストする
エージェントを作成または編集している場合、エージェントの詳細ページに [エージェントをプレビュー] ペインが表示されます。エージェントとの会話を開始して、エージェントの設定と指示をテストできます。
変更をプレビューに反映するには、[更新] をクリックする必要があります。保存ステータスが Changes not saved の場合、設定の更新はプレビューに反映されません。
既存のデータ エージェントを編集する
既存のデータ エージェントを編集する手順は次のとおりです。
- 会話分析で、[エージェントを管理] をクリックします。
- [エージェントを管理] ページで、編集するデータ エージェントを選択します。
必要に応じて、エージェントの詳細を更新します。エージェントの作成時に指定した詳細（[エージェント名]、[説明]、[指示] フィールドなど）を変更できます。
[**データ**] フィールドでエージェントに関連付けられているデータソースを変更することはできませんが、フィールドを管理するには、 [**フィールドを管理**] を選択します。
変更を保存するには、[更新] をクリックします。
エージェントとの会話を開始する
作成したデータ エージェント、または他のユーザーと共有したデータ エージェントとの会話を開始できます。エージェントとの会話を開始する手順は次のとおりです。
- 左側のナビゲーション パネルで、[+ 会話を作成] をクリックします。
- [エージェント] タブで、会話を開始するエージェントを選択します。
- 質問を入力して return（Mac）または Enter（PC）を押すと、会話が開始されます。
会話には、[ 最近] セクションから戻ることができます。
データ エージェントを共有する
エージェントを共有できるのは、データ エージェントのオーナーのみです。共有データ エージェントの受信者は、エージェントの説明を表示できますが、エージェントを編集することはできません。エージェントを作成してから共有できるようになるまで、数分かかることがあります。
データ エージェントを共有する
データ エージェントを共有する手順は次のとおりです。
- 会話分析で、[エージェントを管理] をクリックします。
- データ エージェントにカーソルを合わせ、 [データ エージェントを共有] を選択します。または、既存のデータ エージェントを編集しているときに [ 共有] を選択します。
- 特定のユーザーまたは Google グループを招待して、エージェントを共有できます。レポートのリンクの共有を有効にして、より広範囲に共有することもできます。
- [アクセス権を持つユーザー] セクションにユーザーまたはグループを追加したら、[完了] をクリックします。
受信者には、データ エージェントへのリンクが記載されたメールが届きます。このリンクは、後で使用できるように保存してください。ユーザーが [会話を作成] を選択すると、共有されているエージェントが [エージェント] に表示されます。エージェントが最初に共有された後、ユーザーはそのエージェントの指示を表示できなくなります。関連する情報をエージェントの説明に含めてください。
データ エージェントへのアクセス権を取り消す
エージェントへのアクセス権を取り消すには、エージェントの [共有] メニューの [アクセス権を持つユーザー] リストからユーザーまたはグループを削除します。削除されたユーザーが会話中の場合、変更が反映されるまで 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. というメッセージが表示されます。
データ エージェントを削除する
データ エージェントを削除する手順は次のとおりです。
- 会話分析で、[エージェントを管理] をクリックします。
- [エージェントを管理] ページで、削除するデータ エージェントにカーソルを合わせます。
- [**その他のオプション**] をクリックします。
- [ Delete] を選択します。
- [ゴミ箱に移動] ウィンドウで [ゴミ箱に移動] をクリックして、データ エージェントを削除します。
ゴミ箱に移動したエージェントは、30 日後に完全に削除されます。データ エージェントは手動で完全に削除することも、完全に削除される前にゴミ箱から復元することもできます。
データ エージェントを完全に削除する
データ エージェントを完全に削除する手順は次のとおりです。
- 会話分析に移動します。
- 左側のナビゲーション パネルで、[ゴミ箱] セクションを開きます。
- 削除するデータ エージェントを選択します。
- [Are you sure?] ウィンドウで [完全に削除] をクリックします。
ゴミ箱からデータ エージェントを復元する
ゴミ箱からデータ エージェントを復元する手順は次のとおりです。
- 会話分析に移動します。
- 左側のナビゲーション パネルで、[ゴミ箱] セクションを開きます。
- 復元するデータ エージェントを選択します。
- [Are you sure?] ウィンドウで [復元] をクリックします。