Agentes de Segurança

Os Agentes de Segurança verificam seu código em busca de bugs de segurança, padrões de risco e vulnerabilidades.

Configure os Agentes de Segurança em Automações.

Como funciona

Os Agentes de Segurança incluem dois tipos de agentes gerenciados pelo Cursor:

• Revisor de Segurança verifica pull requests antes do merge. Use-o para detectar vulnerabilidades durante a revisão de código.
• Scanner de Vulnerabilidades examina sua base de código em repouso. Use-o para encontrar vulnerabilidades preexistentes, issues antigas e problemas não detectados durante a revisão de PR.

Ambos os tipos de agentes são executados na plataforma de Automações e exigem agentes na nuvem.

Configuração

Abra Agentes de Segurança em Automações para configurar um agente.

Gatilhos

Agentes Revisores de Segurança oferecem suporte a gatilhos de Automações baseados em Git, incluindo eventos de pull request e merge request. Use esses gatilhos para executar verificações de segurança quando houver alterações no código.

Agentes do Scanner de Vulnerabilidades oferecem suporte a gatilhos baseados em cron. Use esses gatilhos para analisar sua base de código periodicamente, independentemente da atividade de pull requests.

Verificações de segurança

Ambos os tipos de agente incluem verificações de segurança integradas. Ative ou desative verificações individuais conforme o que você deseja que cada agente revise.

Instruções personalizadas

Use instruções personalizadas para fornecer mais contexto a cada agente. Você pode descrever os tipos de issues a serem priorizadas, explicar requisitos de segurança específicos do projeto ou definir como o agente deve se comportar.

Ferramentas e MCPs

Ambos os tipos de agente são compatíveis com ferramentas e MCPs. Cada agente precisa de pelo menos uma ferramenta ou MCP para ser executado.

Use ferramentas e MCPs para conectar os Agentes de Segurança aos sistemas em que sua equipe acompanha o trabalho de segurança.

• Envie vulnerabilidades para um canal do Slack, rastreador de issues ou outro sistema conectado.
• Adicione instruções personalizadas que expliquem quando e como o agente deve usar cada MCP.
• Forneça ao agente contexto adicional de ferramentas ou MCPs antes de relatar uma descoberta.

Configuração do ambiente

Os Agentes de Segurança são executados em agentes na nuvem.

Você pode usar a nuvem do Cursor sem nenhuma configuração adicional.

Execute no seu agente

Use as skills /review-security ou /review para executar o Agente de Segurança no seu agente antes de fazer push do código.

Qual diff é revisado: Por padrão, /review-security revisa as alterações da sua branch: todas as alterações em relação à branch base, incluindo alterações commitadas e não commitadas. Peça para revisar apenas as alterações não commitadas se quiser feedback mais específico.

Em relação a qual branch: /review-security compara com sua branch base padrão. Quando sua branch base não for a padrão (como main), informe ao agente qual branch deve ser usada na comparação ou deixe que ele infira pelo contexto.

Faturamento

Os Agentes de Segurança são cobrados no nível de uso da equipe:

• O uso é cobrado do pool de uso da equipe.
• Os agentes são executados em uma conta de serviço compartilhada da equipe e não afetam o uso de nenhum usuário individual.

Análises

Os Agentes de Segurança acompanham três métricas principais nas execuções dos agentes:

• Vulnerabilidades encontradas: o número de descobertas de segurança relatadas pelos agentes.
• Issues corrigidas: o número de descobertas resolvidas após serem relatadas.
• Taxa de resolução: a porcentagem de descobertas relatadas que foram corrigidas.

Para determinar se uma issue foi corrigida, o Cursor usa LLMs para analisar diffs incrementais e avaliar se a issue sinalizada foi resolvida.

Visualizar execuções

Cada execução de agente é registrada em Automações. Use o histórico de execuções para ver quando um agente foi executado, quais ferramentas ele usou, seu status final e quanto tempo levou.

Abra uma execução para inspecionar o Cloud Agent correspondente e ver mais detalhes sobre o que o agente fez.