O Calculations & Analysis é uma capability avançada que você pode habilitar nos Agentes de IA do Pipefy. Com esse recurso ativado, o seu agente ganha a capacidade de escrever pequenos blocos de código em tempo de execução dentro de um ambiente isolado e seguro (sandbox).
O agente lê suas instruções em português claro, gera a lógica de programação em segundo plano, roda o cálculo e preenche os campos do card automaticamente.
O que esta funcionalidade resolve
Erros e alucinações matemáticas: Garante precisão total para somas de notas fiscais, taxas de conversão, aplicação de multas e rateio de centros de custo.
Lógicas de negócio complexas: Substitui planilhas externas acessórias ou integrações customizadas caras por regras descritas em texto comum.
Cálculos de prazos e estruturação de dados: Executa operações exatas de calendário (descontando feriados e fins de semana) e transforma dados tabulares brutos de PDFs/imagens em valores limpos para preencher campos específicos.
Antes de começar
Você precisa ter permissões de Administrador do Pipe para criar e configurar Agentes de IA.
Tenha em mãos as regras de negócio escritas de forma clara. O agente interpretará suas instruções textuais para montar os scripts lógicos de execução.
Passo a passo
A criação e parametrização do seu agente com suporte a cálculos é dividida em três seções principais dentro do painel de Agentes de IA: Create, Knowledge e Behaviors.
Acesse o pipe onde deseja implementar o agente analítico.
No cabeçalho do pipe (no menu superior), clique no botão AI Agents.
Na tela de gerenciamento de agentes, clique no botão New AI Agent (canto superior direito).
Na aba Create, insira um Nome claro para o seu agente (ex: Agente de Auditoria) e uma Descrição detalhada.
❗ Atenção: O preenchimento do campo Description é obrigatório. O Pipefy utiliza este contexto inicial para otimizar as decisões e a performance do agente.
Avance para a aba Knowledge. Se o agente precisar consultar tabelas fixas ou políticas em PDF para embasar os cálculos, adicione-os aqui. Caso contrário, siga adiante.
Clique na aba Comportamentos e selecione Adicionar novo comportamento.
Defina o Gatilho que ditará quando este comportamento deve rodar.
Na seção de Ferramentas avançadas, marque a caixa ou ative o seletor correspondente ao Calculations & Analysis.
No campo de instruções principais (Prompt), escreva de forma descritiva e detalhada a regra matemática ou lógica que o agente deve executar.
Exemplo: "Verifique se o valor total ultrapassa o teto do
@Centro de Custo. Se ultrapassar, calcule a porcentagem excedente e mude o status para revisão."
ℹ️ Dica: Digite
/ou clique no botão+para inserir informações dinâmicas extraídas dos campos do seu card.Na área de ações do comportamento, clique em Select the fields to return the results para apontar onde as respostas calculadas (valores ou tabelas) devem ser gravadas no card.
Clique em Save para ativar o comportamento e colocar o seu Agente em produção.
Limites e Comportamentos
Para manter a estabilidade e a velocidade do seu trabalhador digital, o Pipefy adota limites rígidos por execução:
Entradas de dados (Inputs): Até 30 variáveis dinâmicas inseridas nas instruções do prompt.
Instruções (Prompt): Limite de 10.000 caracteres para o texto fixo de comportamento.
Saídas (Outputs): Até 30 campos de destino podem ser mapeados para receber os resultados.
Leitura de documentos: Até 30 páginas por arquivo PDF.
Processamento de imagens: Até 30 imagens anexadas por execução.
Formatos suportados: PDF, PNG e JPG.
❗ Quando não usar: O Calculations & Analysis foca estritamente em caminhos lógicos pautados por matemática e regras. Não ative o recurso se a tarefa for puramente conversacional (como redigir e-mails) ou se exigir apenas buscar um dado em um sistema externo sem aplicar transformações matemáticas a ele.
Checklist de validação e segurança
Antes de abrir o agente para a equipe usar na rotina da operação, valide:
[ ] Teste de Edge Cases: Crie deliberadamente um card de teste com dados zerados, valores negativos ou campos de data vazios para validar se o agente sabe tratar exceções.
[ ] Auditoria de Nomenclatura: Certifique-se de que todas as variáveis (
@Campo) inseridas no prompt continuam com o mesmo nome no formulário. Se você alterar o nome de um campo no Pipefy, atualize o prompt do agente.[ ] Uso das Descrições: O agente lê as descrições nativas dos campos no formulário como contexto extra. Mantenha as descrições dos campos bem detalhadas.
[ ] Estratégia de Rollback (Segurança): Na primeira semana, não deixe o agente executar ações críticas sozinho. Direcione o cálculo para um campo de "Revisão da IA" e exija uma aprovação humana. Em caso de falha sistêmica, realize o rollback desativando temporariamente o comportamento na aba Behaviors até ajustar as instruções.
Troubleshooting (Solução de Problemas)
O agente executou uma conta ou aplicou uma regra de forma errada.
Como corrigir: Refine as instruções escritas no prompt. A forma mais segura de orientar a IA é usar exemplos práticos. Insira cenários fixos no próprio texto (ex: "Se a entrada for X, o resultado deve ser Y"). Isso calibra o gerador de código com extrema precisão.
Os campos do card não atualizam após a rodada do agente.
Como corrigir: Acesse o menu lateral do Pipefy, vá em Automations e abra a aba de Logs para verificar o histórico do agente. Cheque se há algum erro de compatibilidade de tipo de campo (ex: injetar um texto explicativo longo em um campo de "Número"). Garanta que os rótulos mapeados em Select the fields to return the results correspondem aos campos ativos.
Erro ao processar ou ler anexos de documentos/imagens.
Como corrigir: Certifique-se de que os arquivos do card estão estritamente nos formatos compatíveis (PDF, PNG ou JPG). Verifique também se os limites operacionais (mais de 30 páginas por PDF ou mais de 30 imagens por card) não foram ultrapassados.