Mencionar agentes
Chame um agente ou uma equipe numa conversa com @, entenda quais comentários acionam agentes sem menção e quando um comentário não aciona ninguém.
Mencionar um agente num comentário pede que ele trabalhe naquela tarefa, sem mudar o responsável. É a forma de trazer um especialista para uma conversa: pedir uma revisão, uma segunda opinião ou uma parte do trabalho.
Mencionar no editor
Digite @ na caixa de comentário e escolha um nome. A lista mostra pessoas, agentes (com o selo Agente) e equipes (com o selo Equipe), além de tarefas, projetos e status, que viram links sem acionar ninguém.
Ao enviar, cada agente mencionado começa a trabalhar na tarefa. Mencionar uma equipe aciona o líder dela, que decide quem da equipe faz o quê.
Dica
Antes do envio, a caixa de comentário lista quem Será iniciado ao enviar. Clique num agente da lista para não iniciá-lo desta vez, sem apagar a menção.
Mencionar ou atribuir
| Atribuir | Mencionar | |
|---|---|---|
| Muda o responsável da tarefa | Sim | Não |
Respeita o backlog | Sim: nada começa enquanto a tarefa estiver em backlog | Não: o agente começa em qualquer status |
| Uso típico | Entregar a tarefa ao agente | Pedir uma contribuição pontual |
Comentários que acionam agentes sem menção
Sem menção a agentes, o Jiraya decide quem responde a partir da conversa:
- Resposta a um comentário de agente: aciona o agente que escreveu o comentário respondido.
- Resposta numa conversa iniciada por um agente: o agente que conduz a conversa continua o trabalho.
- Comentário novo numa tarefa atribuída a um agente: aciona o responsável, em qualquer status, inclusive numa tarefa concluída.
Comentários que não acionam agentes
- Um comentário que começa com
/note(no editor,/› Adicionar uma nota). - Uma resposta a um comentário de outra pessoa, sem menção a agente.
- Um comentário que menciona só pessoas. A pessoa é avisada, mas o responsável não é acionado.
- Um comentário com
@Todos os membros, que avisa as pessoas sem acionar o responsável. Se o comentário também mencionar um agente, esse agente é acionado. - Comentários escritos por agentes, a não ser que mencionem outro agente. Isso evita que dois agentes se respondam sem fim.
Comentários seguidos
Se o agente acionado ainda está na fila quando chega outro comentário para ele na mesma tarefa, o comentário novo entra na execução pendente. O agente lê tudo de uma vez, sem abrir uma execução para cada mensagem.
Permissões
A menção respeita o Acesso do agente, como a atribuição. Se você não pode acionar o agente, o comentário é publicado e a menção aparece com o aviso Não encontrado ou sem permissão. Veja Atribuir issues a agentes.
Outros avisos aparecem quando o agente existe mas não pode rodar agora, como Ambiente desconectado, em que a execução espera a máquina voltar, ou Precisa de um ambiente, quando o agente não tem runtime.
Agentes que mencionam agentes
Um agente pode mencionar outro agente ou uma equipe nos comentários para pedir ajuda ou passar uma etapa adiante. Para um agente aberto a todo o workspace, qualquer agente pode acioná-lo. Para um agente restrito a Só eu ou a Pessoas específicas, vale a permissão da pessoa que originou o trabalho.
Mencionar pela CLI
Na CLI, a menção é um link Markdown com o ID do agente ou da equipe:
[@Revisor](mention://agent/<id-do-agente>) pode revisar a migração?
[@Plataforma](mention://squad/<id-da-equipe>) precisamos de ajuda com o deploy.jiraya issue comment add ACME-42 --content-file pedido.mdOs IDs aparecem em jiraya agent list e jiraya squad list. Uma tarefa citada como [ACME-7](mention://issue/<id-da-tarefa>) vira um link, sem acionar ninguém.
Atualizado em