uip codedagent

「uip codedagent」の構文とオプション- コード化されたエージェントを構築および実行するための Python UiPath CLI へのブリッジです。

uip codedagent は、Python ベースの UiPath コード化されたエージェント ワークフローへの細いブリッジです。適切な Python インタプリタを検出し、 uipath Python パッケージがインストールされていることを確認し、サブコマンドの固定ホワイトリストを Python CLI に転送します。review 1 つの例外は、このツールに直接実装されるネイティブ コマンドであり、転送されるものではありません。

シンラッパーとフルツールの違いについては、 ツール (プラグイン) を参照してください。

概要

uip codedagent setup [--force]
uip codedagent review [path] [--checks <categories>]
uip codedagent <whitelisted-command> [args...]

setup、 review、および転送されたコマンドには、 グローバル オプション (--output、 --output-filter、 --log-level、 --log-file) が適用されます。終了コードは 標準契約に従います。

UIP CodedAgent レビュー

コード化されたエージェント プロジェクトを決定論的なルール セットに照らして確認する — Python インタープリターは不要で、CLI でネイティブに実行されます。評定 (PASS/FAIL)、スコア (0 から 100)、文字の成績 (A+...F)、および課題のリストを返します。

引数

名前	Required	目的
[path]	×	エージェント プロジェクト ディレクトリ。既定値は .です。

オプション

• --checks <categories> — 実行するルールのカテゴリをコンマ区切りで指定します。すべてのルールを実行する場合は省略します。既知のカテゴリには、 evals、 schema、 tools、 guardrails、 code、 general (ライブ リストの場合は実行 uip codedagent review --help ) などがあります。

例

uip codedagent review ./my-coded-agent
uip codedagent review --checks code

データシェイプ (--output json)

{
  "Code": "CodedAgentReview",
  "Data": {
    "ProjectDir": "./my-coded-agent",
    "Verdict": "PASS",
    "Score": 100,
    "Grade": "A+",
    "Issues": [],
    "Strengths": [],
    "Stats": {
      "errors": 0,
      "warnings": 0,
      "infos": 0,
      "byCategory": { "evals": 0, "schema": 0, "tools": 0, "guardrails": 0, "code": 0, "general": 0 }
    }
  }
}

認識されない --checks 値は失敗し、既知のカテゴリが一覧表示される Code: "CodedAgentReviewInvalidChecks"が表示されます。

uip codedagent setup

Python を検出し、 uipath パッケージがインストールされていることを確認します。結果はユーザーごとのファイルにキャッシュされるため、後続の codedagent コマンドでPythonバイナリを即座に解決できます。

引数

設定はありません。

オプション

• --force — キャッシュされた結果が存在する場合でも、検出を再実行します。

例

uip codedagent setup
uip codedagent setup --force

データシェイプ (--output json)

{
  "Code": "CodedAgentsSetup",
  "Data": {
    "PythonPath": "/usr/bin/python3.11",
    "Package": "uipath",
    "PackageInstalled": "Yes",
    "PackageVersion": "1.0.0"
  }
}

環境チェック

• 許可される Python のバージョンは、環境変数 ( PYTHON_TOOL_PYTHON_VERSIONS) を使用して構成されます。リストが空の場合、セットアップ時に Failure が発生します。
• 現在の作業ディレクトリに .venv ディレクトリが存在するが、仮想環境がアクティブになっていない場合、セットアップは実行を拒否し、最初にアクティブにすることを提案します(Windowsでは.venv\Scripts\activate 、他の場所では source .venv/bin/activate )。

転送されるコマンド

15 個のサブコマンド名からなる固定ホワイトリストが、add、debug、deploy、dev、eval、init、invoke、list-models、new、pack、publish、pull、 codedagent exec <subcommand> ...として uipath Python CLI に転送されます。 push、register、run。このリストの外にあるもの (タイプミスを含む) は、転送を試みる前に Commander によって不明なコマンドとして拒否されます。Python には渡されません。

例

# Hand off to the Python CLI's new command
uip codedagent new my-agent

# Run the Python CLI's help for a sub-verb
uip codedagent init --help

# Execute a dev loop defined by the Python package
uip codedagent dev

注:

これらのコマンドは uipath Python パッケージによって定義されているため、そのフラグと出力形状は、CLI の標準の Code/Data エンベロープではなく、そのパッケージが出力するものです。ここでは、CLI をトランスポートとして扱います。引数サーフェスについては、 uip codedagent <command> --helpを実行します。このコマンドは Python に転送されます。ベア uip codedagent help は転送 されません — codedagent-tool は help コマンドを登録しないため、代わりに Commander 自身が生成したこのツールのヘルプを表示します。

認証リレー:転送する前に、CLI は uip login によって作成されたセッションを読み取り、次の環境変数を Python サブプロセスに挿入して、SDK が自動的に取得するようにします。

• UIPATH_ACCESS_TOKEN
• UIPATH_URL ( <baseUrl>/<org>/<tenant>として構成)
• UIPATH_ORGANIZATION_ID、UIPATH_ORGANIZATION_NAME
• UIPATH_TENANT_ID、UIPATH_TENANT_NAME

ログインしていない場合でも、転送は機能します。Python CLI は、これらの変数なしで実行されます。

--forceは常に取り除かれます: このツールは --forceのコマンド固有のルールを定義していないため、転送されたすべてのコマンドの引数が Python CLI に到達する前に無条件かつサイレントに取り除かれます。それは決してPythonに到達せず、エラーも出されません — 転送されたサブコマンドに --force 渡すことは単にno-opです。

pushには UIPATH_PROJECT_IDが必要です — 必須の環境変数であり、Python CLI が単独で強制するものではありません。プロジェクトごとに 1 回設定します。

echo "UIPATH_PROJECT_ID=<id>" >> .env
uip codedagent push

Studio Web の既存のコード化されたエージェント プロジェクトから <id> を取得します。uip codedagent push --helpでは、このチェックはスキップされます。

deploy/publish --my-workspace (または -w) には、個人用ワークスペース対応のログイン スコープが必要です。これは別のネイティブの転送前チェックです。現在の uip login アクセス トークンを読み取り、包括的なOrchestratorApiUserAccess スコープまたは細かい OR.Users.Read スコープ (いずれかを満たす) が必要です。両方を欠いているトークンは、何かがPythonに到達する前に失敗します。

{
  "Result": "Failure",
  "Message": "Current login token is missing the OrchestratorApiUserAccess (or granular OR.Users.Read) scope required for --my-workspace.",
  "Instructions": "The personal workspace publish path calls Orchestrator GetCurrentUserExtended and requires either the umbrella OrchestratorApiUserAccess scope or the granular OR.Users.Read scope. If you are using the default client, run `uip login` again — IdentityServer attaches OrchestratorApiUserAccess to issued tokens automatically. ..."
}

既定の uip login クライアントは自動的に OrchestratorApiUserAccess を取得するため、カスタム クライアントまたは制限付きスコープ リストのみが対象となります。代わりにテナント フィードにデプロイすることで、確認を完全にスキップできます ( uip codedagent deploy --tenant)。このチェックは、--my-workspace/-wが合格した場合にのみdeploy/publishに適用されます。プレーンなdeploy/publishやその他のホワイトリストにリストされたコマンドに対しては実行されません。

終了コード

標準の 終了コード が適用されます。転送されたサブプロセスの終了コードは親シェルに直接中継されるため、Python側の障害は同じゼロ以外のステータスで uip codedagent 終了します。

関連

• ツール (プラグイン) — シンラッパーツールモデル。
• uip login — Python ランタイムにリレーされるセッションを作成します。
• uip tools — codedagent-toolパッケージ自体をインストール、更新、アンインストールします。