バッチ変換

バッチ変換ツールを使用すると、エージェントは Just‑In‑Time (JIT) データ ソースを使用して CSV ファイルを一括で処理できます。バッチ変換は、ストレージ バケットやインデックスを事前に設定することなく、CSV ファイル内のすべての行やレコードに同じ変換ロジックを適用するシナリオのために設計されています。

バッチ変換は、実行時に提供された入力 CSV ファイルを受け取り、ユーザーが定義した変換タスクをそのファイルに適用します。ファイルを 1 行ずつ処理し、元のデータと、変換ロジックによって生成された追加の列または行を含む出力ファイルを 1 つ以上生成します。

一般的なユース ケースは次のとおりです。

• モデルによって生成されたスコア、ラベル、分類を使用して CSV ファイルを強化する
• サイズの大きいデータセットにビジネス ルールや意思決定ロジックを適用する
• 自動化された意思決定とともに、説明や正当化の理由を生成する

データ ソース

• バッチ変換では JIT データ ソースのみがサポートされます。
• CSV ファイルのみが入力としてサポートされます。
• ファイルはエージェントの入力を介して直接渡され、実行時に自動的に解決されます。
• 外部ストレージの構成やインデックスの作成は必要ありません。

詳細については、「 DeepRAG とバッチ変換のベスト プラクティス: JIT とインデックスベースの戦略」を参照してください。

バッチ変換を構成する

バッチ変換ツールを追加する

1. エージェントをデザイン モードで開きます。
2. [組み込みツール] のリストから [バッチ変換] をエージェントに追加します。

追加すると、バッチ変換ツールは専用のツール ノードとして表示され、右側のパネルから構成できます。

入力を設定する

設計時に、ツールが入力を受け取る方法を指定します。

• ソース (ファイル): ソースはファイル入力 (input-csv など) です。実行時に、エージェントを実行するときに指定したファイルに自動的に解決されます。

  注:

  データ マネージャーで File の種類の引数を設定する必要があります。

• バッチ変換タスク - バッチ変換の実行方法を定義する、ツール固有の命令です。このフィールドを使用して、以下を含む入力ファイルの処理方法をツールに正確に指示します。

  • 生成する新しい列または行
  • 各行の処理方法
  • 適用するルール、条件、または意思決定ロジック

  たとえば、各行の内容に基づいて 2 つの新しい列 (スコアと推奨フラグなど) を生成するようにツールに指示できます。これはエージェントのプロンプトではありません。エージェントに含める指示は、バッチ変換を呼び出すタイミングと最終的な出力の形式に関する大まかな指示だけにする必要があります。

  

• 出力列 - バッチ変換によって生成される新しい列のスキーマを定義します。各列に対して以下を指定します。

  • 列名
  • 列が表す内容と、その値をどのように解釈すべきかについての説明

  必要に応じて、新しい出力列を追加したり、既存の列名や説明を編集したり、列を削除したりできます。[バッチ変換タスク] で、構成したこれらの列に入力するために使用するロジックを説明する必要があります。

Web 検索のグラウンディングを有効化 (任意)

バッチ変換ツールには、Web 検索のグラウンディングの設定 (任意) があります。この設定により、変換を生成する際に Web 検索結果を使用することをモデルに許可するかどうかを制御します。

• 有効化すると、モデルは各行の処理中に Web から取得した情報で入力ファイルのデータを補完できます。
• 無効化すると、入力ファイルの内容、タスクで定義された指示、およびエージェントに対して明示的に提供したコンテキストのみを使用して変換が実行されます。

バッチ変換を実行する

エージェントを実行またはデバッグする場合、バッチ変換ツールはエージェントの実行の一部として実行されます。

• 入力ファイルは実行時にツールに渡されます。
• ファイルは 1 行ずつ処理されます。
• 変換された出力ファイルが生成されます。
• 出力ファイルは、エージェントの出力の一部として返されます。

実行中に、バッチ変換は実行トレースに専用のツール呼び出しとして表示されます。このステップを展開して、実行時の詳細情報を調べることができます。

実行の詳細を調べる

実行トレースから、ツールの呼び出しの出力およびエージェントの出力 (該当する場合) に表示される詳細を確認できます。

• 入力 - ツールによって使用された入力ファイルです。ファイルの名前、種類、メタデータ (ツールの呼び出しの出力に表示) が含まれます。
• 出力 - 生成された出力ファイルです。ファイル ID、ファイル名、MIME タイプが含まれます (ファイル出力が定義されている場合はツールの呼び出しの出力に表示されます)。
• プロンプトのコンテキスト - エージェントの実行中に使用されたシステム プロンプトとユーザー プロンプトです。変換タスクがどのように実行されたかを説明するのに役立ちます。

検証やトラブルシューティングのために、入力ファイルと出力ファイルの両方を実行トレースから直接ダウンロードできます。

ファイル出力が定義されている場合、エージェントの最終出力には通常、変換されたファイルが生成されたこと、および出力ファイル名を示す確認メッセージが含まれます。

バッチ変換を評価する

評価により、バッチ処理された出力の品質と正確性を測定できます。エージェントは、ファイル レベルで結果を評価するだけでなく、行ごとの評価もサポートしており、特に CSV ファイルなどの構造化された出力の場合に役立ちます。

行ごとの評価

行ごとの評価では、ファイルを 1 つのまとまりとして評価するのではなく、出力ファイルの各行を個別に評価します。これにより、個々のレコードが評価基準に対してどのように実行されるかをきめ細かく可視化できます。このモードは、次の場合に特に役立ちます。

• 各行が別個の判断や分類を表す場合
• サイズの大きいファイルで、きめ細かい成功/失敗のメトリックが必要な場合
• 個々の失敗にドリルダウンする必要がある場合

行ごとの評価を設定する

行ごとの評価の設定は、評価セットの設定で行います。

1. 評価セットの設定で [行ごとの評価] を有効化します。
2. 評価する出力ファイルを選択します。エージェントが複数の出力ファイルを生成する場合、これは必須です。
3. 評価器が操作するファイルの種類 (CSV など) を指定します。

設定が完了すると、選択した出力ファイルの各行に対して評価が実行されます。

CSV 列の完全一致評価器

構造化されたファイルの評価をサポートするために、CSV 列の完全一致評価器と呼ばれる決定論的な評価器が提供されています。エージェントの評価について詳しくは、こちらをご覧ください。

この評価器は以下を行います。

• 指定した 1 つ以上の列を期待される出力と実際の出力との間で比較する
• 文字列の完全一致を実行する
• 成功/失敗の結果を行ごとに返す

CSV 列の完全一致評価器は、ラベル、一致の種類、ステータス フィールドなどの明確な出力を検証するのに適しています。

評価を実行および確認する

評価セットの構成後、以下の手順を実行します。

1. 入力ファイルと、対応するバッチ変換の出力ファイルを使用して、評価の実行を作成します。
2. 評価をスケジュールまたは実行します。
3. 結果を次の 2 つのレベルで確認します。
   • ファイル レベルの概要。全体的にいくつの行が成功または失敗したかが示されます。
   • 行レベルのドリルダウン。個々の行それぞれについて、成功/失敗のステータス、値、メタデータが示されます。

たとえば、評価により、199 行中 141 行が特定の列の完全一致チェックに合格したことが示されたとします。そこからドリルダウンして失敗した個々の行を調べ、期待される値と実際の値を比較して、実行の詳細 (行ごとの遅延など) を確認できます。

行ごとの評価により以下が提供されます。

• どのレコードが成功または失敗したかについての明確な可視性
• 変換ロジックの高速なデバッグ
• 経時的な改善を追跡するための定量的なメトリック