ファイルを操作する

Agents では、入力と出力の両方でファイルの操作がサポートされています。これにより、Maestro プロセス、RPA ワークフロー、またはスタンドアロン エージェントの実行からファイルを渡したり、ファイルを生成するツールからファイルを受け取ったりできます。

このセクションでは、ファイルを受け入れるようにエージェントを設定する方法、ファイルの処理をサポートするツール、既知の制限事項、および異なる実行環境間でファイル入力を連携させる場合の例について説明します。

ファイルを受け入れるようにエージェントを準備する

1. エージェント定義を開きます。
2. データ マネージャーで新しい入力を作成します。
3. 種類のセレクターを使用して、入力の種類を [File] に変更します。

また、ファイルを処理できるツールが少なくとも 1 つエージェントに含まれている必要があります。Agents は、ツールなしでファイルを直接処理することはありません。以下のツールでファイルを受け入れたり生成したりできます。

• RPA ワークフロー – ファイルを処理するアクティビティを含むワークフローを使用します。
• IXP – 構造化ドキュメント、半構造化ドキュメント、または非構造化ドキュメントからフィールドを抽出するためのカスタム モデルまたはテンプレートが設定されたモデルを使用します。
• Analyze Attachments – 対応するファイルをモデルに直接送信します。

以下のツールは、まだファイルの入力または出力に対応していません。ファイルのサポートは今後のリリースで追加予定です。

• API ワークフロー
• MCP サーバー
• Integration Service アクティビティ – 回避策として、RPA ワークフローを使用してファイル操作に対応できます。
• コンテキスト グラウンディング – インデックスを参照することはできますが、まだ Just-In-Time 検索用にファイルを直接提供することはできません。
• エスカレーション – ファイルを操作するには、まずファイルをストレージ バケットにアップロードしてから、ドキュメント ビューアーとアプリ ファイル変数を使用してインポートして表示します。

Maestro プロセスからファイルを渡す

Maestro プロセス内でエージェントにファイルを渡すには、以下の手順を実行します。

1. プロセスに、ファイルを出力するアクティビティまたはワークフローが含まれていることを確認します。
2. または、プロセスが開始時にファイルを受け取る場合は、File の種類の引数を追加します。

3. ファイル入力を使用するエージェントを追加し、ファイル変数をエージェントの入力にマッピングします。
4. プロセスをデバッグ モードまたはデプロイ済みモードで実行すると、エージェントは実行時のファイルを受け取ることができます。

RPA ワークフローからファイルを渡す

RPA ワークフローからファイルを渡すには、以下の手順を実行します。

1. ワークフロー内のアクティビティまたはトリガーによってファイルが生成されることを確認します。
2. [ジョブを実行] アクティビティを使用して、ファイル入力を持つエージェントを参照します。

注:

ファイルをサポートするには、デスクトップ版の Studio 2025.10.0 以降が必要です。

評価でファイルを使用する

評価ではファイル入力がサポートされています。ファイルを評価セットに含めるには、以下の手順を実行します。

1. 評価の設定を開きます。
2. ローカル ファイルを評価セットの一部として直接追加します。

注:

現在、シミュレーション モードではファイルはサポートされていません。