# Automações

URL: https://agentvera.dev/pt/features/automations/ · Plano: Pro e Team

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.

**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. Abra a aba Details → Automation → Automations do projeto.
2. Escolha uma regra pronta ou crie uma nova.
3. Escolha o evento, o playbook, o agente e a opção On delivery.
4. Defina o limite diário de execuções e salve; acompanhe os resultados em Runs.

- **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.

---

**Sobre o AgentVera.** AgentVera é um app desktop para macOS, Windows e Linux, desenvolvido pela Solviera Teknoloji. Ele roda 18 agentes de programação com IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) lado a lado, por projeto, em terminais reais com as instalações e logins de CLI do próprio usuário. O plano gratuito tem agentes ilimitados. Baixar: https://agentvera.dev/pt/download/ · Preços: https://agentvera.dev/pt/pricing/