depuración del agente uip

Ejecute un agente de código bajo en Studio Web con entradas de muestra y transmita el resultado con `uip agent debug`.

uip agent debug ejecuta un agente de código bajo de extremo a extremo en Studio Web con las entradas que proporciones, sondeando hasta que finaliza la ejecución y cambia el estado de transmisión. Requiere inicio de sesión.

El proyecto debe utilizar un manifiesto project.uiproj: un proyecto que aún esté en el diseño project.json antiguo falla rápidamente con las instrucciones de conversión (los comandos de empaquetado como uip solution pack/publish siguen aceptando project.json; solo los comandos vinculados a Studio Web como este requiere el manifiesto más reciente).

Sinopsis

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

Todas las invocaciones respetan las opciones globales (--output, --output-filter, --log-level, --log-file). Los códigos de salida siguen el contrato estándar.

Argumentos

• <project-path> obligatorio) : ruta al directorio del proyecto del agente (que contiene agent.json).

Opciones

Marca	Predeterminado	Propósito
-i, --inputs <json>	{}	Argumentos de entrada como un objeto JSON, por ejemplo '{"input":"hello"}'. Debe analizarse como un objeto sin formato.
--poll-interval <ms>	2000	Intervalo de sondeo en milisegundos.
--timeout <seconds>	600 segundos (10 minutos)	Máximo de segundos de espera para que finalice la ejecución.
--login-validity <minutes>	10	Minutos mínimos restantes antes de la expiración del token necesarios para continuar.

Ejemplos

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

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

Forma de datos (--json de salida)

Correcto (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á presente solo cuando la ejecución produjo uno; Info solo está presente cuando el servicio devolvió información de diagnóstico adicional.

Estado terminal no exitoso : lo mismo Code: "AgentDebug", pero devuelto como un error (código de salida 1) con Message: "Debug run <state>." y Instructions apuntando a uip traces spans get <TraceId> para inspeccionar la ejecución.

Manifiesto del proyecto 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."
}

Relacionado

• uip agent validate : se ejecuta primero para confirmar que el proyecto está bien formado; sugerido en las instrucciones de error de carga.
• uip traces spans get : inspecciona el seguimiento de una ejecución de depuración después de un estado fallido.

Ver también

• Autenticación, opciones globales, códigos de salida.