UIP エージェントの検証

uip agent validate は、エージェント プロジェクトに対してローカルの静的分析パスを実行してから、スキーマ移行パイプラインを実行します。これは、 agent.json (または entry-points.json、 project.uiproj、 resources/*/resource.json) を手作業で編集した後、 常にパック、公開、またはプッシュの前に実行する必要があるコマンドです。

パイプラインは 最初にメモリ内にあり、次にライトバックされます:移行は現在のファイルに対して計算され、すべてのチェックに合格しない限りディスクには何も書き込まれません。チェックに合格すると、移行されたファイルの内容が書き戻され、(スタンドアロンモードのみ) .agent-builder/ スキャフォールディングが再生成されます。

検証はローカル専用で、ログインは必要ありません。

概要

uip agent validate [path] [--inline-in-flow]

すべての uip agent validate 呼び出しでは、 グローバル オプション (--output、 --output-filter、 --log-level、 --log-file) が優先されます。終了コードは 標準コントラクトに従います。

引数

• [path] (任意、デフォルト .) — エージェントのプロジェクト ディレクトリ。次の値を含む必要があります agent.jsonスタンドアロンモードでは、さらに entry-points.json と project.uiprojが必要です。

オプション

フラグ	既定 (Default)	目的
--inline-in-flow	無効	フロー プロジェクト内のインライン エージェントを検証します。entry-points.jsonとproject.uiprojのチェックをスキップし、.agent-builder/を生成しません。エージェントに uip agent init --inline-in-flowのスキャフォールディング (骨組みが埋め込まれている場合) は、常にこのモードを使用します。

例

# Validate the current directory
uip agent validate

# Validate a specific standalone project
uip agent validate ./my-agent

# Validate an inline agent (the flow-project subdirectory)
uip agent validate ./my-flow/<uuid> --inline-in-flow

チェック内容

スタンドアロン モードは、次の順序で実行されます。

1. 必要なファイル — agent.json、 entry-points.json、 project.uiproj。
2. agent.json構造 — version === "1.1.0"、 type === "lowCode"、 projectId は UUID であり、 settings.model / settings.engine / settings.mode 存在し、metadata.storageVersion 存在し、少なくとも [system, user]messages[] です。
3. messages[].contentTokens — 各メッセージの contentTokens 配列はcontentから再派生し ({{…}}で分割)、ディスク上の配列と比較されます。count、type、または raw-string の不一致はエラーです。
4. I/O スキーマ — inputSchema と outputSchema はそれぞれ { type: "object", properties: {…} }必要があり、 required[] のすべてのエントリが propertiesに存在する必要があります。
5. リソース — インライン agent.resources とファイルベースの resources/<Name>/resource.json エントリの両方。toolリソースには、 UUID id、 name、 type、および(locationが設定されている場合は "solution" / "external"の 1 つが必要で、場所が"solution"場合は properties.folderPath === "solution_folder" が必要です。escalation リソースと mcp リソースには UUID と名前が必要です。
6. エントリポイントの同期 — entry-points.json → entryPoints[0].input / output は agent.jsonの inputSchema / outputSchema と一致する必要があります (両方のプロパティキー、入力のみに必要な配列)。
7. project.uiproj — ProjectType === "Agent".
8. スキーマ移行パイプライン — 検証者は必要に応じて (storageVersion バンプ、フィールドの追加など) ファイルを移行し、Studio Web のスキーマに対してスキーマの検証を実行します。
9. .agent-builder/の生成 — スタンドアロンのみ。スキャフォールディング ファイルを書き込み、可能であれば referenceKeys を resource.json ファイルにパッチ適用します。

インライン モード (--inline-in-flow) は、手順 1 (部分的 - agent.json のみ必須)、6、7、9 をスキップします。

静的エラーは、移行パイプラインが実行される前に終了コードが 1 され、高速に失敗します。移行エラーは、終了コード 1でも失敗し、問題のあるファイルとパスが報告されます。

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

有効で、移行は適用されていません (Code: "AgentValidation"):

{
  "Code": "AgentValidation",
  "Data": {
    "Status": "Valid",
    "ProjectDir": "/abs/path/my-agent",
    "Model": "gpt-4o-2024-11-20",
    "StorageVersion": "47.0.0",
    "MigrationApplied": false,
    "Validated": true
  }
}

Valid, migration applied

{
  "Code": "AgentValidation",
  "Data": {
    "Status": "Valid — migrated to 47.0.0",
    "ProjectDir": "/abs/path/my-agent",
    "Model": "gpt-4o-2024-11-20",
    "StorageVersion": "47.0.0",
    "MigrationApplied": true,
    "MigratedFiles": 3,
    "Validated": true,
    "AgentBuilderGenerated": true,
    "AgentBuilderFiles": 5,
    "ReferenceKeysResolved": 2,
    "Warnings": ["…"]
  }
}

インライン モードでは ペイロードに "InlineInFlow": true が追加され、 AgentBuilderGenerated / AgentBuilderFiles / ReferenceKeysResolvedは省略されます。

失敗 (Code: "AgentValidationFailed"):

{
  "Code": "AgentValidationFailed",
  "Message": "Validation failed with 2 error(s)",
  "Data": {
    "Errors": [
      "agent.json.settings.model: missing or empty",
      "messages[1].contentTokens: contentTokens has 3 entries but content requires 2. Rebuild contentTokens to match content."
    ]
  }
}

関連

• uip agent init — 既定で常にクリーンな検証を行うプロジェクトをスキャフォールディングします。
• エージェント プロジェクトの一貫性を保つための構造化された編集: uip agent config、 uip agent input / output、 uip agent tool、 uip agent context、 uip agent escalation
• 検証済みプロジェクトのコンシューマー: uip agent pack、 uip agent publish、 uip agent push

参照

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