débogage d’agent uip

Exécutez un agent low-code sur Studio Web avec des exemples d'entrées et diffuser le résultat avec `uip agent debug`.

uip agent debug exécute un agent low-code de bout en bout sur Studio Web avec les entrées que vous fournissez, en vous interrogeant jusqu'à ce que l'exécution se termine et que l'état du flux change. Nécessite une connexion.

Le projet doit utiliser un manifeste project.uiproj — un projet encore sur l'ancienne mise en page project.json échoue rapidement avec des instructions de conversion (les commandes de packaging comme uip solution pack/publish acceptent toujours project.json; seules les commandes liées à Studio-Web comme celui-ci nécessite le nouveau manifeste).

Synthèse

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

Toutes les invocations respectent les options globales (--output, --output-filter, --log-level, --log-file). Les codes de sortie suivent le contrat standard.

Arguments

• <project-path> (requis) : le chemin d'accès au répertoire du projet d'agent (contenu agent.json).

Options

Drapeau	Default	Objectif
-i, --inputs <json>	{}	Arguments d'entrée en tant qu'objet JSON, par exemple '{"input":"hello"}'. Doit analyser en tant qu’objet simple.
--poll-interval <ms>	2000	Intervalle d'interrogation en millisecondes.
--timeout <seconds>	600 secondes (10 minutes)	Nombre maximal de secondes à attendre de la fin de l'exécution.
--login-validity <minutes>	10	Nombre minimum de minutes restants avant l’expiration du jeton requis pour continuer.

Exemples

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

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

Format des données (--sortie json)

Réussite (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 est présent uniquement lorsque l'exécution en a produit une; Info est présent uniquement lorsque le service renvoie des informations de diagnostic supplémentaires.

État terminal non réussi — même Code: "AgentDebug", mais renvoyé comme un échec (code de sortie 1) avec Message: "Debug run <state>." et Instructions pointant sur uip traces spans get <TraceId> pour inspecter l'exécution.

Manifest de projet incompatible:

{
  "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."
}

Associé

• uip agent validate — Exécutez d'abord pour confirmer que le projet est bien formé; suggéré dans les instructions d'échec de téléchargement.
• uip traces spans get — inspecter la trace d'une exécution de Debug après un état non réussi.

Voir également

• Authentification, options globales, codes de sortie.