高度なエージェント (プレビュー)

ファイル ワークスペース、サブエージェントの委任、プログラムによるツール呼び出し、サンドボックス化された JavaScript コード インタープリターを追加し、長期実行用の高度なハーネスです。

注:

この機能は、Automation Cloud でのみプレビュー版として利用可能です。Automation Suite では利用できません。

エージェントは、モデルにハーネスを加えたものです。モデルが推論を行いますが、ハーネスはモデルを駆動するループ、呼び出すことができるツール、書き込むことができるメモリなど、モデルを中心に構築されたすべてのものです。UiPath のローコード エージェントには 2 つのハーネスが用意されており、同じモデルでも、どちらを実行するかによって異なる結果が生成されます。

標準の ハーネス は、理由と行動のループです。エージェントはプロンプトを読み、ツールを呼び出し、結果を読み取って回答します。すべてが単一のコンテキスト ウィンドウに保持されます。これは効率的で予測可能で、数回のツール呼び出しで完了する作業に適しています。

高度なハーネスは、長時間のランのために作られています。中間作業をプロンプトではなくファイル ワークスペースに保持し、作業のスライスをサブエージェントに委任し、コードからプログラムでツールを呼び出し、実行の増加に応じてコンテキストを圧縮します。これにより、何十ものツール呼び出しや長いドキュメントにわたって一貫性を維持できます。そうしないと、1 つのコンテキスト ウィンドウがいっぱいになり、エージェントはすでに実行した操作を把握できなくなってしまいます。

標準と高度な比較

ハーネスはエージェントごとに選択されます。1 つのエージェントに高度なハーネスを選択しても、他のエージェントの動作は変わりません。

機能	標準ハーネス	高度なハーネス
実行ループ	理性と行動、道具を一通	行動し、観察し、調整し、完了するまで繰り返します
ワーキングメモリ	コンテキスト ウィンドウ	エージェントが読み書きするファイル ワークスペース
委任	なし	独自の分離コンテキストを持つサブエージェント
コンテキストの圧縮	利用できません。	完了したツールの出力はオフロードされ、古い履歴はプルーニングされます
ツールの呼び出し	モデルのターンごとに 1 つのツール呼び出し	ツールは、1 ターン以内にコードから呼び出すこともできます
ファイルの読み取り	Analyze Files などのファイル処理ツールが必要です	ファイルはワークスペースに到着し、組み込みのファイル ツールで読み取られます
代表的な仕事	短く、適切なスコープを持つタスク	長期実行、複数ステップ、ドキュメント量の多いタスク

ハーネスの選択

高度なハーネスは、次の信号の2つ以上を示す作業に適しています。

• 作業には時間がかかり、ほんの一握りではなく数十回のツール呼び出しが必要になります。
• エージェントの中間作業は重要であり、後で開くことができるファイルとして保持する必要があります。
• 作業の一部は独立しており、個別に処理することでメリットがあります。
• 関連する資料が、長いドキュメントや大きなレコード セットなど、1 つのプロンプトに収まる量よりも大きい。

調査、分析、ドキュメントの多いワークフローがその代表的な例です。エージェントが証拠を収集し、それを一連の基準と比較検討し、結論を正当化しなければならないタスクも同様です。

標準のハーネスは、短く、予測可能で、数回のツール呼び出しで完了するタスクに適しています。また、プレビューの制限もありません。

機能

高度なハーネスは、以下の情報をエージェントに追加します。設定は不要です。

コンテキストとファイル

• ファイル ワークスペース: ファイルを一覧表示、読み取り、書き込み、編集、削除、検索、照合するためのツールを備えた実行ごとのファイルシステムです。中間結果はプロンプトではなくファイルに送られるため、コンテキストを小さく保ちます。
• ファイルに直接アクセス: 高度なエージェントには Analyze Files ツールは必要ありません。入力ファイル、およびユーザーが会話型エージェントのチャット ウィンドウにアップロードしたファイルは、ワークスペースに自動的にダウンロードされ、組み込みのファイル ツールで読み取られます。ファイルは実際のファイルとして到着するため、エージェントはファイル全体をモデルに渡すのではなく、長いドキュメントを検索して必要な部分だけを読み取ることができます。
• ワークスペース メモリ: エージェントがワークスペース内に自身用に保持し、ターンごとにシステム プロンプトに読み込み戻されるメモです。
• コンテキストの圧縮: 完了したツールの出力がオフロードされ、古い履歴がプルーニングされるため、プロンプトは長期実行でも扱いやすい状態に維持されます。

ワークスペース メモリは、 エージェント メモリと同じ機能ではありません。ワークスペース メモリは 1 つの実行に属し、その実行のワークスペースに存在します。エージェント メモリは、エピソード メモリとエスカレーション メモリを実行間で運び、エージェント間で共有できる独立した永続ストアです。

作業を実行する

• サブエージェントの委任: エージェントは、作業の一部を汎用のサブエージェントに渡します。このサブエージェントは、独自のコンテキストで実行され、その結果のみを返します。メイン コンテキストはクリーンなままにします。
• プログラムによるツールの呼び出し: エージェントは、独自のツールを直接呼び出す JavaScript を記述します。このため、ツールの呼び出しごとにモデルをラウンド トリップするのではなく、項目のリストに展開し、フィルター処理と集計を 1 ステップで行うことができます。ユーザーの実行を一時停止するツールは除外され、代わりに通常どおり呼び出されるため、機能が失われることはありません。
• コード インタープリター: 計算、プログラムによるツールの呼び出し、およびサブエージェントのディスパッチに使用される永続的な JavaScript サンドボックスです。ネットワークもファイルシステムにもアクセスできません。
• 自己修正: ツールの呼び出しの失敗、スキーマの不一致、デッド エンドを検出し、調整されたアプローチでリトライします。

アドバンスドハーネスの選択

ハーネスは、ローコード エージェントを設計する際に [ エージェントのハーネス ] の設定で選択されます。標準ハーネスとアドバンスドハーネスの2つのオプションがあり、詳細オプションはプレビューとしてマークされています。

警告:

既存のエージェントを詳細ハーネスに移動すると、そのツールに設定されている 静的 値と引 数 の値、およびモデルごとの設定が完全に破棄されます。元に戻しても復元されません。

ファイルを操作する

ファイル入力は、標準のハーネスの場合と同じ方法で データ マネージャー で宣言され、プロンプトから名前で参照できます。すべての入力ファイルは実行開始前にワークスペースに配置されているため、エージェントが単独で検索することもできます。

ワークスペース ファイルはジョブの添付ファイルとしてアップロードされるため、それらのファイルは一時停止してから、人間による入力を待っても、実行が再開されたときに再びそこに存在します。添付ファイル名には、ワークスペース ファイルとしてマークするためにプレフィックスが付けられ、ジョブで他の添付ファイルと一緒に表示されます。

すべての実行でワークスペースが保持されるわけではありません。既定では、実行が中断されると自律型エージェントのワークスペースがアップロードされるため、中断することなく終了した実行のファイルは保持されません。会話型エージェントは、同じ会話のやり取り間でワークスペースを保持します。

消費

高度なエージェントは、標準エージェントと同じ方法で、同じユニットに対して LLM 呼び出しごとに課金されます。モデルのティアおよび料金プランごとの標準料金については、「 ライセンス」をご覧ください。

パブリック プレビューでは、高度なエージェントの消費量が 標準料金の 50% オフになります。

高度なハーネスは作業を委任および修正するため、1 回の高度なエージェントの実行で、同等の標準エージェントの実行よりも多くの LLM 呼び出しが行われます。1 回の実行の合計消費数は、呼び出しあたりのレートだけでなく、エージェントが実行した呼び出しの数によって異なります。

まだサポートされていません。

以下は、高度なハーネスの永続的な特性ではなく、プレビューのギャップです。

• ツールの引数の値を設定できません。すべてのツールパラメータはモデルによって提供されます。[静的] と [引数] の値は使用できません。
• ガードレールはサポートされていません。ガードレールが設定された高度なエージェントは実行を拒否し、起動時に失敗し、「ガードレールは高度なエージェントに対してはまだサポートされていません。」というエラーが表示されます。ガバナンス ポリシーで、エージェントをパブリッシュする前にエスカレーションまたは人間参加型のガードレールが必要な場合、それを満たすのはエスカレーションだけです。
• 一部の Integration Service アクティビティは利用できません。影響を受けるアクティビティは、詳細エージェントで無効化されていると表示されます。
• カスタム サブエージェントは定義できません。エージェントは、組み込みの汎用サブエージェントに委任します。カスタム サブエージェントの設定がサポートされるようになりました。
• 高度なエージェントをコード化されたエージェントとして複製することはできません。その変換について詳しくは、「 ローコード エージェントをコード化されたエージェントとして複製する」をご覧ください。

関連情報

• ライセンス
• エージェント メモリ
• 制限事項
• UiPath ブログの「標準エージェントと高度なエージェント」