Saídas e resultados

​

O que uma execução devolve

​

O que vira revisável

​

No painel de resultado

• Preview: o Status do Workflow (Concluído, Falhou, Cancelado, Workflow expirou) e uma seção recolhível por etapa com o status dela (Concluído, Falhou, Pulado para os caminhos não seguidos, Aguardando Execução) e a saída. Saídas estruturadas aparecem como campos, arquivos aparecem com uma pré-visualização que você pode abrir em tela cheia, saídas de código mostram o valor devolvido, e um Mapear mostra as iterações com controles de anterior/próxima. Os erros aparecem na seção da etapa que falhou.
• Debug: o custo (em dólares ou créditos), a duração, os tokens de entrada e saída, os IDs de completion e de requisição, as datas e quem iniciou a execução, e uma Linha do tempo da execução com o detalhe de cada etapa.

​

Em Depurar

• uma Visão geral da execução: ID da execução, versão, origem, quantos nós foram concluídos, as Entradas recebidas e a saída da execução;
• uma visão em Grafo e uma em Linha do tempo das etapas;
• um inspetor de nó para cada etapa, com Entrada, Saída, Erro e Metadados; para etapas de IA, o prompt como foi enviado e a Saída esperada; para Execução de Código, o Terminal; para uma Condição, qual condição Correspondeu e os Valores referenciados; para um Mapear, as Iterações com Abrir iteração como execução;
• Ações da execução: Executar novamente a mesma versão com estes inputs (editáveis antes de executar), Editar no Craft (abre o Craft na versão mais recente com as entradas desta execução preenchidas) ou Visualizar no Craft (abre a execução somente para consulta).

​

Em um App da Workstation

• Os revisores veem os atributos revisáveis descritos acima, podem editar valores e Aprovar a tarefa. Arquivos gerados ficam disponíveis para download.
• Tarefas aprovadas podem ser baixadas em CSV ou JSON e transformadas em Casos de Teste.
• Pela API de tarefas, o outputContent de uma tarefa de Workflow encapsula { response, stepOutputs, error? }: response é o resultado da execução e stepOutputs a saída de cada etapa pelo nome. Veja Criando tarefas via API.

​

Pela API

​

A Completion API

​

A API de Workflow Run

• GET /workflow/runs?promptId=<id do workflow> lista as execuções, da mais recente para a mais antiga. Filtre com status (pending, running, completed, failed, cancelled), environment (craft-preview, test-case, workstation, api), promptVersionId, e rootOnly=true para esconder as execuções filhas criadas pelas iterações de Mapear.
• GET /workflow/runs/{id} devolve uma execução com os seus steps e o graph executado. id é o ID da execução, ou o ID externo de execução que você recebeu ao iniciar a execução pela API.
• POST /workflow/runs/{id}/cancel cancela uma execução ainda ativa.

curl "https://api.tela.com/workflow/runs?promptId=9d2e4f6a-1b3c-4d5e-8f70-1a2b3c4d5e6f&status=completed&rootOnly=true&limit=20" \
    -H "Authorization: Bearer $TELA_API_KEY"

{
  "id": "exec_01J9Z8Q4M6N2P8R1S3T5V7W9X",
  "promptVersionId": "9d2e4f6a-1b3c-4d5e-8f70-1a2b3c4d5e6f",
  "environment": "api",
  "status": "completed",
  "startedAt": "2026-09-01T12:00:00.000Z",
  "completedAt": "2026-09-01T12:00:08.412Z",
  "input": {
    "contract": { "name": "contract", "type": "file", "required": true, "files": [{ "name": "acme.pdf", "mimeType": "application/pdf", "fileUrl": "vault://files/acme.pdf" }] }
  },
  "steps": [
    { "id": "extract", "name": "Extract Data", "actionId": "llm-completion", "status": "completed", "input": { "...": "..." }, "output": { "counterparty": "Acme Ltd", "total_value": 125000 }, "error": null },
    { "id": "route", "name": "Route by value", "actionId": "condition", "status": "completed", "input": { "...": "..." }, "output": "High value", "error": null },
    { "id": "note", "name": "Draft Escalation Note", "actionId": "llm-completion", "status": "completed", "input": { "...": "..." }, "output": { "note": "..." }, "error": null },
    { "id": "letter", "name": "Approval Letter", "actionId": "document-templater", "status": "skipped", "input": null, "output": null, "error": null }
  ],
  "output": { "id": "note", "name": "Draft Escalation Note", "status": "completed", "output": { "note": "..." }, "error": null, "metadata": {} }
}

• steps lista as etapas visíveis em ordem; etapas de caminhos não seguidos ficam como skipped.
• output é a etapa folha concluída cuja saída é o resultado da execução; null enquanto nenhuma etapa folha tiver sido concluída. O metadata dela pode trazer outputFormatMismatch: true quando uma etapa de IA não conseguiu respeitar o Formato de Saída.
• status pode ser pending, running, completed, failed, requires-action, cancelled, timeout ou waiting-for-review. Os status terminais são completed, failed, cancelled e timeout.
• Em GET /workflow/runs/{id}, graph.nodes repete cada etapa com as portas, o status e a saída, e um nó que rodou dentro de um Mapear tem um array runs com uma entrada por iteração (index, status, output, error).

​

Nos Casos de Teste