Pro

Automações: agentes que começam a trabalhar quando algo acontece

Perceber que o CI quebrou ou que um PR recebeu comentário, e depois passar isso para um agente, sempre sobra para você. As automações ligam um evento a um trabalho: quando uma regra dispara, um agente trabalha no próprio worktree seguindo um playbook e entrega o resultado do jeito que você escolheu.

Este recurso está nos planos Pro e Team. No plano gratuito ele aparece bloqueado; entre com sua conta AgentVera e faça upgrade para desbloqueá-lo. Comparar planos

Eventos

As regras ficam na aba Details → Automation → Automations do projeto; a visão Runs mostra o histórico de cada regra.

  • CI ficou vermelho: uma execução quebra no GitHub Actions, GitLab CI ou Jenkins, conforme conectado na aba CI/CD. Limite com padrões de branch como “main, release/*”.
  • Comentário em PR: só contam comentários de donos, membros e colaboradores do repositório, nunca de bots. Se um agente já está trabalhando naquele PR, os novos comentários vão para ele.
  • Issue com label: a label padrão é “ajan”. A label precisa ser aplicada por uma pessoa com permissão de escrita.
  • Agendado: uma expressão cron de 5 campos no horário local, por exemplo dias úteis às 09:00.

O trabalho e como ele é entregue

Quando uma regra dispara, um agente Claude Code ou Codex abre no próprio worktree numa branch ajan/… e segue o playbook escolhido. Uma regra também pode iniciar um flow a partir do nó Start ou preparar um plano de Parallel team que espera sua aprovação. A configuração de entrega decide para onde vai o resultado.

  • Automático: faz push de volta para a branch cujo CI quebrou ou para a branch do PR; senão, abre um PR. Nunca faz push direto na branch padrão.
  • Abrir um PR, fazer push na mesma branch, adicionar à fila de merge ou deixar na branch.
  • Enquanto o projeto não tem regras, quatro prontas são oferecidas: corrigir o CI quando quebra, tratar comentários em PRs, fazer as issues com label “ajan”, atualizar dependências às segundas.

Playbooks

Um playbook é a instrução que diz ao agente como fazer o trabalho. Seis vêm prontos: corrigir um bug, corrigir uma falha de CI, tratar comentários de PR, construir uma feature a partir de uma issue, atualizar dependências (só minor e patch) e aumentar a cobertura de testes. Salve seus próprios playbooks neste computador ou no repositório como arquivos .agentvera/playbooks/*.md, que chegam à sua equipe pelo git.

Limites de segurança

Como as automações rodam sozinhas, os limites são definidos de antemão.

  • Cada regra roda no máximo de 1 a 50 vezes numa janela móvel de 24 horas; 5 por padrão.
  • No máximo 2 correções automáticas por branch por dia, e só uma de cada vez.
  • O GitHub é consultado a cada 2 minutos; execuções de CI e PRs vindos de forks são ignorados.
  • O texto de comentários e issues chega ao agente marcado como texto externo não confiável que apenas descreve o trabalho.
  • Antes de um push, os commits são verificados em busca de arquivos .env, chaves, .npmrc e credenciais; se algum for encontrado, nada é enviado.

Configure sua primeira regra

  1. 1

    Abra a aba Details → Automation → Automations do projeto.

  2. 2

    Escolha uma regra pronta ou crie uma nova.

  3. 3

    Escolha o evento, o playbook, o agente e a opção On delivery.

  4. 4

    Defina o limite diário de execuções e salve; acompanhe os resultados em Runs.

Perguntas

Quais agentes executam os trabalhos?

Claude Code ou Codex; Claude Code por padrão.

Do que comentários em PR e issues precisam?

O origin do repositório precisa estar no GitHub e você precisa estar logado no GitHub neste computador. O evento de CI funciona com todos os provedores da aba CI/CD.

Um agente vai fazer push na minha branch padrão?

Não. Mesmo com push na mesma branch selecionado, a branch padrão recebe um PR em vez disso, e o modo Automático nunca faz push direto nela.

Um comentário em PR pode enganar o agente?

Só comentários de donos, membros e colaboradores são tratados, e o texto chega ao agente marcado como não confiável. Os commits também são verificados em busca de arquivos secretos antes de um push.

Recursos relacionados

Todos os recursosVeja os 18 agentes de código suportados

Reúna seus agentes em uma só mesa.

Comece no plano gratuito. Baixe, adicione a pasta de um projeto e abra seu primeiro agente.