Rascunho de issue com IA
Descreva o que precisa em uma linha, refine a prévia da tarefa conversando com um agente e confirme só quando ela estiver do jeito certo.
Em vez de preencher todos os campos de uma tarefa, você pode descrever o que precisa e deixar um agente escrever o rascunho. O agente monta uma prévia com título, descrição e campos; você conversa com ele para ajustar e só então cria a tarefa. Nada é criado antes da sua confirmação.
Criar com agente
Troque o modo de criação
Abra o diálogo de nova tarefa e use Mudar para Agente. O diálogo passa a mostrar Criar com agente.
Escolha o agente e descreva o pedido
Escolha um agente ou squad e escreva o pedido, por exemplo: "deixe a Ana corrigir a lentidão no carregamento da caixa de entrada no projeto Web". Se quiser, já defina projeto, prioridade, data de vencimento e anexos.
Gere a prévia
Clique em Gerar prévia. O app abre a página do rascunho, e o agente começa a escrever.
Nota
O agente escolhido precisa estar num ambiente de execução com uma versão recente da CLI jiraya. Se a versão for antiga, o diálogo avisa e o botão fica desabilitado até o ambiente ser atualizado.
A página do rascunho
A página tem duas áreas lado a lado: a Prévia da tarefa e o Chat com o agente. Em telas estreitas, elas viram duas abas.
- Prévia: mostra a tarefa como ela vai ficar, com o selo "Prévia · ainda não criada". Os campos que o agente mudou ficam marcados como Alterado pelo agente, e um resumo Prévia atualizada lista o que mudou a cada resposta.
- Chat: peça ao agente para mudar qualquer coisa: reescrever a descrição, trocar o responsável, dividir em critérios de aceite.
Você também pode editar a prévia diretamente: título, descrição e campos. Enquanto o agente está trabalhando, a prévia fica bloqueada para edição, e o app mostra Agente atualizando....
O responsável inicial é o agente ou squad escolhido, e o status inicial é backlog. Quando o agente não define um revisor, a prévia usa você, como na criação manual. Veja Revisão de entregas.
Perguntas do agente
Quando falta informação, o agente pergunta em vez de adivinhar. As perguntas aparecem juntas num painel, com o aviso "O agente tem 2 perguntas" e opções de resposta para cada uma.
- Escolha uma opção ou use Outra resposta… para escrever a sua.
- Use Pular numa pergunta que você não quer responder agora.
- Clique em Enviar respostas quando tiver respondido ao menos uma. O agente incorpora as respostas na prévia.
Você também pode responder escrevendo no chat.
Confirmar ou descartar
- Confirmar e criar tarefa cria a tarefa exatamente como está na prévia. O botão espera o agente terminar a resposta em andamento.
- Descartar apaga a prévia e a conversa. Nenhuma tarefa é criada.
Sair da página antes de confirmar também descarta o rascunho, depois de uma confirmação. A conversa não pode ser recuperada.
Se a prévia mudar enquanto você confirma, por exemplo porque o agente acabou de editá-la, o app pede para revisar de novo. Se já existir uma tarefa ativa com o mesmo título, a criação é recusada e o app indica qual é a tarefa existente.
Criar sub-tarefa a partir de um comentário
Quando você cria uma sub-tarefa a partir de um comentário com um agente, não há prévia: o agente recebe o comentário como contexto e cria a tarefa direto. Você recebe um aviso na caixa de entrada quando ela estiver pronta.
Como o agente edita o rascunho
O agente edita o rascunho pela CLI, dentro da execução. Esses comandos só funcionam na conversa de um rascunho:
| Comando | O que faz |
|---|---|
jiraya issue draft get | Mostra a revisão atual do rascunho, os campos e a validação do servidor. |
jiraya issue draft update | Grava uma nova revisão. Aceita título, descrição, prioridade, responsável, projeto, tarefa-mãe, etiquetas, data, status e anexos. |
Se um campo for inválido, nada é salvo e o comando lista os campos com problema. Se você editou a prévia depois que o agente a leu, o comando falha e o agente precisa ler de novo antes de reaplicar a mudança, para não sobrescrever a sua edição.
Na descrição do rascunho, o agente pode usar a marcação do Jiraya, inclusive o elemento de pergunta, que só aparece aqui.
Atualizado em