👤 Para administradores de pipe e gestores de processo
🔐 Disponível nos planos pagos
🎯 Para quem tem um pipe rodando e quer identificar o que melhorar sem revisar tudo manualmente
Todo processo em uso há algum tempo acumula camadas: automações criadas para resolver problemas pontuais, fases que cresceram além do planejado, prazos que nunca foram definidos. Revisar tudo isso manualmente exige tempo e um olhar fresco sobre o que está funcionando e o que não está.
Com o Pipefy conectado ao assistente, você pode pedir essa leitura. Ele inspeciona a estrutura do pipe, identifica padrões problemáticos e traz recomendações concretas. E quando você decide aplicar uma sugestão, ele executa a mudança e você confere o resultado no audit log.
Pré-requisito: a etapa 1 é leitura e roda em qualquer conexão. As etapas 2, 3 e 4 escrevem no pipe ou leem registros de auditoria, então exigem a instalação local do MCP Server e habilidade de admin no pipe. Se você conectou pelo caminho hospedado, faça a etapa 1 e migre antes de seguir.
📖 O que você vai encontrar aqui:
O que o assistente lê numa auditoria de pipe
Quando você pede recomendações de melhoria, o assistente não olha apenas os nomes das fases. Ele inspeciona a estrutura para entender como o pipe funciona na prática:
- Fases e distribuição de cards: onde os cards estão concentrados e quais fases têm maior volume parado
- Automações: quais existem, quais condições disparam cada uma e quais ações elas executam, o que revela conflitos e redundâncias
- Campos e formulário inicial: se há campos desnecessários ou ausência de campos importantes para o processo
- AI Agents: se existem agentes configurados e se os behaviors estão alinhados com o que o processo precisa
A diferença entre auditoria por IA e varredura por nome está aqui: o assistente lê as condições e as ações configuradas em cada automação, não o rótulo dela. É assim que ele consegue apontar que uma automação chamada "triagem" não faz triagem de verdade, ou que duas automações estão competindo pela mesma movimentação.
Uma ressalva sobre prazos: as leituras dedicadas de fase não devolvem o SLA configurado. O assistente consegue avaliar essa dimensão quando recorre à consulta bruta da API, o que depende do caminho de instalação e não é garantido. Se prazo é o foco da sua auditoria, peça explicitamente e confirme o resultado na tela da fase.
Pipes de teste com dados artificiais recebem recomendações menos úteis. O assistente conclui a partir do que está no pipe: se os dados não refletem uso real, as sugestões também não vão. Para uma auditoria útil, aponte para um pipe que está em produção, com a ressalva de risco abaixo.
O fluxo completo, em quatro etapas
As quatro etapas acontecem naturalmente na conversa. Você não precisa fazer todas de uma vez: pode pedir o diagnóstico hoje e aplicar as mudanças amanhã, desde que referencie o pipe e a fase explicitamente quando voltar.
Diagnóstico é leitura e não altera nada. A partir da etapa 2 o assistente escreve no pipe, e mudanças que não são exclusão são aplicadas sem prévia. Em pipe de produção com volume, considere clonar o pipe e validar as mudanças na cópia primeiro. O assistente consegue fazer esse clone se você pedir.
Etapa 1: solicitar o diagnóstico
✓ Somente leitura · funciona nos dois caminhos de conexão
Você digita: Quero recomendações de melhorias no pipe [nome]
Pipefy executa: lê fases, distribuição de cards, automações com condições e ações, campos e AI Agents configurados
O que retorna: lista de recomendações ordenadas por impacto, com diagnóstico explicado item por item
Etapa 2: escolher o que aplicar
🔓 Escreve no pipe · requer instalação local e admin no pipe
Você digita: "Gostei da sugestão 3. Pode aplicar?"
Pipefy executa: descreve o que vai fazer, pede detalhes adicionais se necessário e executa a mudança
O que retorna: descrição do que foi criado ou alterado no pipe
Você pode pedir mais de uma sugestão de uma vez: "aplique as sugestões 2 e 4". O assistente executa em sequência e descreve cada uma. Confira as duas na tela depois, porque a descrição vem do assistente, não do Pipefy.
Etapa 3: verificar no audit log do pipe
🔓 Escreve no pipe · requer instalação local e admin no pipe
Você digita: "Exporte o audit log do pipe [nome] das últimas 24 horas"
Pipefy executa: exporta o registro de auditoria do pipe, com autor, ação e horário de cada alteração
O que retorna: o registro auditável do que mudou, independente do que o assistente disse ter feito
Esta é a rastreabilidade real do Pipefy, e é mais confiável do que pedir ao assistente para recapitular o que fez. O audit log registra autor, ação e horário de forma auditável, e não depende da memória da conversa. Para conferir uma automação ou fase específica, abra o item na tela do pipe.
Etapa 4: refinar quando necessário
🔓 Escreve no pipe · requer instalação local e admin no pipe
Você digita: "Ajuste o SLA da fase Inbox do pipe [nome] para 48 horas"
Pipefy executa: localiza a fase indicada e grava o novo prazo
O que retorna: confirmação da fase atualizada
Referencie sempre o pipe e a fase pelo nome, mesmo continuando na mesma conversa. Em uma sessão nova o assistente não tem o elemento da etapa anterior e vai redescobrir por busca. Se houver mais de uma fase candidata, ele pode ajustar a errada.
Vale saber o que não existe: não há desfazer automático. Se uma mudança não era o que você queria, reverter é trabalho manual, feito na tela do Pipefy. É outro motivo para clonar o pipe quando o volume é alto.
Um exemplo do que a auditoria encontra
Para ilustrar o formato do resultado, considere um pipe de analytics com cards acumulados e automações que cresceram além do escopo original. Uma auditoria nesse cenário costuma apontar quatro tipos de achado:
- Gargalo em uma fase: cards acumulados na entrada, indicando que a triagem não está funcionando como esperado
- Automação com conflito: uma automação que o nome descreve como triagem, mas cujas condições configuradas competem com a movimentação manual
- Ausência de prazo: cards que podem ficar parados indefinidamente sem marcação de atraso
- Distribuição desbalanceada: concentração de cards em uma fase apontando para um ponto de decisão sem critério claro
Ao aceitar a sugestão de revisar a automação e definir o prazo, o assistente aplica as mudanças e você confirma no audit log. O achado mais valioso desse conjunto é o segundo, porque depende de ler a configuração e não o rótulo.
Quando faz sentido pedir uma auditoria
Sinais de que um pipe se beneficia de uma leitura pelo assistente:
- Cards acumulando em uma ou mais fases sem movimentação
- Automações criadas para resolver problemas pontuais que nunca foram revisadas
- Prazos ausentes ou definidos de forma inconsistente entre as fases
- Processo que cresceu além do escopo original sem atualização da estrutura
- Time operando o pipe sem clareza sobre o que cada fase representa
A auditoria não substitui uma revisão de processo com o time. Ela complementa: o assistente identifica o que está visível na estrutura, e a conversa com o time traz o contexto que a estrutura não captura.
Antes de avançar, confirme que você:
☐ Pediu o diagnóstico e recebeu as recomendações
☐ Entende que da etapa 2 em diante o assistente escreve no pipe, sem prévia
☐ Considerou clonar o pipe se ele está em produção com volume
☐ Conferiu no audit log o que efetivamente mudou
Próximo passo na série
Para transformar as recomendações em um agente que atua no processo, veja "Como criar um AI Agent para o seu processo com o MCP Server".
