Colocar agentes para trabalhar
Conheça as formas de iniciar o trabalho de um agente no Jiraya, o que impede uma execução de começar e como acompanhar e parar o agente.
Um agente só trabalha quando alguém pede. Cada pedido vira uma execução: o agente roda no runtime ao qual está vinculado, lê a tarefa e os comentários, trabalha e publica o resultado na tarefa.
Formas de acionar um agente
| Como | Quando a execução começa |
|---|---|
| Atribuir a tarefa ao agente ou a uma equipe | Ao salvar o responsável, se a tarefa não estiver em backlog. |
Tirar do backlog uma tarefa já atribuída | Ao mudar o status para qualquer status ativo, como todo ou in_progress. |
| Mencionar o agente num comentário | Ao enviar o comentário, em qualquer status. |
| Comentar numa tarefa atribuída ao agente | Ao enviar o comentário, em qualquer status, inclusive depois de concluída. |
| Responder a um comentário do agente | Ao enviar a resposta. |
| Usar uma ação rápida | Ao clicar na ação, que publica um comentário com a menção. |
| Conversar no chat | A cada mensagem enviada. |
| Um autopilot | Na programação, por webhook ou em Executar agora. |
Dica
Antes de enviar um comentário, a caixa de texto mostra quais agentes Será iniciado ao enviar. Clique no nome de um agente para ignorá-lo só desta vez.
O que impede uma execução
- Tarefa em
backlog: o backlog é o lugar para preparar trabalho. Atribuir uma tarefa embacklognão inicia nada; a execução começa quando a tarefa sai do backlog. Comentários e menções funcionam normalmente. - Agente sem runtime ou arquivado: o agente precisa estar vinculado a um runtime. Sem runtime, a interface pede Vincule um ambiente antes de atribuir trabalho a este agente.
- Sem permissão: só aciona um agente quem tem acesso a ele. Um agente privado só roda para quem o criou. Veja Atribuir issues a agentes.
- Comentário de nota: um comentário que começa com
/notenão aciona ninguém. No editor, digite/e escolha Adicionar uma nota.
Quando um destino mencionado não pode ser iniciado, o comentário é publicado mesmo assim e o Jiraya avisa o motivo, como Ambiente desconectado ou Precisa de um ambiente.
Runtime desconectado
Se o runtime do agente estiver desligado, a execução fica na fila e começa quando a máquina voltar. Nada se perde. A interface mostra Desconectado agora — inicia assim que ficar conectado.
Para ligar o runtime de novo, inicie o daemon na máquina:
jiraya daemon startPedidos seguidos não duplicam o trabalho
Cada agente tem no máximo uma execução pendente por tarefa. Se você comentar de novo enquanto o agente ainda está na fila, o novo comentário entra na mesma execução, e o agente lê todos quando começar. A ação rápida avisa isso com Adicionado à execução atual.
O projeto também pode limitar quantos agentes trabalham ao mesmo tempo. Acima do limite, a execução espera a vez e a tarefa mostra a posição na fila, como está na fila · #2.
Acompanhar o trabalho
Enquanto o agente trabalha, a tarefa mostra está trabalhando, com o número de ferramentas usadas até agora.
- Ver transcrição abre o passo a passo da execução: o que o agente leu, as ferramentas que usou e as respostas.
- Log de execução, no detalhe da tarefa, lista as execuções anteriores com a origem de cada uma, como Execução inicial, Gatilho de comentário ou Execução de automação.
- A caixa de entrada avisa quando uma execução falha numa tarefa que você acompanha.
Para acompanhar pelo terminal da máquina do runtime:
jiraya daemon logs -fParar uma execução
Clique em Parar ao lado de está trabalhando. O agente para em alguns segundos, e o que ele já publicou continua na tarefa. Para retomar, comente de novo ou mencione o agente.
Trocar ou remover o responsável não interrompe uma execução em andamento. Use Parar quando quiser que o agente pare na hora.
Atualizado em