Genie エージェントにファイルをアップロードする

Important

CSV ファイルとExcel ファイルのアップロードは、Public Preview 内にあります。 PDF ファイルのアップロードは ベータ版です。

CSV、Excel、PDF ファイルを Genie エージェントに直接アップロードして、ユーザーが Unity カタログ テーブルと共に自然言語でクエリを実行できるようにします。 これは、データの迅速な検証、軽量な分析、手動インポートや変換を行わずに外部データセットを操作する場合に便利です。

Note

Genie Agents は、以前は Genie Spaces として知られていました。

Overview

Genie エージェントにファイルをアップロードすると、Genie エージェントの会話でデータを探索できます。 Unity カタログ テーブルも含むエージェントにファイルを追加できるため、アップロードされたデータを既存のソースと共に分析できます。 データセットを手動でインポートして変換する代わりに、ファイルをチャットにドラッグ アンド ドロップし、すぐにクエリを開始できます。 これは、データの迅速な検証、軽量な分析、追加のセットアップなしで外部データセットの操作に役立ちます。

エージェントが 1 つの会話にファイルをアップロードするのではなく、Unity カタログ ボリュームに格納されている非構造化ファイルに対する質問に回答できるようにするには、「 Genie エージェントを使用してボリューム内のファイルを分析する」を参照してください。

Requirements

ファイルの要件

ファイルの種類に関係なく、会話ごとに最大 25 個のファイルをアップロードできます。

CSV ファイルと Excel ファイル

CSV およびExcelのアップロードは、エージェント モードでは使用できません。

  • 各ファイルは 200 MB 未満である必要があります。
  • 各ファイルに含まれる列数は 100 未満である必要があります。
  • Excel ファイルには複数のシートを含めることができます。 Genie は既定で最初のシートのサンプル データを表示しますが、解析できるシートはすべて使用できます。 特定のシートに対してクエリを実行するには、Genie に問い合わせて名前で参照します。

PDF ファイル

Important

この機能は ベータ版です。 ワークスペース管理者は、[ プレビュー] ページからこの機能へのアクセスを制御できます。 Manage Azure Databricks プレビューを参照してください。

PDF のアップロードにはエージェント モードが必要です。

  • 各 PDF は 20 MB より小さくする必要があります。
  • 各 PDF に含まれるページ数は 20 ページ以下にする必要があります。
  • 各 PDF は 15,000 文字に制限されています。
  • アップロードされた PDF は、現在の会話にのみ適用されます。 新しいチャット スレッドには、以前にアップロードされた PDF のコンテキストは含まれません。
  • PDF のアップロードは、UI 経由でのみ使用できます。 API ベースのファイルのアップロードはサポートされていません。

ファイルをアップロードする

ファイルをアップロードしたユーザーのみがアクセスできます。

次のいずれかの方法でファイルをアップロードします。

  • ファイルをチャット ウィンドウにドラッグ アンド ドロップします。
  • ペーパークリップ アイコン をクリックして、ファイル ブラウザーからファイルを選択します。

Genie エージェントはペーパークリップ アイコンを表示します。

ファイルのアップロードが自動的にメッセージを送信することはありません。 ファイルと一緒に送信するプロンプトを追加したり、ファイルをアップロードしてから質問することもできます。 ファイルがアップロードされて処理されると、Genie によって応答にデータが表示されます。 アップロードされたファイルとその他のデータに関する質問を Genie エージェントで確認できます。

Note

アップロードされたファイルは、ユーザー固有およびエージェント固有の Unity カタログマネージド ボリュームに格納されます。 ボリュームは一覧表示できず、スキーマ ブラウザーには表示されません。 アップロードされたファイルに対するアクセス許可を手動で管理する必要はありません。 ユーザーには、アップロードされたファイルに対する USE CATALOG、 USE SCHEMA、READ VOLUME、WRITE VOLUME の特権が自動的に付与されます。

Azure Databricksは、アップロードされたファイルをクラシックワークスペースでは顧客管理のルートストレージに、サーバーレスワークスペースではデフォルトストレージに保存します。

マネージド ボリュームの詳細については、「 Unity カタログ ボリュームとは」を参照してください。

使用可能なファイルを表示する

エージェントにアップロードされたファイルを表示するには、[ クリップ] アイコン をクリックします。ファイル メニューを開きます。 アップロードされた Excel ファイルに複数のシートがある場合は、メニューに個別のファイルとして表示されます。

ファイル形式の設定を調整する

ファイルに適用される書式設定を調整するには:

  1. クリップアイコン をクリックして、ファイルメニューを開きます。
  2. [ レンチ] アイコン をクリックします。ファイルの右側にあるレンチ アイコンをクリックします。
  3. [ ファイル形式の設定] ダイアログで設定を調整します。
  4. [ 変更の適用 ] をクリックして変更をプレビューします。
  5. [ 保存] をクリックして変更を保持し、ダイアログを閉じます。

ファイルを削除する

Genieエージェントにアップロードされたファイルには固定保存期間はありません。 以下のいずれかが起こるまで利用可能です。

  • ユーザーは「 Trash」アイコン をクリックしてファイルを削除します。添付ファイルメニューの隣にあるゴミ箱アイコンです。
  • 会話は削除されます。
  • ジーニーエージェントは削除されます。 エージェントが削除されると、ファイルは自動的に管理ストレージから削除されます。

ファイル名の右側にごみ箱アイコンが表示されている展開されたファイルの一覧。

ファイルのアップロードを無効にする

ワークスペース管理者は、Genie エージェントにファイルをアップロードできないようにすることができます。 これを行うには、 UI を使用して [データのアップロード] をオフにします。 「 データのアップロード UI を無効にする」を参照してください。

FAQ

アップロードされたファイルにアクセスできるユーザー

ファイルをアップロードしたユーザーのみがアクセスできます。

LLM に送信されるデータ

アップロードされたファイルのデータのサブセットが外部モデルに送信され、応答品質を向上させ、ファイルを適切に解析するために使用されます。

ファイルをアップロードできないのはなぜですか?

Genie エージェントに対する CAN RUN アクセス許可が少なくともない場合、アップロード オプションは使用できません。 ワークスペース管理者は、UI ワークスペース設定を 使用してデータのアップロードを オフにしたか、ワークスペースの Genie - Upload File プレビューを無効にしている可能性もあります。 「 データのアップロード UI を無効にする」を参照してください。

  • Last updated on