--- title: Runs description: >- Veja o histórico de um agente, dispare uma execução manualmente e entenda o que uma execução com falha ou pulada está te dizendo. sidebar: icon: history --- Toda vez que um agente acorda, o Ali registra uma execução. O histórico é onde você descobre se um agente está valendo a pena, e é a primeira coisa a abrir quando um relatório para de chegar. Clique em **Runs** em qualquer linha de agente. ![O diálogo de execuções, listando três execuções com sua origem, status, duração e custo](/images/agents/runs.webp) Do mais recente para o mais antigo, uma linha por execução: | Coluna | O que te diz | | --- | --- | | Quando | O momento em que a execução começou | | Origem | O que acordou o agente: **Schedule**, **Event** ou **Manual** | | Status | Como ela terminou | | Duração | Quanto tempo levou | | Custo | Quanto a execução custou | ## Executando uma manualmente **Run now**, no canto superior direito, dispara uma execução imediatamente sem mexer na programação. Use logo depois de criar um agente para poder ler um relatório de verdade em vez de esperar até amanhã de manhã, e use quando você acabou de reescrever uma instrução e quer ver o efeito. Uma execução manual aparece no histórico com **Manual** como origem, então é fácil diferenciar de uma programada. ## Lendo uma execução Clique em qualquer linha para abri-la. ![Uma única execução, com seus dados, as ferramentas que chamou e o relatório que produziu](/images/agents/run-detail.webp) Quatro informações no topo: quando começou, quanto tempo levou, quantos tokens entraram e saíram, e quanto custou. **Tools it called** lista o que o agente realmente usou. Essa é a forma mais rápida de conferir se um agente está olhando para onde você acha que está. Um agente que deveria estar lendo tarefas e não está chamando nada além do dashboard tem um problema de instrução, não de permissão. Embaixo está o relatório em si, exatamente como o agente o produziu. Se a execução ainda estiver rolando, o painel avisa isso e continua atualizando. Você pode fechar a aba, o agente continua trabalhando. ## O que cada status significa | Status | O que aconteceu | | --- | --- | | **Succeeded** | A execução terminou e o relatório foi enviado | | **Running** | O agente está trabalhando agora | | **Queued** | A execução está esperando sua vez | | **Failed** | Alguma coisa deu errado durante a execução. O erro é mostrado na execução | | **Timed out** | A execução demorou demais e foi interrompida | | **Skipped** | O agente estava desativado quando o gatilho disparou | | **Out of budget** | O workspace atingiu seu orçamento de execuções, então essa execução não foi iniciada | Uma execução **Skipped** geralmente é a resposta para "por que o resumo parou de chegar?". Alguém desligou o interruptor. **Out of budget** é um limite no nível do workspace, e não algo errado com o agente. Tem mais um caso que vale a pena conhecer: uma execução pode ter sucesso e ainda assim falhar ao entregar. Quando isso acontece, a execução informa que o relatório foi produzido mas que o envio falhou, o que quase sempre significa que a integração com Slack ou Discord foi desconectada, ou que o canal foi arquivado. O relatório ainda está lá para você ler na execução. ## Quando um agente não está fazendo o que você esperava Uma checklist curta, na ordem que encontra o problema mais rápido: 1. **Ele está ativado?** Confira o interruptor na linha do agente. Um agente desativado registra execuções puladas em vez de fazer o trabalho. 2. **Ele chegou a rodar?** Um histórico vazio significa que o gatilho nunca disparou. Para um agente programado, confira os dias, o horário e o fuso horário. Para um agente de evento, confira se o evento e o filtro de status realmente correspondem ao que acontece no seu workspace. 3. **O que ele chamou?** Abra a última execução e leia **Tools it called**. Se o agente nunca chegou aos dados que você se importa, ou a instrução está apontando para outro lugar, ou ele não tem permissão para chegar lá. 4. **Leia o relatório como um estranho** Se a execução teve sucesso mas o resultado é vago, a instrução é vaga. Diga o que olhar, como ordenar, o que deixar de fora, e o que fazer quando não há nada para relatar. ## Para onde ir depois Aprimore a instrução e o gatilho. Agentes prontos que você pode instalar com um clique.