Agents ガイド

最終更新日時 2026年2月18日

ファイルを操作する

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

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

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

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

ファイル入力

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

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

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

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

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

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

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

File の種類の引数の追加

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

[ファイルをダウンロード] アクティビティの出力を受け入れるエージェントを含む簡単な例

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

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

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

ファイル入力を含むエージェントを使用したジョブの実行

Data Mapping

注:

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

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

エージェントが File 型の入力引数を定義する場合、評価の実行時にテスト入力として使用するファイルを評価の設定でアップロードまたは選択できます。これにより、実際のドキュメントや画像 (スクリーンショット、PDF、その他のサポートされているファイルの種類など) に対してエージェントの動作を検証できます。

評価でファイルを使用するには、以下の手順を実行します。