UIP エージェントのデバッグ

サンプル入力を使用して Studio Web に対してローコード エージェントを実行し、「uip agent debug」で結果をストリーミングします。

uip agent debug は、ユーザーが指定した入力を使用して Studio Web に対してローコード エージェントをエンドツーエンドで実行し、実行が完了してストリーミングのステートが変わるまでポーリングを行います。ログインが必要です。

プロジェクトでは project.uiproj マニフェストを使用する必要があります。古い project.json レイアウトを使用しているプロジェクトは、変換指示ですぐに失敗します ( uip solution pack/publish などのパッケージ化コマンドは引き続き project.jsonを受け入れます。このような Studio Web にバインドされたコマンドでのみ、新しいマニフェストが必要です)。

概要

uip agent debug <project-path> [-i <json>] [--poll-interval <ms>] [--timeout <seconds>] [--login-validity <minutes>]

すべての呼び出しは、 グローバル オプション (--output、 --output-filter、 --log-level、 --log-file) に従います。終了コードは 標準契約に従います。

引数

• <project-path> (必須) — エージェント プロジェクト ディレクトリへのパスです ( agent.jsonを含む)。

オプション

フラグ	既定 (Default)	目的
-i, --inputs <json>	{}	JSON オブジェクトとしての入力引数 (例:'{"input":"hello"}'です。プレーン オブジェクトとして解析する必要があります。
--poll-interval <ms>	2000	ポーリング間隔 (ミリ秒)。
--timeout <seconds>	600 秒 (10 分)	実行が完了するまで待機する最大秒数です。
--login-validity <minutes>	10	続行するには、トークンの有効期限が切れるまでの最小残り時間 (分) を指定します。

例

uip agent debug ./my-agent -i '{"input":"hello"}'

uip agent debug ./my-agent --timeout 120 --poll-interval 5000

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

成功 (Code: "AgentDebug"):

{
  "Code": "AgentDebug",
  "Data": {
    "JobKey": "a1b2c3d4-0000-0000-0000-000000000401",
    "TraceId": "b2c3d4e5-0000-0000-0000-000000000001",
    "State": "Successful",
    "Output": { "content": "hi there" }
  },
  "Instructions": "Debug run completed: Successful"
}

Output は、実行で が生成された場合にのみ存在します。 Info は、サービスが追加の診断情報を返した場合にのみ存在します。

非成功の終了ステート — 同じ Code: "AgentDebug"ですが、失敗 (終了コード 1) として返され、実行を検査するために Message: "Debug run <state>." と Instructions が uip traces spans get <TraceId> を指しています。

非対応のプロジェクト マニフェスト:

{
  "Result": "Failure",
  "ErrorCode": "invalid_argument",
  "Message": "...",
  "Instructions": "Convert the listed project(s) to a project.uiproj manifest before debugging: scaffold the accepted layout with 'uip api-workflow init <name>' inside the solution and move Workflow.json (plus entry-points.json and bindings_v2.json) into it, then remove the project.json-based entry from the .uipx. Note that 'uip solution pack' and 'uip solution publish' accept project.json — only Studio Web-bound commands require project.uiproj."
}

関連

• uip agent validate — 最初に実行を実行して、プロジェクトが正しい形式であることを確認します。アップロードに失敗する手順で推奨されます。
• uip traces spans get — デバッグ実行が失敗ステートになった後にトレースを調べます。

参照

• 認証、グローバル オプション、終了コード。