Genie Agentを使用してボリューム内のファイルを分析する
Genie Agent は、PDF、Word 文書、スライド資料、画像など、Unity Catalog ボリュームに保存されている非構造化ファイルを分析できます。エージェント作成者は最大 10 個のボリュームをアタッチし、ビジネスユーザーは単一の会話の中で、エージェントの構造化データと併せてそのコンテンツに関する質問を行います。
ベータ版
この機能はベータ版です。「これを使用するには、ワークスペース管理者が プレビュー ページから Genieエージェントによるボリューム内のファイル分析 をオンにする必要があります。」Databricksのプレビューを管理するを参照してください。
Genie エージェントは、以前は Genie Space として知られていました。
Genie Agentにファイルについて質問できること
エージェントにボリュームをアタッチすることで、ビジネスユーザーはサポートチケット、営業電話 Logs、ポリシーファイルなどのドキュメントからのデータと、エージェントの構造化テーブルからのデータを組み合わせることができます。ユーザーは次のような質問に回答できます。
- 解決に最も時間がかかっているサポート問題はどれですか？また、顧客はエスカレーション要求で何を言っていますか？
- なぜ終盤の営業機会が停滞しているのでしょうか？また、営業電話のLogsにはどのような異議が最も頻繁に現れるのでしょうか？
- どのリージョンが低パフォーマンスであり、どのような内部エスカレーションポリシーが適用されますか？
ボリュームに保存されているファイルを分析する代わりに、ローカルのCSVまたはExcelファイルを単一の会話に統合するには、Genie Agentへのアップロードを参照してください。
Genie Agentによるファイルの分析方法
ユーザーがボリュームからのコンテキストを必要とする質問をした場合、Genie Agent はその質問に最も関連性の高いファイルコンテンツを取得し、エージェントのコンテキストに追加します。その後、エージェントはそのコンテンツと構造化データを組み合わせて推論を行い、引用付きの回答を生成します。
ファイル分析はエージェントモードでのみ実行されます。これは、多段階の推論を使用して関連ファイルを検索および分析します。エージェントモードを参照してください。
Genie Agentは、常に質問するユーザーの権限を使用します。アタッチされたボリュームに対する少なくともREAD VOLUME権限を持たないユーザーは、エラーを受け取ります。ユーザーは、同じ会話内で、特定のボリューム、複数のボリューム、および構造化データを横断して質問できます。
要件
エージェントとそのユーザーには、次の要件が適用されます。
- ワークスペースでUnity Catalogが有効になっていること。
- 使用しているリージョンでエージェントモードが利用可能であること。リージョンの可用性を参照してください。
- 明確な指示とテーブルメタデータを持つ、十分に準備されたGenie Agent。効果的なGenie Agentをキュレーションするを参照してください。
- 関連ファイルを含む1つ以上のUnity Catalogボリューム。
- エージェントのすべてのユーザーに対する、 ワークスペースアクセス および Databricks SQLアクセス の両方の資格。Genieの他の機能は ワークスペースアクセス なしで使用できますが、この機能には両方が必要です。エンタイトルメントの管理を参照してください。
- エージェントのすべてのユーザーに対し、接続されているボリュームに対する少なくとも
READ VOLUMEのアクセス許可。
Genie Agentにボリュームをアタッチする
開始する前に、要件を確認してください。
Genie Agentにボリュームをアタッチするには：
- ファイルを追加したいGenie Agentを開きます。
- ソース タブを開き、 追加 をクリックします。
- 1つ以上のボリュームを選択してください。Genie Agentはボリューム全体を処理します。ボリューム内のフォルダーまたはファイルの一部をアタッチすることはできません。
- 説明 フィールドに明確な説明を追加します。ファイルに関する質問に対するエージェントの最適化を参照してください。
- オプションとして、アタッチしたボリュームのコンテンツ検索を有効にできます。アタッチされたボリュームのコンテンツ検索を有効にするを参照してください。
アタッチされたボリュームのコンテンツ検索を有効にする
Databricks では、アタッチするボリュームに対してコンテンツ検索を有効にすることをお勧めします。コンテンツ検索はファイルを準備およびインデックス化して Genie Agent がより効果的に使用できるようにします。これにより、より多くのファイルセットについて推論し、低レイテンシで質問に回答する能力が向上します。インデックス化されたボリュームには、それぞれ最大 50 MB のファイルを最大 10,000 個まで含めることができます。Unity Catalog ボリュームのコンテンツ検索を参照してください。
ファイルに関する質問向けにエージェントを最適化する
ボリュームをアタッチしたら、Genie Agentがそのコンテンツを使用できるように、以下の推奨事項に従ってください。
- 明確な説明を追加します : ボリュームにどのようなコンテンツが含まれているか、どのように編成されているか、そしてエージェントがそれをどのように使用すべきかを説明します。エージェントはこの説明を使用して、関連ファイルを検索します。
- 重複するコンテンツを避けてください ：重複する情報を含む複数のボリュームをアタッチすると、エージェントが関連ドキュメントを取得することがより困難になります。ボリューム内の個々のファイルにも同じことが適用されます。
- 無関係なファイルを避ける ：エージェントのドメインに関連するファイルのみを含めます。無関係なファイルはエージェントを混乱させる可能性があります。
- 明確なファイル名を使用する ：エージェントがファイルを区別できるように、わかりやすいファイル名を使用してください。
ファイルについて質問します
Genie Agent内のファイルについて質問するには：
- ボリュームがアタッチされている Genie Agent を開きます。
- チャットボックスでエージェント モードをオンにします。ファイルに関する質問に回答するには、エージェント モードを使用する必要があります。
- 質問を入力し、プロンプトを送信します。エージェントモードは、関連するボリュームからコンテキストを取得し、分析が完了した後に回答を生成します。
制限事項
次の制限が適用されます：
- Genie Agent に最大10個のボリュームをアタッチできます。
- この機能はAWS GovCloudでは使用できません。
- コンシューマーのみのユーザー、Databricks SQLのみのユーザー、およびアカウントのみのユーザーは、この機能を使用できません。エージェントのすべてのユーザーは、 ワークスペースのアクセス権限 と Databricks SQL access の両方を持っている必要があります。
- コンテンツ検索が有効になっていないボリュームでは、Genie Agentは質問ごとに最大5つのファイルからコンテキストを取得できます。コンテンツ検索が有効でないボリュームの制限事項を参照してください。
- Genie Agentは、GoogleドライブやSharePointなどの外部ファイルを分析できません。
- Web検索ツールは利用できません。
コンテンツ検索を使用しないボリュームの制限
Databricks では、アタッチするボリュームでコンテンツ検索を有効にすることをお勧めします。アタッチされたボリュームでコンテンツ検索を有効にしない場合、Genie Agentは質問ごとに最大5つのファイルからコンテキストを取得できます。さらに、読み取り可能なファイルには次の制限が適用されます：
属性 | 上限 |
|---|---|
ボリュームあたりの合計ファイル数 | 最大 500 ファイル。TXT ファイルおよび MD ファイルは、この制限には含まれません。500 個を超えるファイルが含まれるボリュームに対する質問は、エラーを返します。 |
サポートされているファイルタイプ | PDF、JPG、JPEG、PNG、TIFF、TIF、DOC、DOCX、PPT、または PPTX |
最大ファイルサイズ | 最大 10MB |
Genie Agentは、サポートされていないファイル形式や最大ファイルサイズを超えるファイルを無視します。ボリューム内の他のサポートされているファイルを使用して、引き続き質問に回答します。
よくある質問
以下の質問は、ボリューム内のファイルを分析するための一般的なトピックについて扱っています。
この機能はどのように請求されますか？
課金は、アタッチされたボリュームでコンテンツ検索が有効になっているかどうかによって異なります。どちらの場合も、エージェントは取得したコンテンツに基づいて推論を行い、これは標準のGenie使用量の一部として課金されます。Genieの価格を参照してください。
- コンテンツ検索のないボリューム ：ベータ期間中、ユーザーには取得したコンテンツに対するエージェントの推論に対してのみ課金されます。
- コンテンツ検索を使用するボリューム : エージェントはクエリー時にファイルを解析するのではなく既存のインデックスをクエリーするため、取得に基盤モデルサービングのコストは発生しません。代わりに、取り込みおよびクエリーサービングのコストが適用されます。「コンテンツ検索の請求方法」を参照してください。
Multi-Agent Supervisor の代わりに、この機能はいつ使用すべきですか？
特定のドメイン内の構造化データと非構造化データ全体でエージェントが質問に回答するようにしたい場合は、Genie Agentにボリュームをアタッチしてください。モデルの選択、チャンク戦略、複数のサブエージェントの調整など、エージェントの動作をきめ細かく制御する必要がある場合にのみ、カスタムスーパーバイザーエージェントを構築してください。
Genie One の代わりに、この機能はいつ使用すべきですか？
特定のドメインの質問に回答する専門エージェントを構築する場合は、Genie Agentにボリュームをアタッチします。構造化データに関するすべての質問の統合エントリポイントとしてGenie Oneを使用します。Genie Oneは、ファイルに関する質問に回答するためにGenie Agentを呼び出すことができます。
APIを介してボリューム内のファイルを分析できますか？
はい。AgentモードAPIを介してボリューム内のファイルを分析できます。Genie AgentにおけるエージェントモードAPIをご覧ください。
その他のリソース
関連情報については、以下のリソースを参照してください。