Assistente de AppSec com IA

​

Visão Geral

​

Principais Capacidades

​

Operações de Segurança Autônomas

• Triagem de achados — avaliar status de verdadeiro/falso positivo, avaliar a severidade, recomendar prioridade de remediação
• Investigação de vulnerabilidades — clonar repositórios, revisar caminhos de código, avaliar alcançabilidade
• Criação de patches — gerar correções, criar PRs pelo pipeline de patches da plataforma
• Modelagem de ameaças — analisar a arquitetura da aplicação e identificar superfícies de ataque
• Alcançabilidade de SCA — determinar se vulnerabilidades de dependências são de fato exploráveis no seu código

​

Equipes de Agentes

​

Autoaperfeiçoamento

• Memória — armazena e recupera decisões, preferências da equipe, conhecimento específico de repositórios e resultados de investigações entre execuções. Antes de cada tarefa, busca na memória decisões anteriores sobre questões semelhantes para manter a consistência. Ao concluir o trabalho, salva os principais resultados para que execuções futuras não reinvestiguem as mesmas questões.
• Regras em linguagem natural — quando identifica um padrão recorrente (por exemplo, falsos positivos repetidos vindos de um padrão de código específico), pode criar regras de scanner para que a plataforma capture ou suprima achados semelhantes automaticamente em scans futuros. Isso significa que as decisões de triagem do assistente melhoram permanentemente a precisão do scanner.
• Contexto de tarefas recorrentes — em tarefas agendadas, o assistente recebe automaticamente os resultados das suas últimas 3 execuções. Ele usa isso para acompanhar tendências, dar continuidade ao trabalho anterior e evitar começar do zero a cada vez.

​

Automação Orientada a Eventos

• Um scan é concluído → o assistente faz a triagem dos novos achados e publica um resumo
• Um PR é bloqueado → o assistente revisa os achados bloqueantes e sugere correções
• Um novo CVE é descoberto → o assistente avalia a alcançabilidade nos seus repositórios
• Um scan falha → o assistente investiga o erro e notifica a equipe

​

Ambiente Persistente

• Diretórios de tarefas recorrentes — tarefas agendadas recebem um diretório de trabalho persistente em /data/recurring/<task-name>/. Cada execução cria um subdiretório com timestamp, e os resultados das últimas 3 execuções são fornecidos automaticamente como contexto para a execução seguinte. Isso permite que o assistente acompanhe tendências ao longo do tempo (por exemplo, “na semana passada, 12 achados críticos; nesta semana, 8”).
• Memória entre execuções — o assistente usa o mem0 para armazenar e recuperar conhecimento organizacional que persiste indefinidamente por todas as execuções.

​

Controlabilidade

• Instruções globais — diretrizes da organização adicionadas ao início de toda tarefa. Defina políticas como “sempre publique no Slack antes de modificar registros” ou “escale achados críticos para @security-oncall”. Editáveis na aba Settings ou pelo próprio assistente via ferramentas MCP.
• Gatilhos de eventos — configure quais eventos da plataforma (scan concluído, novas vulnerabilidades etc.) invocam o assistente automaticamente, com prompts personalizáveis por tipo de evento.
• Agendamento cron — o assistente pode criar e gerenciar seus próprios agendamentos recorrentes (por exemplo, “fazer a triagem de novos achados toda segunda-feira às 9h”).
• Permissões — três permissões granulares controlam quem pode visualizar, gerenciar ou executar o assistente.

​

Painel

• Overview — Estatísticas rápidas (jobs em execução, jobs concluídos hoje, agendamentos ativos, gatilhos ativos, serviços conectados), uma visão ao vivo dos jobs em execução no momento, com contadores de duração em tempo real, e um feed de ações recentes com resumos gerados por IA descrevendo as ações concretas realizadas (por exemplo, achados triados, PRs abertos, scans acionados).
• Activity — Uma lista pesquisável de todas as conversas, com títulos gerados por IA que resumem o propósito de cada conversa. Você pode filtrar por origem (Chat, Scheduled, Events, Slack) e clicar em qualquer linha para abrir a thread completa da conversa com streaming em tempo real.
• Chat — Inicie novas conversas ou continue as existentes. A visão de chat inclui uma barra lateral que lista todas as conversas, com busca, filtro por origem (All, Chat, Scheduled, Event, Slack) e indicadores de status. Conversas de tarefas agendadas e gatilhos de eventos são somente leitura, enquanto conversas vinculadas ao Slack direcionam você a responder na thread original do Slack. O assistente recebe automaticamente o histórico completo da conversa ao responder a mensagens de acompanhamento, mantendo o contexto por múltiplas trocas na mesma thread.
• Schedules — Crie e gerencie tarefas recorrentes com expressões cron, templates e escopo por repositório/tag.
• Triggers — Configure quais eventos da plataforma invocam o assistente, com prompts por gatilho e escopo por repositório/tag.
• Playbooks — Navegue e gerencie templates de playbooks reutilizáveis que definem fluxos de trabalho em várias etapas que o assistente pode executar. Playbooks oferecem uma forma estruturada de codificar operações de segurança comuns (por exemplo, runbooks de triagem, procedimentos de resposta a incidentes) para que possam ser acionadas de forma consistente por toda a equipe.
• Memory — Visualize, pesquise, edite e exclua o conhecimento organizacional armazenado pelo assistente.
• Settings — Habilite/desabilite o agente, configure o canal do Slack, defina instruções globais e reinicie o assistente.

​

Primeiros Passos

​

Habilitar o Assistente

1. Navegue até Assistant no painel do ZeroPath.
2. Vá para a aba Settings.
3. Alterne o agente para on.

​

Executar Sua Primeira Tarefa

1. Clique no botão Ask no canto superior direito, ou vá para a aba Chat.
2. Digite uma mensagem no campo na parte inferior da página para iniciar uma nova conversa, por exemplo:
   • “Liste todos os achados de severidade crítica do último scan e faça a triagem deles”
   • “Revise os resultados do último scan de PR e sinalize quaisquer verdadeiros positivos”
   • “Quais são os 5 tipos de vulnerabilidade mais comuns nos nossos repositórios?”
3. Acompanhe os resultados em streaming em tempo real. Você pode enviar mensagens de acompanhamento na mesma thread de conversa.

​

Configurar Instruções Globais

1. Vá para a aba Settings.
2. Clique em “Show example” para obter um template inicial.
3. Escreva suas instruções. Por exemplo:

## Escalation & Approval

- Before modifying or deleting any issue, post a summary in Slack
  and wait for confirmation from a team member before proceeding.
- For critical or high severity findings, escalate to @security-oncall
  in #security-alerts with finding details and your recommended action.

## Memory

- At the start of every task, search memory for prior decisions about
  similar findings. Use existing decisions as precedent.
- After completing any triage or investigation, store the key decision
  and reasoning in memory for future reference.

## Pull Requests

- Never auto-merge pull requests. Create the PR, tag the repo owner,
  and post the PR link in Slack for review.

4. Clique em “Save Instructions”.

​

Gatilhos de Eventos

​

Configurando Gatilhos

1. Vá para a aba Triggers.
2. Clique em “Add trigger” no tipo de evento desejado, ou ative um gatilho existente:

3. Clique em “Edit prompt” para personalizar o que o assistente faz para cada evento.
4. Opcionalmente, restrinja cada gatilho a repositórios ou tags específicos para que ele só dispare para um subconjunto do seu código.

​

Webhooks de Entrada

​

Criando um Webhook de Entrada

1. Vá para a aba Triggers.
2. Na seção Webhooks, clique em “Add trigger”.
3. Dê um nome ao gatilho e escreva um template de prompt. Use {webhookBody} como placeholder para o payload da requisição recebida.
4. Clique em “Save”. O ZeroPath gera uma URL de webhook exclusiva com um token secreto.

POST https://zeropath.com/api/agent/webhook/{triggerId}?secret={webhookSecret}

​

Exemplo

A new bug bounty report was submitted. Analyze the report for validity,
check if the described vulnerability exists in our codebase, and post
your assessment to Slack.

Report contents:
{webhookBody}

{
  "title": "Open redirect in /auth/callback",
  "severity": "medium",
  "description": "The redirect_uri parameter is not validated..."
}

​

Escopo

​

Modo Confiável

• Trusted (padrão) — o assistente tem capacidades completas: acesso a shell, leitura/escrita de arquivos e todas as ferramentas MCP. Use para gatilhos acionados por eventos internos da plataforma (scan concluído, novas vulnerabilidades etc.), em que o conteúdo do prompt é controlado pela sua equipe.
• Untrusted — o assistente é executado em um modo restrito, sem acesso a shell e sem capacidade de ler ou modificar arquivos de configuração sensíveis. Todas as ferramentas MCP (plataforma ZeroPath, Slack, Linear etc.) continuam funcionando normalmente. Use para gatilhos que processam entrada externa, como webhooks de entrada que carregam payloads de fora da sua organização.

​

Quando Usar o Modo Não Confiável

• Webhooks de entrada que recebem payloads de sistemas externos
• Gatilhos que processam relatórios de bug bounty, avisos de fornecedores ou dados enviados por clientes
• Qualquer gatilho em que {webhookBody} ou outros placeholders carreguem texto de autoria externa

​

O Que Muda no Modo Não Confiável

​

Variáveis de Prompt

​

Tarefas Agendadas

​

Criando Agendamentos pela Interface

1. Vá para a aba Schedules e clique em “New Schedule”.
2. Escolha um template como ponto de partida (Daily Triage, Weekly Security Digest ou SCA Monitoring), ou crie um do zero.
3. Insira um nome, selecione uma expressão cron (ou use um dos presets integrados, como “Weekdays at 9am UTC” ou “Every hour”) e escreva o prompt que diz ao assistente o que fazer.
4. Opcionalmente, restrinja o agendamento a repositórios ou tags específicos para que o assistente opere apenas em um subconjunto do seu código.
5. Clique em Save. Você pode habilitar, desabilitar, editar ou acionar manualmente qualquer agendamento a partir da lista.

​

Criando Agendamentos via Chat

• “Crie uma triagem semanal de todos os novos achados toda segunda-feira às 9h”
• “Verifique vulnerabilidades críticas de SCA diariamente à meia-noite”
• “Execute um resumo da postura de segurança toda sexta-feira às 16h”

​

Contexto de Tarefas Recorrentes

• Acompanhamento de tendências — “Na semana passada havia 12 achados críticos, nesta semana são 8. Melhoria nos repositórios X e Y.”
• Trabalho incremental — o assistente pode continuar de onde parou, em vez de começar do zero.
• Trilha de auditoria — a saída de cada execução é preservada para revisão.

​

Integração com Slack

​

Configuração

1. Garanta que sua organização tenha uma integração com Slack conectada.
2. Na aba Settings do assistente, insira o ID do canal do Slack onde o agente deve publicar.
3. O assistente responderá a @-menções em canais e a mensagens diretas.

​

Conversando com o Assistente

@ZeroPath Você pode fazer a triagem dos 5 novos achados críticos do scan de hoje?

Qual é a postura de segurança atual nos nossos repositórios?

​

Ações Suportadas

​

Integração com Jira e Confluence

• Crie tickets de remediação vinculados a achados do ZeroPath
• Consulte tickets existentes para obter contexto durante a triagem
• Pesquise documentação de arquitetura no Confluence para embasar a modelagem de ameaças e a análise de alcançabilidade

​

Integração com Linear

• Criar tickets de remediação diretamente a partir dos resultados de triagem
• Consultar tickets existentes para obter contexto de remediação

​

Fluxo de PR para Tickets do Linear

• Inclui a chave do ticket do Linear (por exemplo, ZP-123) no nome da branch, no título do PR e no corpo do PR, para que o Linear vincule o PR ao ticket automaticamente.
• Move o ticket do Linear para Todo depois de publicar o link do PR, para que o responsável pelo ticket possa revisar e verificar a correção. O ticket não é movido para um estado concluído ou fechado — ele permanece em Todo até você verificar a correção e fechá-lo manualmente.

​

Servidores MCP Personalizados

​

Memória

• Decisões de triagem e seus fundamentos
• Preferências da equipe e políticas de segurança
• Conhecimento específico de repositórios (arquitetura, padrões comuns, problemas conhecidos)
• Planos de remediação e resultados

​

Visualizando e Gerenciando a Memória

• Pesquisar memórias por palavra-chave para encontrar entradas específicas.
• Editar qualquer entrada de memória inline para corrigir ou refinar o que o assistente armazenou.
• Excluir entradas individuais que não são mais relevantes.
• Limpar todas as memórias para redefinir completamente o conhecimento organizacional do assistente. Essa ação não pode ser desfeita.

​

Boas Práticas

• O assistente pesquisa a memória automaticamente antes de cada tarefa e armazena os resultados depois. Você não precisa dizer explicitamente para ele lembrar das coisas.
• Se quiser corrigir uma decisão passada, diga diretamente ao assistente — ele atualizará sua memória.
• Use instruções globais para orientar o comportamento da memória (por exemplo, “sempre verifique na memória decisões anteriores sobre CVEs semelhantes antes de fazer a triagem”).

​

Permissões

​

Controle de Acesso no Nível de Repositório

​

Log de Auditoria

​

Acesso via API

• Conversas — criar conversas, enviar mensagens, listar e pesquisar conversas e arquivá-las/desarquivá-las
• Jobs — listar, visualizar e cancelar jobs do agente com filtros de status e de gatilho
• Streaming em tempo real — assinar mensagens de jobs do agente via Server-Sent Events (SSE). Você pode fazer streaming de um único job por ID ou de uma conversa inteira. No modo conversa, o stream acompanha automaticamente os novos jobs à medida que são criados, envia eventos de inatividade entre jobs e fecha após 30 minutos com um evento de timeout para que seu cliente possa reconectar
• Agendamentos Cron — criar, atualizar, excluir e acionar manualmente agendamentos recorrentes, com escopo opcional por repositório e tag
• Gatilhos de Eventos — criar, atualizar e excluir gatilhos orientados a eventos com prompts e escopo personalizáveis
• Histórico de Gatilhos — listar execuções passadas de gatilhos com paginação baseada em cursor e recuperar os detalhes completos do job, incluindo as mensagens da conversa
• Memória — listar, editar, excluir e limpar o conhecimento organizacional armazenado do assistente
• Configuração — habilitar/desabilitar o assistente, definir o canal do Slack, configurar o máximo de execuções simultâneas e gerenciar instruções globais