フロー内のエージェント (プレビュー)

Maestro Flow プロジェクトのインライン エージェント ノード。コネクタおよびスクリプト ノードとともに Studio Web キャンバス上で設定し、別個のパブリッシュ手順を必要とせずに実行します。

UiPath Agents in Flow では、ローコード エージェントをインラインのエージェント ノードとして Maestro Flow プロジェクト内に直接埋め込むことができます。エージェントを Agent Builder で個別に構築し、プロセス呼び出しを通じて呼び出すのではなく、フローを設計したのと同じ Studio Web キャンバスから、エージェントのシステム プロンプト、モデル、入出力スキーマ、ツールを設定します。

インライン エージェント ノード は、フロー キャンバス上のファーストクラス ノードです。これらは、コネクタ、スクリプト ノード、その他のフロー コンポーネントとともに表示されます。フロー変数はネイティブにインライン エージェントとの間で渡されます。また、1 つのフロー内で複数のエージェントを順番に連鎖させることができます。

インライン エージェントとスタンドアロン エージェント

	フロー内のインライン エージェント	スタンドアロン エージェント
設定スペース	Studio Web のフロー キャンバス	Studio Web での Agent Builder
デプロイ	個別のパブリッシュ ステップはありません。エージェントはフローの一部です	フローで使用する前に、スタンドアロンのエージェント プロセスとしてパブリッシュする必要があります
変数交換	エージェントのプロンプトと出力でネイティブに参照されるフロー変数	プロセスの呼び出しパラメーターを介して渡される変数
チェーン	1 つのフローで複数のエージェントを直列に並べる	エージェント ツールを使用して、あるエージェントから別のエージェントを呼び出す
プロンプトでの変数の挿入	$規則 ($vars、 $metadata) を使用します。	Studio Web の @ 規則を使用します

エージェントの種類

• 自律型 — エージェントはツールを選択して実行し、タスクを完了します。

ツール

インライン エージェントは、次のツール カテゴリをサポートしています。

ツールのカテゴリ	利用可能状況
RPA プロセス	利用可能
API ワークフロー	利用可能
Activities (アクティビティ)	利用可能
その他のフロー (Maestro)	利用可能
エージェント (パブリッシュ済みのスタンドアロン エージェントを呼び出し)	利用可能
Integration Service のコネクタ	利用可能
組み込みツール (ファイルを分析、要約、バッチ変換)	利用可能
エスカレーション	利用可能
MCP tools	利用できません。
A2A (エージェント間)	利用できません。
IXP (ドキュメント抽出)	利用できません。

Context

インライン エージェントでは、Agent Builder と同等のコンテキスト グラウンディングを利用できます。

ガードレール

ガードレールは、エージェント レベル、LLM レベル、または個々のツール レベルで追加できます。ガードレールは、定義されたポリシーに照らしてエージェントの入力と出力を評価し、一致に対するアクションをトリガーします。

組み込みのガードレールにより、特定のコンテンツ カテゴリが自動的に検出されます。

• 個人を識別できる情報 (PII) を検出
• 有害コンテンツ
• 知的財産の検出
• ユーザー プロンプト攻撃

エスカレーション

インライン エージェントのエスカレーションは、Agent Builder と同等に利用できます。

出力変数

すべてのインライン エージェントは output オブジェクトを返します。既定のフィールドは contentで、エージェントの応答テキストが格納されます。構造化データを返すために、[ 変数 ] タブで追加の出力変数を宣言できます。各変数には名前と型が必要であり、システム プロンプトによってエージェントにそれらを設定するよう指示する必要があります。

アップストリーム ノードからの出力は、 $vars.<node>.output.<field>を使用して下流のノードで参照されます (例: $vars.agent1.output.content)。

デバッグと評価

デバッグ

ブレークポイント、ステップごとの実行、実行トレースを使用して、Studio Web から分離して個々のインライン エージェント ノードをデバッグできます。個々のエージェント ノードを単独でデバッグできます。ノードを選択して [ ステップごとにデバッグ ] オプションを使用します。

フル フローの実行は Orchestrator にジョブとして表示され、実行ステータスを監視できます。実行が完了すると、下部のパネルの [ 実行 ] タブに実行トレースが表示され、ステップバイステップの内訳、および各ノードのタイミング (LLM の呼び出しや出力など) が表示されます。

評価

ツールバーの [ 評価] ボタンを使用して、キャンバスから インライン エージェント をノードごとに評価できます。下部のパネルにある [ データセット ] タブと [ 評価器 ] タブでは、評価データセットと評価器を管理し、データセットの実行に評価器を追加します。[ 実行] タブには、評価の実行履歴が表示されます。

インライン エージェントの評価は Agent Builder とほぼ同等ですが、評価の作成エクスペリエンスは異なります。Agent Builder の一部の機能は、インライン フロー エージェントではまだ利用できません。詳しくは、「 制限事項」をご覧ください。

次の 3 つの評価器カテゴリを使用できます。

カテゴリ (Category)	入力	説明
出力の検証	含まれるテキスト	エージェントの出力に指定されたテキストが含まれる場合にパスされます。
出力の検証	完全一致	エージェントの出力が期待される出力に完全に一致するかどうかを確認します
出力の検証	JSON の類似性	JSON オブジェクトまたは値の構造的類似性を比較する
LLM の審査員	LLM の審査員の出力	言語モデルを使用して、出力が期待される出力にどの程度近いかを意味および意図的にスコアリングします
LLM の審査員	LLM による厳密な評価 JSON	言語モデルを使用して JSON の構造的厳密一致を判断します
LLM の審査員	LLM のジャッジの軌跡	言語モデルを使用して、エージェントが期待される動作に従っていたかどうかを判断します。
LLM の審査員	LLM ジャッジのシミュレーション	言語モデルを使用して、シミュレートされたエージェントの実行パスを判断します。
Tool Call	ツールの呼び出しの引数	ツールが正しい引数で呼び出されたことを確認します
Tool Call	ツールの呼び出し回数	各ツールが呼び出された回数を確認します
Tool Call	ツールの呼び出しの順序	ツールが期待される順序で呼び出されたことを確認します
Tool Call	ツールの呼び出しの出力	ツールの出力が期待される値と一致することを確認します