> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Devin Oncall

> Configure o Devin Oncall para investigar, corrigir e mitigar alertas, bugs e incidentes, e agir com base em percepções do seu plantão.

O Devin Oncall investiga, corrige e mitiga seus alertas, bugs e incidentes, além de oferecer percepções acionáveis sobre o seu plantão. O Devin entra em ação assim que um alerta, relatório de bug ou incidente é disparado e usa sua telemetria, seu código, suas implantações, seus runbooks e incidentes anteriores para encontrar a causa raiz, corrigir o problema e abrir um PR com a correção.

O Oncall é composto por três produtos:

* **[Responders](#responders)**: investigam e corrigem alertas, relatos de bug e dúvidas de suporte à medida que chegam.
* **[Incidents](#incidents)**: encontram a causa raiz, mitigam e conduzem cada incidente até a resolução.
* **[Reports](#reports)**: trazem percepções acionáveis sobre o que está gerando seus alertas, bugs e incidentes, como limites de alerta que precisam de ajuste e classes recorrentes de problemas a corrigir.

<h2 id="setup">
  Configuração
</h2>

O Oncall exige uma configuração one-time por organização. Durante a configuração, o Devin aprende sobre seus sistemas com base nas suas ferramentas de telemetria e no seu código, e cria habilidades que todas as sessões do Oncall utilizam.

1. Abra **Oncall** na barra lateral e clique em **Begin setup**.
2. Conecte pelo menos uma ferramenta de telemetria. Você pode pular esta etapa se já houver uma ferramenta de telemetria disponível no Ambiente do Devin.
3. Clique em **Finish**. O Devin começa a aprender sobre seus sistemas, o que geralmente leva de 1 a 2 horas. Você será notificado quando o Oncall estiver pronto.

Responders, Incidents e Reports ficam disponíveis assim que a configuração for concluída.

<Note>A configuração exige permissão para gerenciar o Oncall. Somente administradores da organização podem conectar ferramentas para toda a organização.</Note>

<h3 id="oncall-settings">
  Configurações do Oncall
</h3>

O ícone de engrenagem no cabeçalho do Oncall abre as configurações compartilhadas por todas as sessões do Oncall:

* **Instruções**: orientações, escritas em markdown, que todas as sessões do Oncall seguem. Pense nelas como um `AGENTS.md` exclusivo do Oncall.
* **Habilidades**: as habilidades sobre seus sistemas que o Devin gerou durante a configuração. Defina **Skill update frequency** como **Weekly** ou **Monthly** para mantê-las atualizadas ou clique em **Update skills now**.

<h2 id="responders">
  Responders
</h2>

Um responder monitora uma fonte de alertas ou relatos e aciona o Devin para investigar cada novo evento. O Devin agrupa eventos repetidos em um único problema, de modo que um alerta ruidoso seja investigado apenas uma vez.

Use responders para:

* Alertas de produção publicados pelas suas ferramentas de monitoramento em um canal do Slack ou do Microsoft Teams.
* Incidentes do PagerDuty, nos quais o Devin publica sua investigação como notas do incidente.
* Relatos de bugs e dúvidas de suporte em um canal como `#eng-bugs`.

<h3 id="create-a-responder">
  Criar um responder
</h3>

1. Na página **Oncall**, clique em **Create responder**.
2. Insira um **Name** e escolha o **Responder type**. O tipo não pode ser alterado depois da criação.
3. Adicione um ou mais **Triggers**.
4. Se quiser, ajuste as configurações da sessão, os conectores e o runbook.
5. Clique em **Create responder**.

<Note>O runbook é opcional. O Devin Oncall já sabe investigar alertas e bugs, então adicione um apenas para etapas específicas da sua equipe.</Note>

<h3 id="responder-types">
  Tipos de responder
</h3>

Alertas e relatos de bug exigem tratamentos diferentes, por isso cada tipo de responder executa um fluxo próprio. O tipo também define como os problemas do responder são acompanhados no painel dele.

| Tipo | Use para | Foco do Devin |
| - | - | - |
| **Alertas** | Alertas sobre problemas em produção | Avaliar rapidamente o impacto e a severidade e, em seguida, encontrar a causa raiz e uma forma de mitigação |
| **Suporte + Bugs** | Relatos de bug e dúvidas de suporte | Reproduzir o problema, encontrar a causa raiz e corrigi-lo no código |

<h3 id="triggers">
  Gatilhos
</h3>

Um responder monitora uma integração por vez e pode ter até 10 gatilhos. O Devin responde quando qualquer um deles for atendido.

| Origem | Gatilhos |
| - | - |
| **[Slack](/pt-BR/integrations/slack)** | Uma mensagem em um canal ou uma menção a um grupo de usuários (por exemplo, `@oncall`) |
| **[Microsoft Teams](/pt-BR/integrations/microsoft-teams)** | Uma mensagem em um canal |
| **[PagerDuty](/pt-BR/integrations/pagerduty)** | Incidente acionado, reconhecido, resolvido ou atualizado |

Adicione condições a um gatilho para restringir os eventos aos quais o Devin responde.

<h3 id="responder-settings">
  Configurações do responder
</h3>

| Configuração | O que faz |
| - | - |
| **Modo Agent** | O modo do agente das sessões iniciadas por este responder |
| **Executar como** | A identidade com a qual as sessões são executadas |
| **Connectors** | Os conectores MCP que este responder pode usar |
| **Runbook** | Opcional. O Devin Oncall já sabe investigar alertas e bugs. Adicione orientações específicas da sua equipe, como a forma de atribuir prioridade ou onde registrar problemas |
| **Limites** | Limites de ACU e de invocações, como nas [automações](/pt-BR/product-guides/automations#limits-and-safeguards) |
| **Avançado** | Network policy e pares chave-valor de metadados usados para organizar os responders e associá-los a relatórios |

<h2 id="incidents">
  Incidentes
</h2>

O Incidents foi desenvolvido para equipes que criam um novo canal do Slack para cada incidente. O Devin entra no canal, identifica a provável causa raiz, recomenda medidas de mitigação e continua investigando conforme o incidente evolui. Ele publica atualizações, responde a perguntas em threads e mantém um relatório do incidente.

<h3 id="enable-incidents">
  Ativar incidentes
</h3>

1. Na página **Oncall**, abra a aba **Incidents** e clique em **Enable incidents**.
2. Ative a opção **Enable incidents**.
3. Defina o **Slack channel prefix** usado pelos seus canais de incidente, por exemplo, `incident-`.
4. Escolha um **Response mode** e salve.

O Devin inicia uma investigação ao entrar em um canal do Slack cujo nome começa com o prefixo. Convide o Devin para o canal ou ative a opção **Auto-join incident channels**.

<Note>Para usar incidentes, o [Slack](/pt-BR/integrations/slack) precisa estar conectado à sua organização. Em uma empresa, apenas uma organização por vez pode ter os incidentes ativados.</Note>

<h3 id="response-modes">
  Modos de resposta
</h3>

| Modo | Comportamento |
| - | - |
| **Proactive** | O Devin publica uma provável causa raiz e, depois, continua investigando, publica atualizações e mantém um relatório do incidente |
| **One-shot RCA** | O Devin publica uma provável causa raiz com um nível de confiança e, em seguida, encerra. Nos incidentes em que você clicar em **Start proactive mode**, ele continua investigando como um colega de equipe dedicado ao incidente |

<h3 id="incident-settings">
  Configurações de incidentes
</h3>

| Configuração | O que faz |
| - | - |
| **Entrar automaticamente em canais de incidente** | Adiciona o Devin a novos canais que correspondam ao prefixo. A entrada automática só funciona em canais públicos |
| **Permitir a participação de usuários de fora da organização** | Permite que pessoas de outras organizações da mesma conta interajam com o Devin nos canais de incidente |
| **Modo do agente** | O modo da sessão principal do incidente, que é executada durante todo o incidente: ela publica atualizações e mantém o relatório do incidente |
| **Modo da investigação inicial** | O modo da primeira investigação, que identifica a provável causa raiz quando o incidente começa |
| **Modo das sessões em threads** | O modo das sessões que respondem a perguntas e requisições nas threads do canal |
| **Executar como** | A identidade usada para executar as sessões de incidente |
| **Conectores** | Os conectores MCP que as sessões de incidente podem usar |
| **Runbook** | Opcional. Instruções fornecidas a todas as sessões de incidente |

A aba **Incidentes** lista cada incidente com um link para a respectiva sessão. Use **Stop** para encerrar a participação do Devin em um incidente e **Resume** para retomá-la.

<h2 id="reports">
  Relatórios
</h2>

Um relatório traz, de forma recorrente, percepções acionáveis sobre o seu plantão: limites de alerta que precisam de ajuste, classes de problemas recorrentes a corrigir e o que está gerando seus alertas, bugs e incidentes.

Cada relatório também resume os problemas identificados e corrigidos, os incidentes investigados e os PRs que o Devin abriu e cujo merge ele fez.

Use relatórios na transferência semanal de plantão ou defina o escopo de um relatório para a sua equipe, como Faturamento ou Infraestrutura.

<h3 id="create-a-report">
  Criar um relatório
</h3>

1. Na página **Oncall**, abra a aba **Reports** e clique em **Create report**.
2. Insira um **Name**.
3. Em **Responders match**, escolha quais responders o relatório abrange, selecionando responders individualmente ou por metadados.
4. Em **Incidents match**, descreva quais incidentes devem entrar no relatório. Deixe em branco para não incluir incidentes.
5. Defina o **Schedule** e, opcionalmente, adicione **Instructions** descrevendo o que o relatório deve conter.
6. Em **Notifications**, escolha o canal do Slack ou do Microsoft Teams em que o relatório será publicado.
7. Clique em **Create report**.

Como os relatórios são compartilhados, eles são executados como um usuário de serviço, e não em nome de uma pessoa específica. Abra um relatório para ver as execuções anteriores ou clique em **Generate report** para executá-lo agora.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.