Genie エージェントを使用してボリューム内のファイルを分析する

Genie エージェントは、PDF、Word ドキュメント、スライド デッキ、画像など、Unity カタログ ボリュームに格納されている非構造化ファイルを分析できます。 エージェント作成者は最大10巻を添付し、ビジネスユーザーはエージェントの構造化データとともに自分のコンテンツについて質問を1回の会話で行います。

ジーニーエージェントにファイルについて尋ねること

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

• 解決に最も時間がかかっているサポートの問題と、エスカレーション要求で顧客が何を言っているか。
• 後期営業案件がストールしている理由と、販売呼び出しログに最も頻繁に表示される異議は何ですか?
• どのリージョンがパフォーマンスが低く、内部エスカレーション ポリシーが適用されますか?

ボリュームに格納されているファイルを分析するのではなく、ローカル CSV またはExcel ファイルを 1 つの会話にブレンドするには、「Genie エージェントへのファイルのアップロード」を参照してください。

ジーニーエージェントがファイルを分析する方法

ユーザーがボリュームからコンテキストを必要とする質問をした場合、Genieエージェントはその質問に最も関連性の高いファイル内容を取得し、エージェントのコンテキストに追加します。 エージェントは、そのコンテンツを構造化されたデータと一緒に推論して、引用文献を含む回答を生成します。

ファイル分析はエージェント モードでのみ実行され、複数ステップの推論を使用して関連するファイルを取得および分析します。 「エージェント モード」を参照してください。

Genie エージェントは、質問を行うユーザーのアクセス許可を常に使用します。 接続されたボリュームに対して少なくとも READ VOLUME 権限を持たないユーザーは、エラーを受け取ります。 ユーザーは、同じ会話内の特定のボリューム、複数のボリューム、構造化データについて質問できます。

Requirements

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

• ワークスペースで有効になっている Unity カタログ。
• リージョンで使用可能なエージェント モード。 リージョンの可用性に関する情報を参照してください。
• 明確な命令とテーブル メタデータを備えた、適切に準備された Genie エージェント。 効果的な Genie エージェントのキュレーションを参照してください。
• 関連するファイルを含む 1 つ以上の Unity カタログ ボリューム。
• エージェントのすべてのユーザーの ワークスペース アクセス 権と Databricks SQL アクセス 権の両方。 ユーザーは ワークスペースアクセスなしで Genie の残りの部分を使用できますが、この機能には両方が必要です。 「エンタイトルメントを管理する」を参照してください。
• エージェントのすべてのユーザーに対して、接続されているボリュームに対する少なくとも READ VOLUME のアクセス許可。

Genie エージェントにボリュームを接続する

開始する前に、要件を確認 します。

Genie エージェントにボリュームを接続するには:

1. ファイルを追加する Genie エージェントを開きます。
2. [ ソース ] タブを開き、[ 追加] をクリックします。
3. 1 つ以上のボリュームを選択します。 Genie エージェントはボリューム全体を処理します。 ボリューム内のフォルダーまたはファイルのサブセットをアタッチすることはできません。
4. [説明] フィールドに明確な説明を追加します。 ファイルに関する質問については、「エージェントを最適化する」を参照してください。
5. オプションで、添付した巻のコンテンツ検索を有効にしてください。 添付された巻については「コンテンツ検索を有効にする」をご覧ください。

添付巻のコンテンツ検索を有効にする

Databricksは、添付したボリュームのコンテンツ検索を有効にすることを推奨しています。 コンテンツ検索はファイルを準備しインデックス化することで、Genieエージェントがより効果的にファイルを活用できるようになり、より多くのファイルに対して推論し、より低い遅延で質問に答える能力を向上させます。 インデックスボリュームには最大10,000個、各ファイルは最大50MBまで収録可能です。 Unity カタログの巻についてはコンテンツ検索を参照してください。

ファイルに関する質問に対してエージェントを最適化する

ボリュームをアタッチしたら、次の推奨事項に従って、Genie エージェントがそれらのコンテンツを使用できるようにします。

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

ファイルに関する質問

Genie エージェント内のファイルに関する質問をするには:

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

Limitations

次の制限事項が適用されます。

• Genie エージェントには最大 10 個のボリュームをアタッチできます。
• この機能は AWS GovCloud では使用できません。
• コンシューマー専用、Databricks SQL 専用、およびアカウント専用のユーザーは、この機能を使用できません。 エージェントのすべてのユーザーは、 ワークスペース アクセス 権と Databricks SQL アクセス権の 両方を持っている必要があります。
• コンテンツ検索が有効でないボリュームでは、Genieエージェントは質問ごとに最大5つのファイルからコンテキストを取得することができます。 コンテンツ検索なしの巻については「制限事項」を参照してください。
• Genieエージェントは、GoogleドライブやSharePointのファイルなどの外部ファイルを分析できません。
• Web 検索ツールは使用できません。

コンテンツ検索なしの巻の制限

Databricksは、添付したボリュームでコンテンツ検索を有効にすることを推奨しています。 添付された巻のコンテンツ検索を有効にしていない場合、Genieエージェントは質問ごとに最大5つのファイルからコンテキストを取得することができます。 さらに、読み取れるファイルには以下の制限が適用されます:

Genieエージェントは、サポートされていないファイルタイプや最大ファイルサイズを超えるファイルを無視します。 ボリューム内の他の対応ファイルを使って質問に答え続けます。

よく寄せられる質問

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

この機能はどのように課金されますか?

請求は、添付されたボリュームがコンテンツ検索が有効かどうかによって異なります。 どちらの場合も、エージェントは取得したコンテンツについて判断し、これは標準的なGenie使用の一部として請求されます。 Genie の価格を参照してください。

• コンテンツ検索なしのボリュームズ:ベータ期間中、ユーザーはエージェントが取得したコンテンツについての判断に対してのみ請求されます。
• コンテンツ検索機能付きのボリューム:エージェントはクエリ時にファイルを解析する代わりに既存のインデックスを照会するため、取得にFoundation Model Serservingコストがかかりません。 代わりにインジェストおよびクエリサービスコストが発生します。 コンテンツ 検索の請求方法をご覧ください。

マルチエージェント スーパーバイザーの代わりにこの機能を使用する必要があるのはいつですか?

エージェントが特定のドメイン内の構造化データと非構造化データ全体の質問に回答できるようにする場合は、Genie エージェントにボリュームをアタッチします。 モデルの選択、チャンク戦略、複数のサブエージェントの調整など、エージェントの動作をきめ細かく制御する必要がある場合にのみ、カスタム スーパーバイザ エージェントを構築します。

Genie One の代わりにこの機能を使用する必要がある場合

特定のドメインの質問に回答する特殊なエージェントを構築する場合は、Genie エージェントにボリュームをアタッチします。 構造化データに関するすべての質問の統合エントリ ポイントとして Genie One を使用します。 Genie One は Genie エージェントを呼び出して、ファイルに関する質問に回答できます。

API を使用してボリューム内のファイルを分析できますか?

Yes. エージェント モード API を使用して、ボリューム内のファイルを分析できます。 Genie エージェントのエージェント モード API を参照してください。

その他のリソース

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

• Genie Agents の概念
• Genie エージェントの作成と管理
• 効果的な Genie エージェントをキュレーションする
• Genie エージェントにファイルをアップロードする
• Unityカタログのボリュームのコンテンツ検索