Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

Use this file to discover all available pages before exploring further.

As automações permitem conectar eventos externos — mensagens do Slack, webhooks do GitHub, atualizações de tickets do Linear, agendamentos e webhooks personalizados — a sessões do Devin que são iniciadas automaticamente. Em vez de marcar o Devin manualmente sempre que um bug é relatado ou uma checagem de CI falha, você define o gatilho uma vez, e o Devin cuida de cada evento conforme ele chega.

​
Conceitos principais

Uma automação tem três partes:
ParteO que faz
GatilhoO evento que dispara a automação (por exemplo, uma mensagem no Slack em #bugs, uma falha de CI no GitHub, uma mudança de label no Linear)
CondiçõesFiltros opcionais que refinam o gatilho (por exemplo, disparar apenas quando a label for bug, apenas para um repo específico)
AçãoO que o Devin faz quando o gatilho é disparado — iniciar uma nova sessão, enviar uma mensagem para uma sessão existente ou atuar como monitor de triagem

​
Tipos de GitHub Action

GitHub ActionDescrição
Iniciar sessãoCria uma nova sessão do Devin com o prompt que você define. O payload do evento é incluído automaticamente como contexto.
Enviar mensagem para a sessãoEnvia uma mensagem para uma sessão existente de longa duração do Devin — útil para enviar eventos para uma sessão que mantém estado.
Triagem do DevinUm Devin persistente que monitora um canal do Slack. Ele acompanha cada mensagem recebida, decide o que precisa de atenção e cria sub-Devins para itens que exigem investigação. Consulte Triagem automática para mais detalhes.
Notificação por e-mailEnvia um e-mail para você quando a automação é executada — em todas as execuções, apenas em caso de falhas ou apenas em caso de sucesso.

​
Fontes de acionamento

FonteTipos de eventoExemplo de caso de uso
SlackNova mensagem, reação adicionadaFazer a triagem de relatos de bugs em #incidents, reagir com 🚨 para iniciar uma investigação
GitHubComentário em problema, PR aberto/atualizado, revisão de PR, execução de verificação (CI), pushCorrigir automaticamente falhas de CI, responder a comentários com /devin em problemas
LinearProblema criado, rótulo adicionado, status alterado, prioridade alterada, atribuídoFazer a triagem de bugs ao adicionar um rótulo, implementar tickets quando atribuídos ao Devin
AgendamentoRecorrente (baseado em cron)Varreduras diárias de erros no Sentry, atualizações semanais de dependências, testes de fumaça noturnos
WebhookRequisição HTTP recebidaConectar qualquer sistema externo (PagerDuty, Datadog, Sentry, ferramentas personalizadas) ao Devin por meio de uma URL de webhook
Uma automação pode ter vários gatilhos — eles funcionam como um OR, então a automação é acionada quando qualquer um deles corresponde. Por exemplo, você pode ter uma automação que é acionada tanto por uma falha de CI no GitHub quanto por uma reação no Slack.

​
Criar uma automação

​
Na página de automações

  1. Acesse automação na barra lateral
  2. Clique em New automation (ou use o campo de chat para descrever o que você quer em linguagem natural — Devin vai gerar a configuração da automação para você)
  3. Configure o gatilho, as condições e a GitHub Action
  4. Clique em Save

​
A partir de um template

  1. Navegue até automação na barra lateral
  2. Clique em Templates no canto superior direito
  3. Explore a galeria de templates — cada template é uma automação pré-configurada para um fluxo de trabalho comum
  4. Clique em um template para preencher o editor com seu gatilho, ação e limites sugeridos
  5. Personalize a configuração (por exemplo, selecione seu canal do Slack ou repositório) e salve

​
Como usar linguagem natural

Na página de automações, você pode descrever o que deseja no campo de entrada do chat, na parte inferior — por exemplo, “Quando uma verificação de CI falhar em my-org/my-repo, faça o Devin corrigir isso e enviar para a mesma branch.” Devin gerará a configuração da automação para você, que poderá revisar e salvar.

​
Configurando gatilhos

​
Gatilhos do Slack

Os gatilhos do Slack são disparados quando uma mensagem é publicada ou uma reação é adicionada em um canal para o qual Devin foi convidado.
  • Mensagem do Slack: Dispara com novas mensagens em um canal específico. Você deve selecionar o canal ao configurar o gatilho.
  • Reação do Slack: Dispara quando uma reação de emoji específica é adicionada a uma mensagem (e.g. 🚨 para incidentes). Você pode filtrar pelo nome da reação e pelo canal.
Devin precisa ser convidado para o canal do Slack para que o gatilho funcione. Você também deve ter sua conta pessoal do Slack conectada em Configurações > Integrações > Slack.

​
Gatilhos do GitHub

Os gatilhos do GitHub são acionados por eventos do repositório. Você deve selecionar um repositório específico para cada gatilho.
  • Comentário em problema: Dispara quando um comentário é publicado em um problema do GitHub. É comumente usado com a condição starts_with "/devin", para que os usuários possam digitar /devin em qualquer problema e acionar o Devin.
  • Pull request: Dispara em eventos de PR (abertura, sincronização etc.).
  • Revisão de pull request: Dispara quando uma revisão é enviada em um PR.
  • Comentário de revisão de pull request: Dispara em comentários individuais da revisão.
  • Check run (CI): Dispara quando uma verificação de CI é concluída. Filtre por conclusion = failure para corrigir automaticamente builds com falha.
  • Push: Dispara com pushes para uma branch.
As automações do GitHub funcionam apenas com repositórios privados por motivos de segurança.

​
Gatilhos do Linear

Os gatilhos do Linear são acionados por eventos de problemas no workspace conectado do Linear. Você deve selecionar uma equipe para cada gatilho.
  • Problema criado: É acionado quando um novo problema é criado na equipe selecionada.
  • Label adicionada: É acionado quando uma label é aplicada a um problema (por exemplo, bug, devin).
  • Status alterado: É acionado quando o status de um problema é alterado (por exemplo, movido para “Em andamento”).
  • Prioridade alterada: É acionado quando a prioridade de um problema é alterada.
  • Atribuído: É acionado quando um problema é atribuído a alguém.

​
Gatilhos de agendamento

Os gatilhos de agendamento são acionados de forma recorrente com regras de recorrência padrão.
  • Recorrente: Defina a frequência (a cada hora, diariamente, semanalmente) e o horário. Internamente, os agendamentos usam o formato RRULE do iCalendar.
Os horários são exibidos no seu fuso horário local, mas armazenados internamente em UTC.

​
Gatilhos de webhook

Os gatilhos de webhook permitem conectar qualquer sistema externo ao Devin por meio de um endpoint HTTPS exclusivo.
  1. Crie uma automação com um gatilho Webhook
  2. Depois de salvar, copie a URL e o segredo do webhook na página de detalhes da automação
  3. Configure seu sistema externo (PagerDuty, Datadog, Sentry ou qualquer ferramenta personalizada) para enviar requisições HTTP POST para esta URL
  4. Opcionalmente, adicione um filtro de payload — um padrão regex ao qual o corpo da requisição deve corresponder para que a automação seja acionada
O payload do webhook é incluído no prompt da sessão do Devin como contexto. Payloads com mais de 200 KB são truncados automaticamente.

​
Configurando GitHub Actions

​
Iniciar sessão

A ação mais comum. Quando o gatilho dispara, Devin inicia uma nova sessão com seu prompt. O payload do evento (por exemplo, o texto da mensagem no Slack, o corpo do webhook do GitHub ou os detalhes do ticket no Linear) é automaticamente anexado ao prompt para que Devin tenha todo o contexto. Opções:
  • Prompt: As instruções que Devin seguirá. Escreva como se fosse um prompt comum do Devin.
  • Playbook (opcional): Use @playbook-name no seu prompt para incluir um playbook com instruções adicionais.
  • Tags (opcional): Adicione tags às sessões criadas por esta automação para facilitar a filtragem.

​
Enviar mensagem para uma sessão

Envia uma mensagem para uma sessão existente de longa duração do Devin. Útil quando você quer que uma única sessão persistente processe eventos ao longo do tempo, em vez de criar uma nova sessão para cada evento. Ao configurar esta GitHub Action, você deve selecionar a sessão de destino.

​
Triagem do Devin (monitor)

Cria uma sessão persistente do Devin que monitora um canal no Slack. Consulte o guia de triagem automática para obter todos os detalhes sobre esse tipo de GitHub Action.

​
Notificação por email

Envia uma notificação por email quando a automação é executada. Escolha quando receber notificações:
  • Sempre — a cada execução
  • Em caso de falha — somente quando a sessão falhar ou ocorrer um erro
  • Em caso de sucesso — somente quando a sessão for concluída com sucesso

​
Limites e mecanismos de proteção

As automações incluem controles integrados para evitar uso excessivo:

​
Limite de ACU

Defina um orçamento máximo de ACU (Agent Compute Unit) por sessão iniciada por esta automação. Se Devin atingir esse limite, a sessão será encerrada. Isso evita que uma única invocação consuma recursos em excesso.

​
Limite de invocação

Defina um limite para quantas vezes a automação pode ser acionada em um intervalo de tempo. Por exemplo, “no máximo 10 invocações por hora” evita que um canal muito movimentado no Slack ou uma enxurrada de falhas de CI inicie dezenas de sessões. Ambos os campos são opcionais — se não forem definidos, a automação será executada sem limites.

​
Política de rede

Você pode ativar uma política de rede para restringir quais hosts externos as sessões da automação podem acessar. Isso é especialmente importante para automações que processam entradas de usuário não confiáveis (por exemplo, mensagens do Slack e payloads de webhook). Você pode adicionar domínios específicos à lista de permissões caso o Devin precise acessar serviços externos.

​
Integrações MCP

Conectar integrações MCP é altamente recomendável — elas melhoram drasticamente a qualidade das automações ao dar ao Devin acesso a dados de execução, como logs, métricas e detalhes de erros.
As automações funcionam com integrações MCP para dar ao Devin acesso a ferramentas externas. Ao criar uma automação, a seção Connections mostra quais servidores MCP são recomendados e o status de conexão deles. Por exemplo, o template “Correções Diárias de Erros no Sentry” recomenda o Sentry MCP para que o Devin possa consultar o Sentry em busca de erros não resolvidos. O template “Investigação de Alertas do Datadog” recomenda o Datadog MCP para coletar métricas e traces. Ative os servidores MCP em Configurações > MCP Marketplace antes de criar automações que precisem deles.

​
Acesso às ferramentas do Slack

Por padrão, as sessões de automação podem ler e escrever nos canais do Slack envolvidos no gatilho. Você pode conceder acesso a canais adicionais do Slack na seção Ferramentas do Slack do editor de automação. Isso é útil quando o Devin precisa ler vários canais além daquele que acionou a automação.

​
Atividade e monitoramento

Cada automação registra seu histórico de invocações. Na página de detalhes da automação, a aba Atividade mostra:
  • Invocações recentes com data e hora
  • Se cada invocação foi bem-sucedida ou ignorada
  • Links para as sessões do Devin que foram criadas
  • Mensagens de erro para invocações que falharam
A lista de automações mostra um sparkline para cada automação, oferecendo uma visão geral visual da atividade nos últimos 30 dias.

​
Ativar e desativar

Ative ou desative uma automação a qualquer momento pela lista de automações ou pela página de detalhes. Automações desativadas deixam de processar eventos, mas mantêm a configuração. Ao reativar uma automação, o processamento de eventos é retomado imediatamente.

​
Templates

O Devin inclui uma biblioteca de templates de automação prontos para uso para fluxos de trabalho comuns:
TemplateCategoriaO que faz
Triagem de relatórios de bugs no SlackMonitoramentoMonitora um canal do Slack e faz a triagem automática de relatos de bug recebidos
CI Failure FixerCI/CDCorrige automaticamente verificações de CI com falha em PRs
/devin correção de problemaCI/CDResponde a comentários /devin em problemas do GitHub
Resposta a incidentes de SREMonitoramentoInvestiga incidentes quando uma reação 🚨 é adicionada
Correções Diárias de Erros no SentryMonitoramentoColeta diariamente os principais erros do Sentry e abre PRs de correção
Investigação de Alertas do DatadogMonitoramentoInvestiga alertas do Datadog publicados no Slack
Triagem de Relatórios de BugsTriagemFaz a triagem de tickets do Linear com o rótulo bug
Triagem de Suporte ao ClienteTriagemRedige respostas para mensagens de suporte no Slack
Implementação de ticket no LinearTriagemImplementa tickets com o rótulo devin no Linear
QA noturno e testes de smokeManutençãoExecuta testes E2E todas as noites e abre tickets para regressões
Atualizações Semanais de DependênciasManutençãoFaz a varredura em busca de pacotes desatualizados e abre PRs de atualização
Weekly ChangelogManutençãoCompila PRs mesclados em um changelog categorizado
Navegue por todos os templates em automação > Templates no app do Devin.