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