メインコンテンツまでスキップ
に最終更新

Genie Agentの作成と管理

ビジネスユーザーがDatabricksでデータに質問するために使用する自然言語チャットインターフェースであるGenieエージェントを作成、共有、管理します。データアナリストは、各エージェントをUnity Catalog、サンプルSQLクエリ、指示、および信頼できる資産で構成します；ビジネスユーザーはチャットUIを通じてそれをクエリします。

注記

Genieエージェントは以前、Genieスペースとして知られていました。

技術要件と制限​

Genieエージェントを使用する際には、以下の要件と制限が適用されます：

  • Unity Catalog: GenieエージェントのデータはUnity Catalogに登録されている必要があります。Genieエージェントに最大30個のテーブルまたはビューを追加できます。
  • コンピュート: Genieエージェントには、ProまたはサーバレスSQLウェアハウスが必要です。Genieエージェントを作成または構成するには、選択したウェアハウスに対して少なくともCAN USE権限を持っている必要があります。コンピュート認証情報はGenieエージェントに埋め込まれ、すべてのユーザーのすべてのクエリを処理するために使用されます。
  • 容量： 各Genieエージェントは最大10,000件の会話をサポートでき、各会話には最大10,000件のメッセージを含めることができます。

必要な権限​

Genieエージェントを作成または編集するには、次の権限と資格が必要です。

  • エンタイトルメント: Databricks SQL ワークスペースのエンタイトルメントが必要です。エンタイトルメントの管理を参照してください。
  • コンピュート: 少なくとも 1 つの pro または サーバレス SQLウェアハウスへのアクセスを使用できます。
  • データアクセス: エージェントで使用されるデータに対するSELECT権限。
  • Genieエージェント ACL: Genieエージェントに対する少なくともCAN EDITアクセス許可。Genieエージェントの作成者は、作成したエージェントに対してCAN MANAGE権限を自動的に持ちます。Genieエージェント ACLを参照してください。
注記

データとコンピュートのアクセスを設定するには、昇格された権限が必要であり、通常は管理者に限定されます。 SQLウェアハウスの作成およびUnity Catalogでの権限の管理を参照してください。

Genie アクセスの管理​

Genie はパートナーが提供する AI 機能を使用します。この機能はアカウント レベルとワークスペース レベルで有効にする必要があります。アカウントでこれらの機能を管理する方法については、 パートナーが提供する AI 機能を参照してください。

注記

この機能へのアクセスを管理するには、アカウント管理者である必要があります。パートナーを利用したAI機能を無効にしても、Databricks SQLの権限を持つユーザーはサイドバーの Genieエージェント アイコンをクリックできますが、Genieエージェントにはアクセスできません。

Genieエージェントを作成します​

Genieエージェントを作成するには：

  1. サイドバーの「**Genie Agents**」をクリックします。
  2. 画面の右上隅にある 新規 をクリックします。
  3. Genieエージェントに含めるデータソースを選択します。次に、**作成**をクリックします。

データソースが選択された状態でのデータの接続ダイアログ。

Genie Codeでエージェントを設定します。​

エージェントを作成すると、Genie Codeが自動的に起動します。これはデータを読み取り、Genieが質問に正確に回答するのに役立つコンテキスト（テーブルの説明やクエリの例など）を提案します。提案を確認し、保持したいものを受け入れてください。特定のギャップを埋めるには、Genie Codeに追加してほしいコンテキストを記述してください。

プロンプト

Genie Codeにこれを実行するよう伝えてください：

Create a Genie agent for our sales team that answers questions about weekly revenue, units sold, and returns by store and region. Use the sales and store tables in the retail catalog.

どのテーブルを使用すればよいかまだわからない場合は、Genie Codeにエージェントの作成を依頼することもできます。ビジネスドメイン、エージェントに回答させたい質問、および使用すべきデータを記述してください。Genie Codeは関連データを特定し、あなたとソースを確認し、同じ開始コンテキストでエージェントを構築します。

エージェントをユーザーと共有する前に、Databricksは応答の精度を向上させるために、例のSQLクエリ、指示、およびナレッジストア構成を追加することを推奨します。Genie Agentの品質を調整するを参照してください。

クエリの提案を確認する​

エージェントのデータについて学習するには、Genieはワークスペース内の情報にアクセスし、テーブル間の関係とビジネスセマンティクスをよりよく理解します。エージェントにデータ資産を追加すると、Genieはそれらの資産に関連付けられた関連性の高い人気のワークスペースクエリを自動的に検索します。ユーザー資格情報は、少なくともCAN VIEW権限を持つ関連クエリを検索するために使用されます。検索でクエリが返されると、 指示 パネルの データ タブに通知が表示されます。提案されたクエリを表示するには、 レビュー をクリックしてください。

クエリのアクセス許可の詳細については、クエリ ACLを参照してください。

推奨クエリの確認通知。

「**推奨クエリの確認**」ダイアログを使用して、推奨クエリを確認、編集、承認、または拒否します。Genie Agentに対するCAN EDIT以上のアクセス権を持つ他のユーザーは、クエリ自体に対するCAN VIEW以上のアクセス権がある場合、クエリをレビューできます。

注釈付きの推奨クエリの確認ダイアログ。番号が振られたセクションでは、提案されたクエリーの操作方法について説明します。

  1. タイトル テキストには、質問が事前に入力されています。質問を修正または編集するには、[ タイトル ] フィールドに入力します。
  2. コード フィールドには、提案された SQL クエリの完全なテキストが含まれています。このフィールドは編集できません。クエリ全体を表示するには、 ...より多くの行 をクリックします。
  3. クエリに対する十分なアクセス許可がある場合は、[ SQL クエリ ] をクリックして、 クエリ履歴 UI でクエリを開くことができます。クエリ履歴の表示を参照してください。
  4. クエリーがGenieエージェントに関連するかどうかを判断した後、 承認 または 拒否 をクリックしてGenieエージェントに追加するか、それに応じて提案を却下します。
  5. 他の提案をクリックして展開し、確認します。

承認されたクエリは、エージェントの SQLクエリ コンテキストに表示されます。エージェントに追加されると、提案されたクエリと関連する質問は完全に編集可能になります。SQLクエリと関数の例を追加するを参照してください。

推奨されるクエリが返されない場合は、次のようにします。

  • 関連するクエリに対する十分なアクセス権がない可能性があります。
  • 関連するデータがない可能性があります。含まれているテーブルでクエリが実行されていない場合、検索で結果が返されない可能性があります。
  • Genie Agentに関係のないクエリーは考慮されません。例えば、含まれるアセットに対して基本的な書き込み操作のみを実行するクエリは、Genieにとって関連する例とはみなされません。
  • Genieは、エージェントに追加されていないテーブルに対するクエリを推奨しません。Genieエージェントのために結合テーブルまたはビューを特別に作成した場合でも、関連するDatabricks SQLクエリが通常、異なるソーステーブルに対して実行される場合、Genieはそれらのクエリを結果に返しません。

データ オブジェクトの管理​

Genie Agentに含まれるデータオブジェクトを管理するには、 Configure > Data をクリックします。 追加 ボタンをクリックして、さらにテーブルを追加します。エージェントからテーブルを削除するには、テーブル名の右側にあるゴミ箱のアイコン。をクリックします。

データ オブジェクトの詳細を表示するには、オブジェクト名をクリックします。データ オブジェクト ビューには 2 つのタブが表示されます。

  • 概要 : 列名、データ型、説明など、データ オブジェクト内の列を表示します。
  • サンプル データ : データのコンテキストと内容を理解するのに役立つ、テーブルからのサンプル データが表示されます。
注記

Genieは、エージェントに明示的に追加されたテーブル以外にもクエリできます。アクセスはUnity Catalog権限によって管理され、Genieエージェント自体によるものではありません。Genieはデフォルトでアタッチされたテーブルとビューを使用しますが、ユーザーは結合を促すかSQLを直接編集することで、他のテーブルをクエリできます。同様に、指示またはメタデータがエージェント外のテーブルを参照する場合、Genieはそれらを生成されたクエリに含めることができます。

設定を構成する​

追加設定を構成してGenieエージェントをカスタマイズします。 構成 > 設定 をクリックして、次の設定にアクセスします：

  • タイトル： タイトルは、他のワークスペースオブジェクトとともにワークスペースブラウザに表示されます。エンドユーザーがGenie Agentを見つけるのに役立つタイトルを選択します。
  • **デフォルト ウェアハウス**：このコンピュート リソースは、Genieエージェントで生成されるSQLステートメントを強化します。ウェアハウスの選択を保存すると、コンピュート資格情報がGenieエージェントに埋め込まれ、すべてのユーザーのすべてのGenieクエリの処理に使用されます。ウェアハウスを変更するには、Genieエージェントに対して少なくともCAN EDIT権限が必要です。別の作成者が後でウェアハウスを変更した場合、そのコンピュート資格情報が代わりに埋め込まれます。Genieエージェントは、Proまたはサーバレス SQLウェアハウスを使用できます。最適なパフォーマンスを得るために、Databricks はサーバレス SQLウェアハウスを使用することをお勧めします。
  • タグ : タグを使用してGenieエージェントを整理および分類し、管理を容易にします。タグを追加を参照してください。
  • サムネイル : Genie Agent にサムネイル画像を追加します。サムネイルは Genie Agent の初期チャットページと Genie One に表示されます。
  • 説明 : Genie Agentを開いたときに、ユーザーには説明が表示されます。このテキストエリアを使用して、Agentの目的を説明します。説明フィールドはMarkdown形式に対応しているため、テキストのスタイルを設定し、役立つコンテキストや参照へのリンクを提供できます。Markdown構文の詳細については、「Markdown Guide cheat sheet」を参照してください。
  • 一般的な質問 ：一般的な質問は、ユーザーが尋ねることができる質問の種類のオプションの例です。これらはエージェントのチャットランディングページに表示され、作成時または後でエージェントの 設定 から追加できます。作成者が定義した一般的な質問は優先され、最初に表示されます。チャットのランディングページを埋めるのに十分な一般的な質問を提供すると、あなたの質問のみが表示されます。提供する数が少ない場合、Genieは残りのスロットを自動生成された質問で埋めます。

テストと使用状況に基づいて、Genieエージェントで反復処理を行います。エージェントの作成と反復処理に関するベストプラクティスのガイダンスについては、効果的なGenieエージェントのキュレーションを参照してください。

タグを追加する​

タグを追加するには、Genie Agentに対して少なくともCAN EDITのアクセス許可が必要です。管理タグを追加するには、その管理タグに対するASSIGNアクセス許可も必要です。タグの詳細については、Unity Catalogセキュリティ保護可能なオブジェクトにタグを適用するを参照してください。

備考

プレビュー

この機能は パブリック プレビュー段階です。

  1. [構成] > [設定] をクリックします。

  2. [全般] をクリックします。

  3. タグ の下で、タグを追加または更新します。

    • タグがない場合は、 「タグを追加」 ボタンをクリックします。
    • タグがある場合は、編集アイコン タグの追加/編集 アイコン。

  4. 既存のタグの キー と 値 を選択するか、新しいタグの名前を入力します。

    • 管理されているタグは 管理 セクションのヘッダーに表示され、ロックアイコンが表示されますロックアイコン。。
    • タグキーは必須です。タグ値が必要かどうかは、タグ キーによって異なります。

Genieエージェントを共有する​

注記

Genieエージェントは、ウェアハウスを構成した作成者の埋め込みコンピュート資格情報を使用します。すべてのクエリは、これらの埋め込みコンピュート資格情報を使用して実行されます。ただし、エージェントのエンドユーザーはクエリに自身のデータ資格情報が適用されるため、表示されるべきデータのみが表示されます。アクセスできないデータに関する質問は、空の応答を生成します。

同じGenie Agent内で各ユーザーが閲覧できるデータを制限するには、Unity Catalogの基になるテーブルに行レベルセキュリティを適用します。Unity Catalogで定義された行フィルターと列マスクは、Genie Agentがどのように共有されていても関係なく、ユーザーごとに自動的に適用されます。「行フィルターと列マスク」を参照してください。

Genie Agentを共有する場合、ユーザーがエージェントとやり取りするには、次の権限が必要です。

  • エンタイトルメント: コンシューマー アクセスまたは Databricks SQL ワークスペースの権利。エンタイトルメントの管理を参照してください。
  • コンピュート: ウェアハウスを構成した作成者によって埋め込まれたコンピュート資格情報を使用してクエリを実行します。 エンドユーザーは直接ウェアハウス権限を必要としません。
  • データアクセス： エージェントで使用されるすべてのUnity Catalogデータオブジェクトに対する、少なくともSELECTの特権。ユーザーは、アクセス権を持つデータのみを表示できます。
  • Genieエージェント ACL: Genieエージェントに対する少なくともCAN VIEW/CAN RUN権限。Genieエージェント ACLを参照してください。

新しいGenieエージェントは、デフォルトでユーザーフォルダに保存されます。他のワークスペースオブジェクトと同様に、それらは囲むフォルダから権限を継承します。ワークスペースのフォルダ構造を使用して、他のユーザーと共有できます。「ワークスペース ブラウザー」を参照してください。

また、特定のユーザーまたはグループ (すべてのアカウント ユーザーを含む) を指定して、特定のアクセス許可レベル ( CAN MANAGE 、 CAN EDIT 、 CAN RUN 、およびCAN VIEW ) で共有することもできます。

特定のユーザーまたはグループと共有するには:

  1. [共有] をクリックします。
  2. エージェントを共有するユーザーまたはグループを入力してください。次に、[ 追加 ] をクリックして、適切なアクセス許可レベルを設定します。個々のユーザーおよび小規模グループのメンバーには、エージェントが共有されたことを確認するEメール通知が届きます。
  3. 共有ダイアログの下部にある「 リンクをコピー 」ボタンを使用して、Genieエージェントへの共有可能なリンクを取得してください。特権ユーザーは、リンクをクリックして新しいタブでGenieエージェントを開き、質問できます。

すべてのアカウントユーザーと共有するには：

  1. [共有] をクリックします。
  2. すべてのアカウントユーザー を選択してください。
  3. 適切な権限レベルを設定してください。

エージェントユーザーは、個別の会話を共有することもできます。会話を共有するを参照してください。

OpenSharingを使用して組織外のユーザーとGenieエージェントを共有するには、OpenSharingを使用してGenieエージェントを共有するを参照してください。

Genieエージェントのクローンを作成​

Genieエージェントをクローン作成すると、すべてのセットアップコンテキストと指示が含まれるコピーが作成されます。クローン作成は、別のエージェントで変更をテストしたり、元のコンテキストを新しいエージェントで再利用したりする場合に便利です。エージェントがクローン作成されると、新しいエージェントは元のエージェントから独立します。元のデータに影響を与えることなく、編集や調整を行うことができます。

以下の要素が、クローンされたGenieエージェントにコピーされます：

  • テーブルと設定
  • 一般的な指示
  • SQL クエリの例
  • SQL 関数

既存のチャットスレッドおよび モニター タブからのデータは、新しいエージェントにはコピーされません。

Genieエージェントをクローンするには、以下の手順を実行します。

  1. クローンするGenieエージェントを開きます。
  2. エージェントの右上隅にあるケバブメニューのアイコン。ケバブメニューをクリックします。
  3. クローンを作成 をクリックします。
  4. (オプション) クローン ダイアログで、クローン作成されたGenieエージェントの新しい名前とワークスペースフォルダーの場所を指定します。
  5. クローン をクリックして、新しいエージェントを作成します。

Genieエージェントをメトリクスビューとしてエクスポート​

Genieエージェントからコンテキストをメトリクスビューとしてエクスポートできます。これにより、エージェントで設定されたデータとセマンティックコンテキストに基づいてメトリクスビューが作成されます。

Genieエージェントをメトリクス ビューとしてエクスポートするには、次の手順を実行します。

  1. エクスポートするGenieエージェントを開きます。
  2. エージェントの右上隅にあるケバブメニューのアイコン。ケバブメニューをクリックします。
  3. [メトリクス ビューにエクスポート] を選択します。
  4. 新しいメトリクス ビューのパスを選択します。
  5. 必要に応じて、ページの右上隅にある きらめくGenie Codeアイコン アイコンをクリックして、Genie Code を開き、メトリクスビューの定義を調整します。
  6. 作成 をクリックします。

追加のリソース​

このページの見出し