uip agent

「uip エージェント」ツールを使用して、ローコード エージェントのスキャフォールディング、検証、更新、レビュー、管理を行います。

エージェント ツールuip agent、ローコード エージェント (Agent Builder/Studio Web で作成されるagent.jsonドリブンなプロジェクト) のベース形成、検証、移行、レビューを行います。uip tools install agentを使用してインストールするか、uip agent … を呼び出して自動インストールを実行します。インストール モデルについては「 ツール (プラグイン) 」を、ツールのインストールを管理するコマンドについては「 uip tools 」をご覧ください。

このツールはコード化されたエージェント ツール (uip codedagentとは異なります。コード化されたエージェント ツールは、LangGraph / LlamaIndex / OpenAI Agents で構築された Python エージェントを対象としています。uip agent は、ローコード エージェント プロジェクト ( agent.json、 entry-points.json、 project.uiproj、 evals/ ツリー、 features/ / resources/ フォルダーを含むディレクトリ、または Maestro Flow に埋め込まれたエージェントの場合は、フロー プロジェクト内の UUID 名前の付いたサブディレクトリ (--inline-in-flow) でのみ動作します。

uip agent には、 pack、 publish、 deploy、 push、 pull、 run、 list、 share、 file、 config、 context、 escalation、 input、 output コマンドはありません。代わりに、エージェント プロジェクトのパッケージ化と出荷が uip solution を経ます (エージェント プロジェクトはソリューション内の 1 つのプロジェクトです)。リソースの作成 (ツール、コンテキスト、エスカレーション、I/O スキーマ) は、専用の CLI 動詞を使用するのではなく、 agent.jsonを手動で編集することによって行います。

UiPath エージェントとは

ローコード エージェントは、モデル、プロンプト、入出力スキーマ、ツール、コンテキスト、エスカレーション、設定という 1 つの agent.json ファイルで宣言的に記述されます。サポート ファイルには、Studio Web がエージェントを呼び出すために使用するエントリ ポイント、既定の評価セット、RAG/HITL リソースが記述されています。

uip agentでカバーされる実際のライフサイクルは次のとおりです。

1. uip agent init を使用してディスク上のプロジェクトを素早く作成します (スタンドアロン、または Maestro Flow プロジェクト内の--inline-in-flow)。既定では、プロジェクトは周囲のソリューションの .uipxに自動登録されるか、新しい <Name>Solution が存在しない場合は自動的にスキャフォールディングされます。
2. agent.json (および resources/の下にあるファイル、 evals/の下のファイル) を手編集して作成。
3. 編集のたびにプロジェクトを更新します (uip agent refresh) — 保留中のスキーマの移行を適用し、entry-points.json/bindings_v2.jsonを再生成します。これは、派生ファイルを書き込む唯一のコマンドです。
4. プロジェクトを検証します (uip agent validate) — strict、読み取り専用: 何も入力せずに「Studio Web はこのディレクトリをそのまま受け入れますか?」と答えます。
5. 決定論的なルール セット (uip agent review) に照らしてプロジェクトをレビューし、スコア付けされた品質評価が得られるほか、必要に応じて、経時的な成績を記録します (uip agent review-history add)。
6. 設定 必要に応じて、LLM モデル (uip agent model list)、メモリ空間 (uip agent memory)、ガードレール (uip agent guardrails)、ツール (uip agent tool list)
7. Studio Web (uip agent debug) に対してエージェントをデバッグし、出荷前にサンプル入力を使用してエンドツーエンドで実行します。
8. Ship withuip solution pack /publish /upload /deploy —uip agent には独自のパッケージ化動詞やデプロイ動詞はありません。
9. 評価セットに照らしてエージェントを評価する (uip agent eval run start) — クラウドにプッシュされたソリューション (--solution-id、または SolutionStorage.jsonから自動検出) に対して動作するか、どちらも利用できない場合は暗黙的なローカル ワークスペースの評価パスに対して動作します。

動詞

コマンド	目的
Init	新しいエージェント プロジェクトをディスク上にスキャフォールディングします (スタンドアロン、またはフロー プロジェクト内のインライン)。
検証	読み取り専用の厳密なチェック: Studio Web はこのプロジェクトをそのまま受け入れますか?
更新	保留中のスキーマ移行を適用し、 entry-points.json / bindings_v2.jsonを再生成します。
レビュー	決定論的なルール セット (評定、スコア、成績、問題) に照らしてプロジェクトをスコアリングします。
レビュー履歴	プロジェクトのローカル レビュー履歴ファイルにレビュー グレードを記録します。
ツールリスト	エージェントに設定されているツール リソースの一覧を表示します。
メモリ	メモリ空間とメモリ項目を添付、一覧表示、および削除します。
評価	評価器、評価セット、テスト ケース、評価の実行を管理します。
ガードレール	ガードレールの定義、BYOG ガードレール、LLM-as-judge モデル、およびガードレール カタログを一覧表示します。
model	認証されたテナントで利用可能な LLM モデルのリストを表示します。
デバッグ	サンプル入力を使用して Studio Web に対してエージェントを実行し、結果をストリーミングします。

概要

uip agent <verb> [subverb] [arguments] [options]

常に uip agentし、 uip agents したり uip aしたりすることはありません。agent ツール commandPrefix です ( uip tools listを参照)。

すべての uip agent 動詞は、4 つの グローバル オプション (--output、 --output-filter、 --log-level、 --log-file) に従います。終了コードは共有 コントラクトに従います。

エンドツーエンドのフロー

# 1. Scaffold (auto-registers into the surrounding solution, or creates one)
uip agent init ./my-agent --model gpt-5.4

# 2. Refresh after any edit to agent.json (migrates + regenerates derived files)
uip agent refresh ./my-agent

# 3. Validate the project is ready for upload (strict, read-only)
uip agent validate ./my-agent

# 4. Review for quality issues before shipping
uip agent review ./my-agent

# 5. Ship via the solution the project was registered into
uip solution pack . ./dist
uip solution upload .

# 6. Evaluate (against the cloud project once pushed, or the local workspace)
uip agent eval run start --set default --path ./my-agent --wait

# 7. Debug a specific run against Studio Web
uip agent debug ./my-agent -i '{"input":"hello"}'

認証

debug、 eval run *、 guardrails llm-as-judge-models、および model list Studio Web/LLM ゲートウェイを呼び出し、アクティブな CLI セッションが必要です。最初に uip login を実行します。セッション モデルの 「認証 」をご覧ください。

init、 validate、 refresh、 review、 review-history、 tool list、 memory、 guardrails list、および guardrails catalog はローカル専用であり、セッションを必要としません。

参照

• 概念: ツール (プラグイン) — プラグインのモデルとバージョンのピン留め。
• UIP ソリューション — エージェント プロジェクトが存在するソリューションをパッケージ化、パブリッシュ、デプロイします。
• 認証 — セッション、テナント、およびフォルダー。
• グローバル オプション、 終了コード。