Roteamento e aprovação de PR

O Roteamento e aprovação de PR encaminha pull requests aos revisores adequados e pode aprovar alterações de baixo risco.

Configure o Roteamento e aprovação de PR em Automações.

Como funciona

O Roteamento e aprovação de PR atua nas suas pull requests. Ele atribui revisores com base na responsabilidade pelo código e no histórico de commits, além de poder aprovar PRs de baixo risco quando seus critérios são atendidos.

Ele não substitui uma revisão completa de código. Usa a avaliação de risco, arquivos de política de aprovação, resultados do agente de revisão por IA e sua configuração para decidir se deve encaminhar ou aprovar.

Recursos principais

Atribuição de revisores

O Roteamento e aprovação de PR pode atribuir revisores a pull requests com base na responsabilidade pelo código e no histórico de commits.

Use a atribuição de revisores para definir quando o agente deve solicitar revisores. O agente também considera os arquivos de política aplicáveis, as configurações de risco, as descobertas do revisor de IA e o estado atual da revisão.

Aprovação baseada em risco

O Roteamento e aprovação de PR pode aprovar pull requests de baixo risco quando os critérios de aprovação são atendidos.

Use critérios de aprovação para definir as condições que um PR deve atender antes de ser aprovado pelo agente. O agente também considera os arquivos de política aplicáveis, as configurações de risco, as conclusões do revisor de IA e o estado atual da revisão.

Funcionalidades principais

Reconhecimento de revisores de IA

O Roteamento e aprovação de PR pode usar resultados de outros sistemas de revisão do Cursor:

• Contexto da revisão do Bugbot usa os resultados do Bugbot na decisão de aprovação.
• Contexto da revisão de segurança usa os resultados do Agente de Segurança na decisão de aprovação.

Quando esses contextos estão habilitados, o agente aguarda a conclusão das verificações relevantes dos revisores baseados em agentes e usa seus resultados como sinais de aprovação.

Se o Bugbot ou os Agentes de Segurança relatarem problemas que exijam revisão humana, o Roteamento e aprovação de PR não aprovará o PR.

Classificação de risco

O Roteamento e aprovação de PR pode classificar um PR por nível de risco e impor um limite máximo para aprovação.

• Usar pontuação de risco ativa a classificação de risco, que pode ser personalizada com prompts.
• Limite máximo de risco define o nível de risco máximo que o agente pode aprovar.

Se um PR exceder o limite configurado, o agente não o aprovará.

Arquivos de política de aprovação

O Roteamento e aprovação de PR pode detectar arquivos de política no repositório e aplicá-los antes de decidir se aprova o PR.

Para cada arquivo alterado, o agente verifica o diretório do arquivo e todos os diretórios pai em busca deste nome de arquivo exato:

APPROVAL_POLICY.md

Apenas correspondências exatas do nome de arquivo são confiáveis. Arquivos como POLICY.md, approval_policy.md, APPROVAL_POLICY.md.bak e team_APPROVAL_POLICY.md são ignorados durante a descoberta de políticas de diretório.

O APPROVAL_POLICY.md aplicável mais próximo tem prioridade máxima para os arquivos desse diretório. As políticas dos diretórios ancestrais continuam sendo aplicáveis, a menos que entrem em conflito com uma política mais específica.

Políticas de roteamento

O Roteamento e aprovação de PR também verifica se há um arquivo de roteamento na raiz:

.cursor/approval-policies/ROUTING.md

ROUTING.md é uma lista YAML de entradas de produtos. Cada entrada contém:

• product: o nome do produto ou da área.
• boundary: um limite semântico, um caminho explícito relativo ao repositório ou um glob.
• policies: referências a prompts de política, sejam caminhos de arquivo explícitos ou descrições semânticas.

Se ROUTING.md não existir, a descoberta de APPROVAL_POLICY.md baseada em diretórios ainda será executada. A ausência de roteamento não enfraquece a descoberta de políticas.

Precedência de políticas

Os prompts de política de aprovação aplicáveis substituem critérios genéricos de aprovação, limites de risco, orientações para seleção de revisores, instruções de aprovação personalizadas e a configuração padrão de revisão automatizada.

Em caso de conflito entre políticas, o agente segue a política mais específica. Se não estiver claro qual é a mais específica, ele segue a instrução mais rigorosa e evita a aprovação automática.

Se um PR alterar uma política de aprovação, um arquivo de roteamento, um arquivo de política roteada ou um arquivo de política específico para revisores, o agente não usa o conteúdo alterado para flexibilizar os requisitos de revisão desse mesmo PR. Ele usa a versão da branch base, quando disponível, ou exige revisão humana quando não for possível determinar a versão base.

Configuração

Abra o Roteamento e aprovação de PR em Automações para configurar o recurso.

Ativar roteamento e aprovação

Ative os recursos que desejar:

• Ativar roteamento de PRs e solicitações de revisão atribui revisores com base na responsabilidade pelo código e no histórico de commits.
• Aprovar PRs automaticamente aprova PRs de baixo risco após você configurar os critérios de aprovação.

Escolha as organizações e os repositórios nos quais o agente deve ser executado.

Configurar gatilhos

Os gatilhos determinam quando o agente é executado. Roteamento e aprovação de PR oferece suporte a eventos de pull request, como:

• PR aberta executa o agente quando uma pull request é criada.
• PR com push / atualizada executa o agente quando novos commits recebem push em uma PR existente.
• PR comentada executa o agente quando um comentário que corresponde a uma expressão regular é publicado em uma PR existente.

Os gatilhos podem ser definidos para repositórios ou organizações. Para repositórios pertencentes à equipe, admins da equipe podem configurar escopos mais amplos.

Configure os sinais de revisão

Em Configuração, escolha quais sinais o agente deve usar:

• Usar o Contexto da revisão do Bugbot
• Usar o Contexto da revisão de segurança
• Usar a Pontuação de risco
• Risco máximo para aprovação

Use esses sinais para decidir se o agente deve considerar a saída do revisor de IA, as descobertas de segurança e os limites de risco antes de aprovar.

Personalizar regras de aprovação

Use o Prompt Personalizado para adicionar critérios de aprovação à sua equipe. Você pode descrever expectativas locais de revisão, exemplos de PRs que podem ser aprovados com segurança ou casos que exigem revisão humana.

Os arquivos de política ainda têm precedência sobre o prompt personalizado para os arquivos aos quais se aplicam.

Se o prompt personalizado não estiver definido, o agente usará os critérios padrão gerenciados pelo Cursor.

Configurar ferramentas e MCPs

O agente precisa ter pelo menos uma ação principal habilitada:

• Solicitar revisores
• Aprovar PR

As integrações opcionais podem incluir:

• Notificações do Slack.
• Notificações do Microsoft Teams.
• Servidores MCP para acessar ferramentas adicionais.

Use o prompt personalizado para orientar o uso de ferramentas MCP pelo agente.

Salvar e habilitar

Após a configuração, salve o agente. Os agentes existentes podem ser habilitados ou desabilitados na página de detalhes.

Membros da equipe sem permissão de administrador podem visualizar o Roteamento e aprovação de PR, mas não podem editá-lo.