👤 Para quem administra processos no Pipefy e busca automatizar decisões, triagens e leitura de dados em seus fluxos.
🔐 Disponível para todos os planos
🎯 Ensinar a diferença entre automações e agentes de IA, estruturar o primeiro agente passo a passo e utilizar bases de conhecimento (PDFs/políticas) e skills para otimizar processos.
Esse conteúdo nasceu de mais uma edição da série de treinamentos ao vivo da Pipefy Academy. Nela, foi demonstrado na prática como configurar um agente de IA do zero para triagem e análise de reembolsos de despesas corporativas.
Ao terminar a leitura, você entenderá o passo a passo de criação em 3 etapas, como anexar políticas da empresa como base de conhecimento e como testar seus prompts com segurança.
📖 O que você vai entender aqui:
O problema que aparece antes de qualquer configuração
Muitas equipes tentam usar regras fixas de automação para tarefas que exigem interpretação, como ler o comprovante de um reembolso ou analisar a elegibilidade de um pedido. O resultado é um fluxo travado ou cheio de exceções não cobertas.
A escolha da ferramenta correta depende da natureza da ação:
| QUAL FERRAMENTA UTILIZAR? | |
| Processos determinísticos | Automações tradicionais |
| Processos probabilísticos | Agentes de IA |
Framework para guardar: Regra fixa ➔ Use Automação. Leitura, contexto e tomada de decisão ➔ Use Agente de IA.
Pilar 1: Configurando o Agente de IA em 3 Etapas
Para criar um agente, você deve ser administrador do pipe (o botão Agentes de IA fica localizado ao lado de Automações).
Etapa 1: Definição e Persona
Diga ao agente quem ele é e qual o seu papel no fluxo:
- Título: Ex: Agente de Triagem de Reembolso.
- Descrição/Persona: Ex: "Você é um analista financeiro sênior responsável pela triagem dos reembolsos. Siga sempre a política da empresa e forneça respostas criteriosas."
Etapa 2: Base de Conhecimento
Adicione "livros e manuais" para capacitar a IA antes da execução:
- Documento (PDF): Faça o upload do arquivo da política da empresa (ex: PDF com limites por categoria).
- Texto Livre ou Pipes/Databases: Cole textos explicativos ou conecte bancos de dados existentes como insumo.
Etapa 3: Prompt, Gatilhos e Ações
Escreva a instrução prática utilizando o caractere / no teclado para puxar variáveis e campos do Pipefy:
- Gatilho: Sempre que um card for criado.
- Instrução (Prompt): "Analise o pedido de reembolso. Leia o [Comprovante] e o [Tipo de Despesa]. Caso a despesa não seja alimentação, hospedagem ou transporte, recuse."
- Ações: Selecione /Atualizar campos do Card para preencher itens a serem reembolsados e o valor total.
Pilar 2: Recursos avançados, modelos e skills
Ao configurar o agente, você tem acesso a recursos de refinamento técnico:
Modelos de IA Disponíveis
- Classic (Padrão): Otimizado para a maioria das tarefas diárias.
- Light: Recomendado para leituras rápidas, diretas e ações muito simples.
- Pro: Modelo robusto e mais analítico para prompts extensos e análises profundas de contexto.
Superpoderes adicionais (Skills)
- Análise de Documentos (OCR + IA): Lê imagens (JPG, PNG) e PDFs, convertendo o conteúdo em dados e preenchendo campos.
- Pesquisa na Web: Permite ao agente pesquisar dados externos ao vivo (ex: verificar a média de preço de um item em um fluxo de compras).
- Cálculos e Análises: Aumenta a precisão matemática do agente para somas e conferências financeiras complexas.
Validação Humana (Human-in-the-Loop): Nas ações do agente, é possível selecionar a opção de solicitar validação humana. Caso a IA fique insegura ou o valor da solicitação ultrapasse uma margem limite, o sistema envia um e-mail para um responsável aprovar a ação.
Pilar 3: Testes e Sinalização Visual no Card
Testando sem afetar a operação
Antes de ativar o agente em produção, utilize o botão Testar Agente na tela de configuração. Escolha um card existente no processo; a IA executará uma simulação e exibirá todo o plano de execução e a lógica utilizada sem alterar os dados reais do fluxo.
Transparência no Card (Auditoria)
Sempre que um agente de IA atualiza um campo ou processa uma informação no card, o Pipefy exibe uma marcação visual com o ícone de estrela e o aviso: "Conteúdo gerado por IA". Isso permite diferenciar claramente quais inserções foram feitas por humanos e quais foram automatizadas.
Perguntas da audiência, respondidas ao vivo
Como acompanhar o gasto e o limite dos meus créditos de IA (AI Credits)?
Todos os administradores conseguem monitorar o consumo no painel de Administração do Pipefy. Acesse a página Estatísticas de Uso e selecione a aba AI Credits. Lá é exibido o consumo total por agente e quantos créditos foram utilizados no período.
Como funciona o cálculo de uso e custos dos Agentes de IA?
O Pipefy não cobra por número de tokens. O consumo é faturado através de um pacote de Créditos de IA. Cada acionamento de comportamento do agente consome 2 créditos (podendo somar acréscimos pontuais se houver o uso de Skills específicas). Caso a empresa opte por conectar uma LLM própria (In-House) via BYOM, o consumo de tokens é gerido diretamente no contrato do cliente com o provedor do modelo.
Como usar outro Pipe como base de conhecimento dinâmica para consultar registros específicos?
Adicione o segundo Pipe como fonte de conhecimento do agente. O Pipefy permite definir o campo chave (ex: Nome, E-mail ou CPF do participante) como condição de busca. No prompt, instrua o agente a pesquisar na base de conhecimento os registros vinculados àquele ID/campo dinâmico do card principal.
É possível integrar o Pipefy com plataformas externas de IA (como N8N, Claude ou ferramentas proprietárias)?
Sim! Utilizando a funcionalidade de MCP (Model Context Protocol), você pode integrar IAs externas aos seus Pipes. A ferramenta externa atua respeitando a conta de serviço e as permissões de segurança atribuídas a ela no Pipefy.
Antes de avançar, confirme que você entende:
- A diferença entre usar Automações (regras determinísticas) e Agentes de IA (regras probabilísticas).
- Como criar o agente seguindo as 3 etapas (Persona ➔ Conhecimento ➔ Prompt e Ação).
- Como utilizar o caractere / no prompt para puxar campos e mapear atualizações no card.
- Onde visualizar o selo visual de Conteúdo Gerado por IA no Pipefy.
