バッチ変換

CSV ファイルを 1 行ずつ処理し、定義したタスクに基づいて AI により生成された列を追加する組み込みのエージェント ツールです。

機能

バッチ変換は、CSV ファイルを 1 行ずつ処理し、AI により生成された列を追加する組み込みツールです。ソース CSV、各行の処理内容を記述するタスク、および追加する列を指定します。これらの列が入力された新しいファイルが返されます。

バッチ変換は、ツールとして 自律型エージェント にアタッチします。エージェントは推論中にツールを呼び出し、ソース ファイルとタスクを渡し、変換されたファイルを残りの作業で使用します。

このノードには、パレットの [組み込みツール] カテゴリで [バッチ変換 ] というラベルが付けられます。

使用すべき状況

バッチ変換は、エージェントが CSV の行を一括で強化または分類する必要があり、各行に同じ AI ドリブンな処理が必要な場合に使用します。

代表的なタスク

• 各行をカテゴリに分類し、そのラベルを新しい列に書き込みます。
• フリーテキスト フィールドから独自の列に値を抽出します。
• 既存の列に基づいて各行をスコアリング、要約、またはタグ付けします。

表形式の行を変換するのではなく、単一のドキュメントから構造化データを抽出するには、代わりに ドキュメント抽出 リソースを接続します。行指向の CSV ではないファイルの内容を分析するには、組み込みツールである Analyze Files を使用します。

ツールを追加する

ツールをキャンバスに追加してから、エージェントに接続します。

1. 自 律型エージェント ノードを選択します。フローにまだノードがない場合は追加します。
2. ノード パレットを開き、[ 組み込みツール ] カテゴリを選択します。
3. [ バッチ変換] を選択します。フローによってノードがキャンバスに追加されます。
4. バッチ変換ノードからエージェントのツール ハンドルまでのエッジを描画します。
5. バッチ 変換 ノードを選択してプロパティ パネルを開き、設定します。

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

構成のリファレンス

これらのフィールドは、[プロパティ] パネルの [ バッチ変換の設定 ] セクションで設定します。

フィールド	Required	既定 (Default)	説明
ソース (ファイル)	はい	なし	変換する CSV ファイルフローのアップストリームで生成されたファイル、またはエージェントがツールを呼び出すときに提供するファイルを参照します。
バッチ変換タスク	はい	なし	ツールが各行に適用される指示。分析する対象、抽出する対象、出力列の入力方法を記述します。
出力列	はい	なし	ツールがファイルに追加する列。名前と説明を含む列を少なくとも 1 つ定義し、最大 10 列を追加します。
列名	はい	なし	出力ファイルの新しい列のヘッダー。
説明	はい	なし	列に含まれるコンテンツ。ツールはこの値を使用して各行に何を書き込むかを決定するため、予期される形式を具体的に指定します。
Web 検索のグラウンディング	いいえ	有効	ツールで Web 検索を使用して結果をグラウンディングまたは強化できるかどうか。ソース ファイルとタスクのみを使用するには、[ 無効 ] を選択します。

入力と出力

入力

バッチ変換は、設定したフィールド (ソース CSV、タスク、出力列、Web 検索のグラウンディングの設定) から入力を取得します。ツールとして実行されるため、呼び出し元のエージェントは、実行中にツールを呼び出すときにこれらの値を指定します。

出力

バッチ変換は、 ファイル、つまり出力列が追加されて入力されたソース CSV を返します。$vars.<nodeName>.outputからアクセスします。<nodeName> はバッチ変換ノードの名前です。

$vars.batchTransform1.output

ツールが失敗した場合、ノードは代わりに error オブジェクトを設定します。エラーの形状とそのルート処理方法については、「 エラー処理 」をご覧ください。

{
  "output": "file. The source CSV with the configured output columns added and populated.",
  "error": "object. Populated only on failure. See Error handling."
}

例

サポート チケットの CSV をトリアージする

エージェントはサポート チケットの CSV を受け取り、ルーティングする前に各チケットを分類して優先順位付けする必要があります。

バッチ変換ツールをエージェントに接続し、次のように設定します。

ソース (ファイル): チケット CSV (フローの先頭から渡されたファイルなど)

バッチ変換タスク:

For each ticket, read the Subject and Body columns. Classify the ticket into exactly one category: billing, technical, or account. Then assign a priority of high, medium, or low based on the urgency expressed in the text.

出力列:

• Category: チケットの件名と本文に基づく、請求先、技術、またはアカウントのいずれか。
• Priority: チケットの緊急性を反映する、高、中、低のいずれかです。

エージェントがツールを呼び出すと、バッチ変換は、すべての行に Category と Priority 列が追加された元の CSV を返します。その後、エージェントは、その強化されたファイル ( $vars.batchTransform1.outputで利用可能) をタスクの残りの部分で使用します。

関連ページ

• オペレーター
• ドキュメントの抽出
• エラー処理