Genie エージェントの作成と管理

ビジネス ユーザーがAzure Databricksでデータに関する質問をするために使用する自然言語チャット インターフェイスである Genie エージェントを作成、共有、管理します。 データ アナリストは、Unity カタログ、SQL クエリ、命令、信頼された資産の例を使用して各エージェントを構成します。ビジネス ユーザーは、チャット UI を使用してクエリを実行します。

技術的な要件と制限

Genie エージェントを使用する場合は、次の要件と制限が適用されます。

• Unity カタログ: Genie エージェントのデータを Unity カタログに登録する必要があります。 Genie エージェントには、最大 30 個のテーブルまたはビューを追加できます。
• 計算： Genie エージェントには、プロまたはサーバーレスの SQL ウェアハウスが必要です。 Genie エージェントを作成または構成するときは、選択したウェアハウスに対する CAN USE 権限が少なくとも必要です。 あなたの計算認証情報はGenieエージェントに組み込まれており、すべてのユーザーに倉庫へのアクセスを提供します。 データアクセスは常に各エンドユーザーのUnity Catalog権限に基づいて評価されます。 データアクセスの仕組みをご覧ください。
• 容量： 各 Genie エージェントは最大 10,000 個の会話をサポートでき、各会話には最大 10,000 件のメッセージを含めることができます。

必要なアクセス許可

Genie エージェントを作成または編集するには、次のアクセス許可と権利が必要です。

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

Genie アクセスの管理

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

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

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

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

Genie Code を使用してエージェントを設定する

エージェントを作成すると、 Genie Code が自動的に起動します。 データを読み取り、テーブルの説明やクエリ例など、Genie が正確に質問に答えるのに役立つコンテキストを提案します。 提案を確認し、保持する候補を受け入れます。 特定のギャップを埋めるために、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 エージェントの品質を調整するを参照してください。

クエリ候補を確認する

エージェントのデータについて学習するために、Genie はワークスペース内の情報にアクセスして、テーブルとビジネス セマンティクス間のリレーションシップをより深く理解します。 エージェントにデータ資産を追加すると、Genie は、それらの資産に関連付けられている関連する一般的なワークスペース クエリを自動的に検索します。 ユーザー資格情報は、少なくとも CAN VIEW アクセス許可を持っている関連するクエリを検索するために使用されます。 検索でクエリが返された場合、[命令] パネルの [データ] タブに通知が表示されます。 [ 確認 ] をクリックして、提案されたクエリを表示します。

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

[提案されたクエリの確認] ダイアログを使用して、提案されたクエリを確認、編集、受け入れる、または拒否します。 Genie エージェントに対する少なくとも CAN EDIT アクセス権を持つ他のユーザーは、クエリ自体に対して少なくとも CAN VIEW アクセス権を持っている場合、クエリを確認できます。

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

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

推奨されるクエリが返されない場合:

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

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

Genie エージェントに含めるデータ オブジェクトを管理するには、[ 構成>Data] をクリックします。 [ 追加 ] ボタンをクリックして、さらにテーブルを追加します。 テーブル名の右側にある をクリックして、エージェントからテーブルを削除します。

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

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

設定を構成する

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

• タイトル: タイトルは、他のワークスペース オブジェクトと共にワークスペース ブラウザーに表示されます。 エンド ユーザーが Genie エージェントを検出するのに役立つタイトルを選択します。
• 既定のウェアハウス: このコンピューティング リソースは、Genie エージェントで生成された SQL ステートメントを利用します。 倉庫選択を保存すると、計算認証情報がGenie Agentに組み込まれ、すべてのユーザーに倉庫アクセスを提供します。 これらの埋め込み認証情報は倉庫へのアクセスのみを許可します。 データアクセスは常に各エンドユーザーのUnity Catalog権限に基づいて評価されます。 ウェアハウスを変更するには、エージェントに対する少なくとも CAN EDIT 権限が必要です。 別の作成者が後でウェアハウスを変更した場合、代わりにコンピューティング資格情報が埋め込まれます。 Genie エージェントは、プロまたはサーバーレスの SQL ウェアハウスを使用できます。 最適なパフォーマンスを得るための Databricks では、サーバーレス SQL ウェアハウスを使用することをお勧めします。
• タグ: 管理を容易にするために、タグを使用してGenieエージェントを整理および分類します。 「タグの追加」を参照してください。
• サムネイル: Genie エージェントにサムネイル画像を追加します。 サムネイルは Genie エージェントの最初のチャット ページと Genie One に表示されます。
• 説明: Genie Agente を開くと、ユーザーに説明が表示されます。 このテキスト領域を使用して、エージェントの目的を説明します。 説明フィールドでは、テキストのスタイルを設定したり、便利なコンテキストや参照へのリンクを指定したりできるように、Markdown の書式設定がサポートされています。 マークダウン構文の詳細については、 マークダウン ガイドのチート シートを参照してください。
• 一般的な質問: 一般的な質問は、ユーザーが質問できる質問の種類の省略可能な例です。 これらはエージェントのチャット ランディング ページに表示され、作成中または後でエージェントの 設定から追加できます。 作成者が定義した一般的な質問が優先され、最初に表示されます。 チャットのランディング ページを埋めるのに十分な一般的な質問を入力すると、質問のみが表示されます。 入力する数を減らした場合、Genie は残りのスロットに自動生成された質問を入力します。

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

タグを追加する

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

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

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

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

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

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

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

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

各ユーザーが同じ Genie エージェント内で表示できるデータを制限するには、Unity カタログの基になるテーブルに行レベルのセキュリティを適用します。 Unity カタログで定義されている行フィルターと列マスクは、Genie エージェントの共有方法に関係なく、ユーザーごとに自動的に適用されます。 「行フィルターと列マスク」を参照してください。

Genie エージェントを共有する場合、ユーザーはエージェントと対話するために次のアクセス許可を持っている必要があります。

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

新しい Genie エージェントは、既定でユーザー フォルダーに保存されます。 他のワークスペース オブジェクトと同様に、外側のフォルダーからアクセス許可を継承します。 ワークスペース フォルダー構造を使用して、他のユーザーと共有できます。 「ワークスペース ブラウザー」をご覧ください。

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

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

1. [共有] をクリックします。
2. エージェントを共有するユーザーまたはグループを入力します。 次に、[ 追加 ] をクリックし、適切なアクセス許可レベルを設定します。 小規模グループの個々のユーザーとメンバーは、エージェントが共有されたことを確認する電子メール通知を受け取ります。
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 を開き、メトリック ビューの定義を調整します。
6. Create をクリックしてください。

Genieエージェントに認証を割り当てる

Genieエージェントを認定または非推奨としてマークすることで、その信頼やライフサイクルのステータスを示すことができます。 認証はUnityカタログ system.certification_status ガバナンドタグを使用します。 適用するには、そのタグにASSIGNの許可が必要です。

Genieエージェントに認証を割り当てるには、以下の手順を行います:

1. 認証したいジーニーエージェントを開いてください。
2. エージェントの右上隅にあるをクリックし、認証を割り当てを選択してください。
3. [ 認定済み]、[ 非推奨]、または [なし] を選択します。
4. 保存 をクリックします。

認証状況による検索方法など、認証に関する詳細は、「 認証済みまたは非推奨のフラグデータ」をご覧ください。

その他のリソース

• ベスト プラクティスに関するガイダンスと問題のトラブルシューティングに関するヘルプについては、「 効果的な Genie エージェントのキュレーション」を参照してください。
• SQL の例、手順、および設定を追加する方法については、「 Genie エージェントの品質を調整する」を参照してください。
• エージェントをテスト、確認、および監視する方法については、「 Genie エージェントのテストと監視」を参照してください。
• 監査ログを使用して Genie エージェントのアクティビティと使用状況を追跡する方法については、 Genie エージェントのイベントに関するページを参照してください。
• Genie Agents API を使用して、Genie エージェントをプログラムでインポートおよびエクスポートし、Genie 会話 API を使用する方法について説明します。 Genie API リファレンスも参照してください。
• カスタム エージェントを使用してマルチエージェント システムを作成する方法については、「マルチエージェント システム での Genie の使用 (モデル サービス)」を参照してください。