Execuções
O que é uma execução, o que a dispara, os status pelos quais ela passa, como acompanhar, cancelar e repetir, e quando o Jiraya tenta de novo.
Uma execução é cada vez que um agente trabalha numa tarefa. A tarefa é o pedido; as execuções são as tentativas de atendê-lo. Uma mesma tarefa costuma ter várias: a primeira, uma depois de cada comentário que menciona o agente, outra quando o revisor pede ajustes.
O que dispara uma execução
- Atribuição: atribuir a tarefa a um agente, ou a um squad, cuja execução vai para o líder.
- Menção: citar o agente num comentário com
@. A execução recebe o comentário como gatilho. - Chat: cada mensagem enviada a um agente no chat.
- Autopilot: no horário agendado ou ao receber um webhook.
- Revisão: pedir ajustes devolve a tarefa ao agente com o seu comentário.
- Despertar: um despertar configurado na tarefa, por evento ou por horário.
Na CLI, jiraya issue assign, jiraya issue update e jiraya issue status aceitam --no-start, que registra a mudança sem criar uma execução.
Se o agente já está trabalhando na tarefa quando chega um comentário novo, o comentário entra na próxima execução, que mostra quantos comentários inclui.
Status de uma execução
| Status | Na tela | O que significa |
|---|---|---|
queued | Na fila | Esperando um runtime livre do agente. |
deferred | Adiado | Agendada para depois, por exemplo uma nova tentativa à espera de o runtime voltar. |
dispatched | Iniciando | O daemon pegou a execução e está preparando o diretório e a ferramenta de IA. |
waiting_local_directory | Aguardando diretório local | Outra execução está usando o mesmo diretório de trabalho; esta começa quando ele for liberado. |
running | Trabalhando | A ferramenta de IA está rodando. |
completed | Concluída | A execução terminou sem erro. |
failed | Falhou | A execução terminou com erro. O motivo aparece no log da execução. |
cancelled | Cancelada | Alguém parou a execução, ou um comentário editado substituiu o gatilho dela. |
Uma execução fica na fila quando o runtime do agente já está no limite de execuções simultâneas, ou quando o projeto atingiu o limite de tarefas com agentes trabalhando ao mesmo tempo.
Nota
A execução terminar não conclui a tarefa. O agente move a tarefa para in_review ao entregar, e só a aprovação do revisor a leva para done. Se todas as execuções terminam sem que o agente mude o status, o Jiraya move a tarefa para in_review sozinho, para que ela não fique parada.
Acompanhar uma execução
Na página da tarefa, a execução em andamento aparece na conversa, com as etapas do agente e o botão Parar. A seção Log de execução lista todas as execuções da tarefa, com o status, quem a disparou, o uso de tokens e a transcrição completa.
Pela CLI:
jiraya issue runs JIRA-42--active mostra só o que está em andamento. Para ler as mensagens de uma execução, use o ID que aparece na lista:
jiraya issue run-messages 3f2a9c1e --issue JIRA-42jiraya issue usage JIRA-42 soma os tokens de todas as execuções da tarefa. Na máquina do runtime, jiraya daemon watch mostra as execuções ao vivo, com as chamadas de ferramenta.
Cancelar e repetir
- Cancelar: o botão Parar na execução em andamento, ou Cancelar execução no log. Pela CLI,
jiraya issue cancel-task <id-da-execução>. O daemon interrompe a ferramenta de IA, o que pode levar alguns segundos. - Repetir: Repetir execução no log cria uma nova execução. Pela CLI,
jiraya issue rerun JIRA-42cria uma execução nova para o agente responsável pela tarefa.
Editar um comentário que disparou uma execução conta como um gatilho novo: as execuções daquele comentário ainda em andamento são canceladas e os agentes mencionados no texto novo recebem outra execução.
Novas tentativas automáticas
Quando a falha vem da infraestrutura, e não do trabalho do agente, o Jiraya tenta de novo sozinho, uma vez por padrão. As novas tentativas aparecem no log marcadas como Repetição.
| Motivo | Como a nova tentativa acontece |
|---|---|
| Runtime desconectado | Fica adiada e começa quando o daemon volta a se conectar. |
| Tempo esgotado ou agente sem atividade | Imediatamente. |
| Conexão com o provedor de IA caiu no meio da resposta | Até duas novas tentativas, a última depois de alguns segundos, continuando a mesma sessão. |
| Skills do agente não puderam ser baixadas | Imediatamente, aproveitando o que já foi baixado. |
Erros de autenticação no provedor, cota esgotada, modelo inexistente, contexto estourado e ferramenta de IA ausente não são repetidos: são problemas que precisam de uma ação sua. Veja Solução de problemas.
Sessão e diretório entre execuções
Cada tarefa tem um diretório de trabalho na máquina do runtime. Uma nova execução na mesma tarefa reaproveita esse diretório e, nas ferramentas de IA que permitem, retoma a sessão anterior do agente, com o que ele já leu e fez. Alguns minutos depois que a tarefa é concluída ou cancelada, o daemon apaga o diretório, a menos que haja alterações não enviadas. Veja a limpeza em Daemon e runtimes.
Atualizado em