ファイルを分析

エージェントに添付されたファイルを分析する: コンテンツに関するクエリを抽出、合成、または回答します。

機能

Analyze Files は、 自律型エージェントにアタッチする組み込みツールです。1 つ以上のファイルを大規模言語モデル (LLM) に渡し、その内容を抽出、合成、またはクエリに回答します。

ファイルには、ドキュメント、画像、またはその他の添付ファイルがあります。エージェントは推論中にツールをいつ呼び出すかを決定し、ファイルとタスクを渡すと、ツールは結果を返してエージェントが使用できます。

使用すべき状況

接続 Analyze Files エージェントは、複数の種類のファイルが混在している、または一度に 2 つ以上の添付ファイルを読み取って、質問に回答したり、添付ファイルからコンテンツを取得したりする必要がある場合に使用します。

このような場合は、代替手段よりも Analyze Files を検討してください。

• さまざまなタイプ (文書、画像、スキャン) のファイルが 1 つ以上あり、エージェントにその内容の抽出または推論を依頼する場合。
• タスクは、固定されたフィールドのスキーマではなく、自然言語 (「このドキュメントを要約する」「この画像の内容」「重要なポイントを抽出する」) で記述されます。

他の形態の作品の場合:

• 引用を含む長いドキュメント (最大 1,000 ページ) を合成するには、 要約 ツールを使用します。
• トレーニング済みのモデルを使用してドキュメントから構造化された型指定されたフィールドをプルするには、[ 抽出 ] ノードを使用します。

ツールをエージェントに追加する

ファイルを分析 ツールとして自律型エージェントにアタッチします。単独では実行されません。

1. キャンバスに 自律型エージェント を追加します。
2. ノード パレットから [ エージェント ツール ] カテゴリを開き、[ ファイルを分析] を選択します。フローによってツール ノードがキャンバスに追加されます。
3. ツールをエージェントのツール ハンドルに接続します。
4. ツール ノードを選択してプロパティ パネルを開きます。
5. 以下に記載されているようにツールを設定します。

結果: Analyze Files ツールがエージェントに接続されます。これで、エージェントは推論中にそのメッセージを呼び出すことができます。

構成のリファレンス

プロパティ パネルの [ Analyze Files Settings] セクションでツールを設定します。

フィールド	Required	既定 (Default)	説明
ツールの説明	いいえ	Analyze one or more files with an LLM to extract, synthesize, or answer queries about their content.	ツールの動作を自然言語で記述したもので、エージェントがツールを呼び出すタイミングを決定するために使用されます。エージェントがツールを使用するタイミングを制限するように調整します。
添付ファイル (配列)	いいえ	Array of files, documents, images, or other attachments to process	エージェントがツールに渡すファイルの説明。送信する添付ファイルの種類をエージェントに指示するように編集します。
項目 (ファイル)	いいえ	空	添付ファイル配列内の 1 つのファイルに対する、項目ごとの任意の説明。配列レベルの記述で十分な場合は、空のままにします。
analysisTask (文字列)	はい	なし	ファイルを処理するためのタスク、質問、または指示。平易な言葉で説明してください (例: summarize this document、 extract key points、 what is in this imageなど)。
シミュレーションの設定	いいえ	折りたたまれています。	ライブ モデルを呼び出さずにツールをテストするために使用した呼び出しの例。例を定義するには、[ 例の呼び出しを追加] を選択します。

入力と出力

入力

エージェントは、ツールを呼び出すときにファイルとタスクを指定します。上記の設定により、エージェントが渡すことができる内容とツールの動作を定義します。

出力

ツールは、結果を呼び出したエージェントに結果を返します。ツールの出力をフロー内で直接読み取る必要がある場合は、 $vars.<nodeName>.outputからアクセスします。 <nodeName> は、キャンバス上の [ファイルを分析] ノードの名前です。

$vars.analyzeFiles1.output

ほとんどのフローでは、ツールの出力を直接読み取ることはありません。エージェントは、この結果を推論の一部として使用し、 に対して独自の結果を返します $vars.<agentNode>.output。エージェントの出力図形については「 エージェント 」を参照してください。

例

エージェントが、添付ファイル (スキャンした領収書の画像と PDF 明細書) が混在する受信メールを処理し、それらに関する質問に回答します。

1. キャンバスに 自律型エージェント を追加します。
2. パレットから [エージェント ツール ] を開き、[ ファイルを分析] を選択します。
3. ツールをエージェントのツール ハンドルに接続します。
4. Analyze Files ツールで、 添付ファイル (配列) を編集して、エージェントが送信する内容を記述します (例: The receipt image and statement PDF attached to the incoming email.
5. analysisTask (string) を実行したい作業に設定します。

Read each attached file. Identify the merchant, the date, and the total amount on
the receipt, and confirm whether the statement lists a matching charge.

6. エージェントのユーザー プロンプトで、 ツールを使用するよう指示します (例: Use the Analyze Files tool to check the attachments and tell me whether the receipt matches a charge on the statement.

エージェントを実行すると、エージェントは添付ファイルを使用して Analyze Files を呼び出して分析結果を受信し、 $vars.agent1.output.contentに応答を返します。

関連ページ

• オペレーター
• 要約
• 抽出