- スタート アップ ガイド
- UiPath 会話型エージェント
- Studio Web での UiPath Agents
- UiPath のコード化されたエージェント
- Coding Agents で構築する
フロー内のエージェント
Inline agent nodes in Flow projects in Maestro, configured on the Studio Web canvas alongside connectors and script nodes without a separate publishing step.
UiPath Agents in Flow lets you embed low-code agents directly inside a Flow project in Maestro as inline agent nodes. Instead of building an agent separately in Agent Builder and invoking it through a process call, you configure the agent's system prompt, model, input/output schema, and tools from the same Studio Web canvas where you design the flow.
インライン エージェント ノード は、フロー キャンバス上のファーストクラス ノードです。これらは、コネクタ、スクリプト ノード、その他のフロー コンポーネントとともに表示されます。フロー変数はネイティブにインライン エージェントとの間で渡されます。また、1 つのフロー内で複数のエージェントを順番に連鎖させることができます。
インライン エージェントとスタンドアロン エージェント
| フロー内のインライン エージェント | スタンドアロン エージェント | |
|---|---|---|
| 設定スペース | Studio Web のフロー キャンバス | Studio Web での Agent Builder |
| デプロイ | 個別のパブリッシュ ステップはありません。エージェントはフローの一部です | フローで使用する前に、スタンドアロンのエージェント プロセスとしてパブリッシュする必要があります |
| 変数交換 | エージェントのプロンプトと出力でネイティブに参照されるフロー変数 | プロセスの呼び出しパラメーターを介して渡される変数 |
| チェーン | 1 つのフローで複数のエージェントを直列に並べる | エージェント ツールを使用して、あるエージェントから別のエージェントを呼び出す |
| プロンプトでの変数の挿入 | $規則 ($vars、 $metadata) を使用します。 | Studio Web の @ 規則を使用します |
エージェントの種類
- 自律型 — エージェントはツールを選択して実行し、タスクを完了します。
ツール
インライン エージェントは、次のツール カテゴリをサポートしています。
| ツールのカテゴリ | 利用可能状況 |
|---|---|
| RPA プロセス | 利用可能 |
| API ワークフロー | 利用可能 |
| Activities (アクティビティ) | 利用可能 |
| その他のフロー (Maestro) | 利用可能 |
| エージェント (パブリッシュ済みのスタンドアロン エージェントを呼び出し) | 利用可能 |
| Integration Service のコネクタ | 利用可能 |
| 組み込みツール (ファイルを分析、要約、バッチ変換) | 利用可能 |
| エスカレーション | 利用可能 |
| MCP ツール | 利用できません。 |
| 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 ジャッジのシミュレーション | 言語モデルを使用して、シミュレートされたエージェントの実行パスを判断します。 |
| ツールの呼び出し | ツールの呼び出しの引数 | ツールが正しい引数で呼び出されたことを確認します |
| ツールの呼び出し | ツールの呼び出し回数 | 各ツールが呼び出された回数を確認します |
| ツールの呼び出し | ツールの呼び出しの順序 | ツールが期待される順序で呼び出されたことを確認します |
| ツールの呼び出し | ツールの呼び出しの出力 | ツールの出力が期待される値と一致することを確認します |