Genie クリーンルームを作成

備考

ベータ版

この機能はベータ版です。アカウント管理者は、アカウント コンソールの [プレビュー] ページからこの機能へのアクセスを管理できます。アカウントレベルのプレビューの管理を参照してください。

Genie クリーンルームを使用すると、データプロバイダーは別の組織の受信者と1つのGenie Agentを共有できます。受信者はエージェントに自然言語で質問し、プロバイダーのデータに基づく回答を得られますが、エージェントの指示や生データを見ることはできません。

Genie Agentの詳細については、 Genie Agentsを参照してください。クリーンルームの概要については、 Databricksクリーン ルームとは何ですか?を参照してください。

Genie クリーンルームを使用する理由

基礎となるデータ、コンテキスト、または独自のIPへのアクセスを許可することなく、キュレートされたGenieエージェントを顧客と安全に共有します：

• データではなくエージェントを共有する : 顧客は、基になるデータやコンテキストを見ることなく、あなたのエージェントを使用できます。
• データセットの組み合わせ : 顧客は独自のデータを取り込み、両方のデータセットを組み合わせた結果から知見を得ることができます。
• 使用率の管理 ：1日のプロンプト制限を設定します。顧客はエージェントの出力を一括でdownloadできません。

Genieクリーンルームの仕組み

クリーンルームを作成すると、DatabricksはGenie Agentとそのすべての指示を、エージェントが参照するテーブル、ビュー、ボリュームとともに中央クリーンルームに共有します。受信者は、クリーンルーム詳細ページの Chat tabからエージェントとチャットします。クエリーは、どちらかの共同作業者のワークスペースではなく、中央クリーンルームでランされます。

次の表は、Genieクリーンルームで各共同編集者が何ができるかを比較したものです。

機能	プロバイダー	受信者
Genie Agentを添付して同期する	はい	No
1日あたりのプロンプト上限を設定する	はい	No
エージェントの指示と例を表示する	はい	No
データアセットを追加	いいえ（データはクリーンルームを通じて追加することはできず、Genie Agentからのみ追加できます）	はい
エージェントに質問する	No	はい

機能	プロバイダー	受信者
Genie Agentを添付して同期する	はい	No
1日あたりのプロンプト上限を設定する	はい	No
エージェントの指示と例を表示する	はい	No
データアセットを追加	いいえ（データはクリーンルームを通じて追加することはできず、Genie Agentからのみ追加できます）	はい
エージェントに質問する	No	はい

受信者は、プロバイダーのテーブル名と列メタデータを表示できます。クリーンルームのUIには受信者のサンプル値やテーブルの内容は表示されませんが、受信者が要求した場合、エージェントが行レベルの値を返す可能性があります。すべてのdownloadが無効になっているため、受信者はエージェントの出力を一括エクスポートできません。プロバイダーは、受信者が追加したデータアセット（名前を含む）を確認できません。

プロバイダーは、クリーンルームの 概要 tabにある Genie Agent Instructions で、エージェントの指示と例を確認できます。受信者は、指示が隠されているという通知を受け取り、独自の指示を追加することはできません。

プロバイダーがワークスペース内のGenie Agentを更新しても、プロバイダーがそれらの変更を同期するまで、受信者はその変更を確認できません。Genie Agentに対する変更の同期をご覧ください。

コンシューマーがプロバイダーのノートブックまたはJARをランするパッケージ化されたクリーンルームとは異なり、Genie クリーンルームはノートブックやJARをランしません。

要件

• ワークスペースはクリーンルームの要件を満たしています。要件を参照してください。

• プロバイダーと受信者の両方のアカウント管理者が、アカウント コンソールの [プレビュー] ページから Genie クリーンルーム のプレビューをオンにしました。アカウントレベルのプレビューの管理を参照してください。

• クリーンルームを作成するには、プロバイダーが以下を持っている必要があります：

  • メタストアに対する CREATE CLEAN ROOM 特権。
  • 共有するGenie Agentに対するCAN EDITアクセス許可。
  • SELECT Genie Agentが参照するすべてのテーブルとメトリクスビュー、およびすべてのボリュームの READ VOLUME です。
  • USE CATALOG およびこれらのアセットを含むカタログとスキーマに対するUSE SCHEMA。
  • 受信者のクリーンルーム共有識別子。ステップ 1. 共同作業者の共有 ID を要求しますを参照してください。

• クリーンルームに独自のデータを追加するには、受信者はクリーンルームの所有者であるか、クリーンルームに対する MODIFY CLEAN ROOM 特権を持っている必要があり、追加するテーブルまたはビューに対する SELECT およびボリュームに対する READ VOLUME に加えて、それらを含むカタログおよびスキーマに対する USE CATALOG および USE SCHEMA を持っている必要があります。

• エージェントに質問するために、受信者はクリーンルームに対するEXECUTE CLEAN ROOM TASK特権を持っている必要があります。

ベストプラクティス

Databricksは、Genieクリーンルームを作成する際に以下を推奨しています：

• 共有前にキュレーションを完了する : クリーンルームを作成する前にワークスペースでエージェントの指示と例を確認してください。受信者のエクスペリエンスはそれらに依存するためです。
• エージェントをフォーカスする : 受信者が必要とするテーブル、ビュー、ボリュームのみを参照し、エージェントのサイズ制限内に収めます。制限を参照してください。
• 控えめなプロンプト制限で起動する : トライアルや評価の場合は、日次制限を低く設定し、後で引き上げてください。
• 変更後に同期する : ワークスペースでエージェントに加えた変更は、同期するまでクリーンルームに反映されません。

Genieクリーンルームを作成する

プロバイダーとして以下のステップを実行します。

受信者の共有識別子を取得する

受信者のクリーンルーム共有識別子を要求します。コラボレーターは、共有識別子を検索するの手順を使用して共有識別子を取得できます。

クリーンルームを作成

1. Databricks ワークスペースで、 カタログ をクリックします。

2. クリーン ルーム > ボタンをクリックします。

3. クリーンルームの作成 をクリックします。

4. クリーンルーム タイプ で、 Genie クリーンルーム を選択します。

5. クリーンルーム名 に、クリーンルームの名前を入力します。

   名前にはスペース、ピリオド、スラッシュ（/）を使用できません。また、クリーンルームの作成後に名前を変更することはできません。

6. リージョン で、セントラルクリーンルームのクラウドとリージョンを選択します。リージョンの可用性をご覧ください。

7. クリーンルーム共有識別子 に、受信者の共有識別子を入力します。

   クリーンルームを作成した後は、コラボレーターを変更することはできません。

8. Genie Agent で、共有するGenie Agentを検索して選択します。後で別のエージェントに置き換えることはできません。

9. クリーンルームの作成 をクリックします。

1日あたりのプロンプト上限の設定

1. クリーンルームの詳細ページで、 出力コントロール tabをクリックします。
2. 1日あたりの許容プロンプト数 に、受信者が1日に送信できるプロンプトの最大数を入力します。
3. 保存 をクリックします。

受信者が送信する各メッセージと、受信者が再生成する各応答は、1つのプロンプトとしてカウントされます。カウントは午前0時（UTC）にResetされます。受信者は 出力コントロール tabで制限を表示できますが、変更することはできません。

Genie Agentへの変更を同期する

ワークスペースのGenie Agentを変更する際は、クリーンルームを同期して変更を共有先に共有します。同期すると、クリーンルーム内のエージェントの指示、例、参照されているテーブル、ビュー、ボリュームが更新されます。共有先が追加したデータアセットは変更または削除されません。

1. クリーンルームの詳細ページで、 概要 tabをクリックします。
2. 右側のペインの Genie Agent セクションで、 Genie Agentの同期 をクリックします。

Genieクリーンルームの使用

受信者として次のステップを実行します。

クリーンルームを開く

1. Databricks ワークスペースで、 カタログ をクリックします。
2. クリーン ルーム > ボタンをクリックします。
3. プロバイダーが共有したクリーンルームの名前をクリックします。

クリーンルームは Chat tabで開き、そこでプロバイダーのGenie Agentとチャットできます。プロバイダーのテーブル名を表示するには、 概要 tabをクリックします。

独自のデータを追加する（オプション）

エージェントにあなたのデータとプロバイダーのデータを組み合わせてほしい場合は、Unity Catalogのテーブル、ビュー、メトリクスビュー、ストリーミングテーブル、フォーリンテーブル、またはボリュームをクリーンルームに追加します。エージェントは、プロバイダーのデータとあなたのデータを並べてクエリーできます。プロバイダーは、名前を含め、追加したアセットを確認することはできません。

1. クリーンルームの詳細ページで、 概要 tabをクリックします。
2. データの追加 をクリックします。
3. 追加するデータ資産を選択し、エイリアスを確認して、 保存 をクリックしてください。

資産とエイリアスの選択の詳細については、 ステップ 3. データ資産とノートブックをクリーンルームに追加を参照してください。必要な権限については、要件を参照してください。Genieクリーンルームにノートブック、JAR、またはモデルを追加することはできません。

質問する

チャット tabで、自然言語で質問を入力するか、提案された質問のいずれかをクリックします。エージェントは、プロバイダーの指示とクリーンルーム内のデータを使用して回答します。過去の会話を表示するには、履歴アイコンをクリックします。

チャットの右上には、プロバイダーの1日あたりの上限に対して、今日残っているプロンプト数が表示されます。プロバイダーの1日あたりのプロンプト上限に達すると、UTCの午前0時までチャットに次のメッセージが表示されます：

Text

You've reached this Genie clean room's limit of {limit} prompts per day. Please wait until the next UTC day before asking another question.

制限

• Genie クリーンルームのコラボレーターは、プロバイダーと 1 つの受信者のちょうど 2 つです。クリーンルームを作成するコラボレーターがプロバイダーです。

• クリーンルームには1つのGenie Agentしか設定できません。また、別のエージェントに置き換えることもできません。

• Genieクリーンルームはチャットモードのみをサポートしています。エージェントモードはサポートされていません。

• 次のいずれかを参照するGenie Agentは追加または同期できません。エージェントはワークスペース内のこれらのソースを使用できますが、これらをクリーンルームに共有することはできません。

  • systemまたはsamplesカタログのテーブル。
  • information_schema スキーマ内のテーブル。
  • Databricks Marketplace のテーブルを含む、OpenSharing を通じて受信したテーブル。

• Genie Agentが異なるカタログから参照するテーブルは、同じschema.table名を共有できません。

• プロバイダーは受信者の会話を表示できません。

• 受信者は、クリーンルームのチャットでファイルをuploadできません。

• 受信者は、Genie Agentに独自の指示を追加することはできません。

• Genie Agent定義を圧縮したときに262,000バイトを超える場合、クリーンルームはその定義を共有できません。指示またはサンプルクエリーの数を減らしてください。

• Catalog Explorerなどの統合から作成されたGenie Agentは、クリーンルームに共有できません。

• 自然言語の回答では、プロバイダーのデータに関する情報が明らかになる可能性があります。Databricksは、Genie クリーンルームにおける集計thresholdを強制したり、回答のサイズを制限したりしません。

• 受信者のプロンプトと会話は、クリーンルームイベントシステムテーブルまたは監査Logsに記録されません。プロバイダーがエージェントをアタッチまたは同期したとき、またはプロンプト制限を変更したときに、監査LogsはcreateCleanRoomAssetまたはupdateCleanRoomAssetイベントを記録します。クリーンルームイベントを参照してください。

その他のリソース

• • Genie エージェント
  • 共有するGenie Agentの指示やサンプルクエリーなどを作成し、管理します。
• • 招待されたコラボレーターとしてDatabricksクリーンルームを操作する
  • 共有識別子を見つけて、別の組織が共有したクリーンルームで作業します。