Depuração do agente do UIP

Execute um agente de pouco código no Studio Web com entradas de amostra e transmita o resultado com a "uip agent debug".

uip agent debug executa um agente de pouco código de ponta a ponta no Studio Web com as entradas que você fornece, pesquisando até que a execução termine e o estado de transmissão mude. Exige login.

O projeto deve usar um manifesto project.uiproj — um projeto ainda no layout project.json antigo falha rapidamente com instruções de conversão (comandos de empacotamento como uip solution pack/publish ainda aceitam project.json; apenas comandos vinculados ao Studio-Web como este exige o manifesto mais recente).

Resumo

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

Todas as invocações honram as opções globais (--output, --output-filter, --log-level, --log-file). Os códigos de saída seguem o contrato padrão.

Argumentos

• <project-path> (necessário) — Caminho para o diretório do projeto do agente (contendo agent.json).

Opções

Bandeira	Padrão	Finalidade
-i, --inputs <json>	{}	Insira argumentos como um objeto JSON. Por exemplo '{"input":"hello"}'). Deve ser analisado como um objeto simples.
--poll-interval <ms>	2000	Intervalo de pesquisa em milissegundos.
--timeout <seconds>	600 segundos (10 minutos)	Máximo de segundos para aguardar a conclusão da execução.
--login-validity <minutes>	10	Minutos mínimos restantes antes que a expiração do token seja necessário para prosseguir.

Exemplos

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

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

Formato dos dados (--output json)

Sucesso (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 apenas quando a execução produziu um; Info está presente apenas quando o serviço retorna informações de diagnóstico extras.

Estado terminal sem sucesso — o mesmo Code: "AgentDebug", mas retornado como uma falha (código de saída 1) com Message: "Debug run <state>." e Instructions apontando para uip traces spans get <TraceId> para inspecionar a execução.

Manifesto de projeto incompatível:

{
  "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 — execute primeiro para confirmar que o projeto está bem-formado; sugerido nas instruções de falha de upload.
• uip traces spans get — inspecione o trace de uma execução de depuração após um estado não bem-sucedido.

Veja também

• Autenticação, Opções globais, Códigos de saída.