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

Genie Agentを使用してボリューム内のファイルを分析する

Genie Agent は、PDF、Word ドキュメント、スライドデッキ、画像など、Unity Catalog ボリュームに保存されている構造化されていないファイルを分析できます。エージェント作成者はエージェントにボリュームをアタッチし、ビジネスユーザーは1回の会話の中で、エージェントの構造化データと一緒にそのコンテンツに関する質問をします。

備考

ベータ版

この機能はベータ版です。「これを使用するには、ワークスペース管理者が プレビュー ページから Genieエージェントによるボリューム内のファイル分析 をオンにする必要があります。」Databricksのプレビューを管理するを参照してください。

注記

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

Genie Agentにファイルについて質問できること​

エージェントにボリュームをアタッチすることで、ビジネスユーザーはサポートチケット、営業電話 Logs、ポリシーファイルなどのドキュメントからのデータと、エージェントの構造化テーブルからのデータを組み合わせることができます。ユーザーは次のような質問に回答できます。

  • 解決に最も時間がかかっているサポート問題はどれですか？また、顧客はエスカレーション要求で何を言っていますか？
  • なぜ終盤の営業機会が停滞しているのでしょうか？また、営業電話のLogsにはどのような異議が最も頻繁に現れるのでしょうか？
  • どのリージョンが低パフォーマンスであり、どのような内部エスカレーションポリシーが適用されますか？

Genie Agentでファイル分析を使用するタイミング​

特定のドメイン用の専門的なエージェントが必要な場合は、ボリュームをGenie Agentにアタッチします。ニーズがより広範な場合は、別のアプローチを選択してください。

  • Genie Oneを、構造化データに関するすべての質問の統合エントリポイントとして使用します。Genie Oneは、ファイルに関する質問に回答するためにGenie Agentを呼び出せます。
  • モデルの選択、チャンキング戦略、複数のサブエージェントのオーケストレーションなど、エージェントの動作をきめ細かく制御する必要がある場合にのみ、カスタムのマルチエージェントスーパーバイザーを構築します。
  • ファイルuploadを使用して、ボリュームに保存されているファイルを分析する代わりに、ローカルのCSVまたはExcelファイルを1つの会話に統合します。

Genie Agentによるファイルの分析方法​

ユーザーがボリュームからのコンテキストを必要とする質問をすると、Genie Agentはその質問に最も関連するファイルコンテンツを取得し、エージェントのコンテキストに追加します。その後、エージェントはそのコンテンツを構造化データとともに推論し、引用付きの回答を生成します。これらの引用は、ソースファイルの特定のページを指すことができます（ベータ）。

ファイル分析はエージェントモードでのみ実行されます。これは、多段階の推論を使用して関連ファイルを検索および分析します。エージェントモードを参照してください。

Genie Agentは、常に質問するユーザーの権限を使用します。アタッチされたボリュームに対する少なくともREAD VOLUME権限を持たないユーザーは、エラーを受け取ります。ユーザーは、同じ会話内で、特定のボリューム、複数のボリューム、および構造化データを横断して質問できます。

要件​

エージェントとそのユーザーには、次の要件が適用されます。

Genie Agentにボリュームをアタッチする​

開始する前に、要件を確認してください。

Genie Agentにボリュームをアタッチするには：

  1. ファイルを追加したいGenie Agentを開きます。
  2. ソース タブを開き、 追加 をクリックします。
  3. 1つ以上のボリュームを選択してください。Genie Agentはボリューム全体を処理します。ボリューム内のフォルダーまたはファイルの一部をアタッチすることはできません。
  4. 説明 フィールドに明確な説明を追加します。ファイルに関する質問に対するエージェントの最適化を参照してください。

特定のワークスペースにバインドされているカタログなど、defaultではこのワークスペースからカタログにアクセスできない場合でも、ボリュームをソースとしてアタッチできます。

ボリュームをアタッチすると、Databricksによってコンテンツ検索が自動的に有効になります。

コンテンツ検索のしくみ​

コンテンツ検索機能は、Genie Agentがより多くのファイル群に対する推論を行い、多くのファイルから特定のパッセージを抽出し、より低いレイテンシで質問に回答できるように、ファイルを解析してインデックス化します。ファイルとボリュームの制限については、 制限事項を参照してください。

コンテンツ検索はボリュームと自動的に同期された状態に保たれます。ファイルを追加、変更、または削除すると、Databricksが変更を反映してインデックスを更新するため、Genie Agentは手動のステップなしで現在のコンテンツに基づいて推論を行います。

ファイルに関する質問向けにエージェントを最適化する​

ボリュームをアタッチしたら、Genie Agentがそのコンテンツを使用できるように、以下の推奨事項に従ってください。

  • 明確な説明を追加します : ボリュームにどのようなコンテンツが含まれているか、どのように編成されているか、そしてエージェントがそれをどのように使用すべきかを説明します。エージェントはこの説明を使用して、関連ファイルを検索します。
  • 重複するコンテンツを避けてください ：重複する情報を含む複数のボリュームをアタッチすると、エージェントが関連ドキュメントを取得することがより困難になります。ボリューム内の個々のファイルにも同じことが適用されます。
  • 無関係なファイルを避ける ：エージェントのドメインに関連するファイルのみを含めます。無関係なファイルはエージェントを混乱させる可能性があります。
  • 明確なファイル名を使用する ：エージェントがファイルを区別できるように、わかりやすいファイル名を使用してください。

ファイルについて質問します​

Genie Agent内のファイルについて質問するには：

  1. ボリュームがアタッチされている Genie Agent を開きます。
  2. チャットボックスでエージェント モードをオンにします。ファイルに関する質問に回答するには、エージェント モードを使用する必要があります。
  3. 質問を入力し、プロンプトを送信します。エージェントモードは、関連するボリュームからコンテキストを取得し、分析が完了した後に回答を生成します。

コンテンツ検索のサポート対象リージョン​

コンテンツ検索は、このセクションに記載されている地域で利用できます。

一部の地域では、アカウント管理者がGeo間処理を有効にした場合にのみコンテンツ検索がランします。これにより、DatabricksはワークスペースのGeoの外でファイルを処理できるようになります。Geo間処理の有効化を参照してください。

Geo間処理を必要としない地域​

以下のリージョンについて、コンテンツ検索はワークスペースのリージョンで実行されます：

  • us-central1 （アイオワ）
  • us-east4 （バージニア）

クロスGeo処理が必要なリージョン​

次の地域では、コンテンツ検索の実行前にアカウント管理者がGeo間処理を有効にする必要があります。

  • europe-west3 （フランクフルト）

制限事項​

次の制限が適用されます：

  • Genie Agent に最大10個のボリュームをアタッチできます。

  • Google DriveやSharePointなどの外部ソースからのコンテンツを使用するには、代わりにMCPコネクタをアタッチしてください。Genie Agentを外部ツールおよびソースに接続するを参照してください。

  • エージェントのすべてのユーザーには、 ワークスペースアクセス と Databricks SQLアクセス の両方の資格が必要です。アクセス権限を参照してください。

  • ベータ期間中、アカウント専用ユーザーはこの機能を使用できません。Genie Oneへのアカウント専用ユーザーアクセスを参照してください。

  • Unity Catalog管理ボリュームのみがコンテンツ検索をサポートしています。外部ボリュームとMy Filesボリュームはサポートされていません。My Filesへのファイルの保存を参照してください。

  • 各ワークスペースで、Genie Agentにアタッチできるボリュームは最大250件です。

  • インデックス作成された各ボリュームには、最大10,000個のファイルを含めることができます。

  • コンテンツ検索では、100 MBを超えるファイルおよび500ページを超えるファイルはスキップされます。

  • コンテンツ検索は、PDF、JPG、JPEG、PNG、TIFF、TIF、DOC、DOCX、PPT、PPTX、MD、または TXT ファイルをサポートしています。他のすべてのファイル形式はスキップされます。

よくある質問​

以下の質問は、ボリューム内のファイルを分析するための一般的なトピックについて扱っています。

この機能はどのように請求されますか？​

Databricks は以下の料金を請求します。

  • ファイルの準備 ：Databricks がコンテンツ検索を有効にするか、ボリュームを同期すると、ファイルが ai_parse_document AI 関数で解析されます。これには AI Functions の価格に基づいて料金が請求されます。
  • 質問に対する回答 : ファイルに対するエージェントの推論は、標準的なGenieの使用量の一部として課金されます。See Genie 価格.

APIを介してボリューム内のファイルを分析できますか？​

はい。AgentモードAPIを介してボリューム内のファイルを分析できます。AgentモードAPIリファレンスを参照してください。

その他のリソース​

関連情報については、以下のリソースを参照してください。

このページの見出し