UIP-Agent validieren

uip agent validate führt eine lokale statische Analyse über ein Agent-Projekt aus und führt dann die Schemamigrationspipeline aus. Es ist der Befehl, den Sie nach jeder manuellen Bearbeitung von agent.json (oder entry-points.json, project.uiproj, resources/*/resource.json) ausführen sollten – und immer vor dem Packen, Veröffentlichen oder Pushen.

Die Pipeline befindet sich zuerst im Arbeitsspeicher, dann zurückschreiben: Die Migration wird für die aktuellen Dateien berechnet, und es wird nichts auf den Datenträger geschrieben, es sei denn, jede Prüfung ist erfolgreich. Wenn die Prüfungen erfolgreich sind, werden migrierte Dateiinhalte zurückgeschrieben und (nur eigenständiger Modus) das .agent-builder/ -Gerüst wird neu generiert.

Die Validierung ist nur lokal – keine Anmeldung erforderlich.

Zusammenfassung

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

Alle uip agent validate -Aufrufe berücksichtigen die globalen Optionen (--output, --output-filter, --log-level, --log-file). Austrittscodes folgen dem Standardvertrag.

Argumente

• [path] (optional, Standard .) – Agent-Projektverzeichnis. Muss agent.json enthalten; Der eigenständige Modus erfordert zusätzlich entry-points.json und project.uiproj.

Optionen

Markieren	Standard	Zweck
--inline-in-flow	aus	Validieren Sie einen Inline-Agent innerhalb eines Flow-Projekts. Überspringt die Prüfungen entry-points.json und project.uiproj und generiert kein .agent-builder/. Verwenden Sie diesen Modus, wenn für den Agent ein Gerüst mit uip agent init --inline-in-flow erstellt wurde.

Beispiele

# 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

Was ist aktiviert

Ausführungen im eigenständigen Modus, in dieser Reihenfolge:

1. Erforderliche Dateien – agent.json, entry-points.json, project.uiproj.
2. agent.json -Struktur – version === "1.1.0", type === "lowCode", projectId ist eine UUID, settings.model / settings.engine / settings.mode vorhanden, metadata.storageVersion vorhanden, messages[] hat mindestens [system, user].
3. messages[].contentTokens – Das contentTokens -Array jeder Nachricht wird von content erneut abgeleitet (Aufteilung auf {{…}}) und mit dem auf der Festplatte verglichen. Abweichungen in der Anzahl, im Typ oder in der Rohzeichenfolge sind Fehler.
4. E/A-Schemas – inputSchema und outputSchema müssen jeweils { type: "object", properties: {…} } sein, wobei jeder Eintrag in required[] in properties vorhanden ist.
5. Ressourcen – Sowohl Inline-Einträge agent.resources als auch dateibasierte resources/<Name>/resource.json -Einträge. tool Ressourcen benötigen eine UUID id, name, type, und – wenn location festgelegt ist – eine von "solution" / "external", mit properties.folderPath === "solution_folder" , wenn der Speicherort "solution" ist. Die Ressourcen escalation und mcp benötigen eine UUID und einen Namen.
6. Synchronisierung der Einstiegspunkte – entry-points.json → entryPoints[0].input / output muss mit agent.json des inputSchema / outputSchema übereinstimmen (Eigenschaftsschlüssel für beide; nur erforderliche Arrays für die Eingabe).
7. project.uiproj – ProjectType === "Agent".
8. Schemamigrationspipeline – Der Validierer migriert Dateien nach Bedarf (storageVersion Tasten, Feldergänzungen) und führt die Schemavalidierung anhand der Studio Web-Schemas durch.
9. .agent-builder/ Generierung – nur eigenständig. Schreibt Gerüst-Dateien und Patches für Referenzschlüssel in resource.json -Dateien.

Der Inline-Modus (--inline-in-flow) überspringt die Schritte 1 (teilweise – nur agent.json erforderlich), 6, 7 und 9.

Statische Fehler schlagen mit dem Exitcode 1 schnell fehl, bevor die Migrationspipeline ausgeführt wird. Migrationsfehler schlagen auch mit Exitcode 1 fehl, wobei jede fehlerhafte Datei und jeder Pfad gemeldet wird.

Datenform (--output json)

Gültig, keine Migration angewendet (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": ["…"]
  }
}

Der Inline-Modus fügt "InlineInFlow": true zur Nutzlast hinzu und lässt AgentBuilderGenerated / AgentBuilderFiles / ReferenceKeysResolved weg.

Fehler (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."
    ]
  }
}

Zugehörig

• uip agent init – erstellt ein Gerüst für Projekte, die standardmäßig immer sauber validiert werden.
• Strukturierte Änderungen, die das Agent-Projekt konsistent halten: uip agent config, uip agent input / output, uip agent tool, uip agent context, uip agent escalation.
• Verbraucher eines validierten Projekts: uip agent pack, uip agent publish, uip agent push.

Siehe auch

• Globale Optionen, Exitcodes.