👤 Para administradores do pipe e equipes de Compras e Compliance responsáveis pela conferência de pedidos
🔐 Conforme as condições de acesso aos Agentes de IA e os créditos contratados pela empresa
🎯 Para cruzar pedidos e cotações no P2P AI Studio e registrar uma classificação de risco para revisão
Antes de emitir um pedido de compra, a equipe precisa confirmar se o fornecedor, os itens e as condições negociadas correspondem à cotação escolhida. Quando esses dados estão distribuídos entre anexos e registros, uma alteração de quantidade ou prazo pode passar despercebida e exigir nova conferência mais adiante.
Com o Agente de Compliance Check, você organiza essa conferência no P2P AI Studio, identifica divergências e registra um parecer para auditoria. Ao terminar a leitura, saberá preparar as entradas, configurar critérios de risco, testar o agente e encaminhar pendências para decisão humana, como em uma compra de notebooks cujo pedido apresenta condições diferentes da proposta aprovada.
📖 O que você vai aprender:
Conheça o agente e o resultado esperado
O agente compara o pedido final com as cotações, identifica divergências e organiza o resultado em verde, amarelo ou vermelho. O parecer deve explicar quais informações foram comparadas, qual regra foi aplicada e o que exige revisão. As cores precisam ter critérios definidos pela empresa para que a equipe interprete o resultado de forma consistente.
Em uma compra de notebooks, por exemplo, o preço pode corresponder à cotação, mas o pedido prever pagamento antecipado quando a condição aprovada era pagamento após a entrega. O agente deve destacar a diferença e indicar a revisão necessária. A classificação sinaliza o resultado da conferência; a liberação do pedido segue as alçadas estabelecidas no processo.
Ao registrar a comparação e as evidências no card, essa atuação contribui para um ciclo de requisição à aprovação 99% mais rápido e para 100% de rastreabilidade no P2P AI Studio. A equipe concentra a análise nas exceções e encontra o contexto reunido quando precisa revisar uma compra.
O fluxo recomendado é reunir o pedido e a cotação selecionada, executar a conferência, registrar o risco e o parecer e encaminhar as pendências ao responsável antes da emissão. Para entender como gatilhos, instruções e ações se combinam, consulte O que são AI Agents e o que eles fazem no seu processo.
Prepare o processo para utilizar o agente
Localize a etapa em que a escolha do fornecedor terminou e os dados do pedido estão prontos para conferência. No P2P AI Studio, identifique a etapa Compliance Check, quando ela estiver presente no seu fluxo, e confirme onde ficam o pedido e a cotação aprovada. Se esses documentos estiverem em cards conectados, configure o acesso à fonte correta e teste a leitura antes de ativar o comportamento.
Separe a identificação do fornecedor, os itens, as quantidades, os valores, a moeda e as condições comerciais que sua empresa exige comparar. Indique explicitamente qual cotação deve servir de referência quando houver várias versões. Use o pedido e as propostas de cada compra como dados do card; mantenha as políticas e os critérios de risco em Conhecimento.
Prepare campos de destino para a classificação, as pendências e o parecer. Esses são resultados recomendados para a implementação: selecione ou crie os campos adequados ao seu pipe e use seus nomes reais. Defina também quem resolve uma divergência comercial, quem avalia uma restrição cadastral e quem autoriza uma exceção.
Uma consulta ao Sintegra ou a outra base cadastral exige uma fonte acessível e uma consulta configurada. Se a conferência incluir esse requisito, disponibilize um resultado identificável e atualizado. Instrua o agente a registrar uma verificação pendente quando essa evidência estiver ausente, sem concluir que o cadastro está regular.
Configure e personalize o agente
Escolha como começar
Para criar do zero, abra o pipe, acesse Agentes de IA e clique em Novo Agente de IA. Se preferir começar pela biblioteca, acesse Agentes de IA > Templates, escolha uma opção de análise documental pertinente e clique em Editar agente. Confira as instruções e ações oferecidas antes de adaptá-las à comparação de pedido e cotação. A opção escolhida precisa atender à lógica da sua conferência.
Se o agente já estiver no processo, abra sua configuração pela lista de Agentes de IA. Os três caminhos seguem a mesma revisão de Geral, Conhecimento e Comportamentos. Em todos eles, confira os vínculos com documentos, campos e ações. O guia de criação de Agentes de IA detalha a configuração inicial.
Geral e Conhecimento
Em Geral, use Agente de Compliance Check como nome e descreva seu papel: comparar o pedido final com a cotação escolhida e os critérios internos, identificar diferenças, classificar o risco e preparar um parecer fundamentado para revisão. Inclua a orientação de registrar informações ausentes e respeitar as alçadas da empresa.
Em Conhecimento, adicione as políticas de compras e uma matriz de classificação aprovada. Especifique o tratamento de diferenças de fornecedor, preço, quantidade, moeda, prazo e pagamento conforme as regras do seu processo. Se os dados cadastrais estiverem em um pipe ou database, disponibilize a fonte pertinente com acesso adequado.
Como ponto de partida para discussão com a equipe, verde pode indicar dados completos e aderentes aos critérios; amarelo, uma pendência que exige avaliação; vermelho, uma divergência enquadrada como impeditiva pela política. Aprove essa interpretação antes de usá-la. Defina tolerâncias, critérios de prioridade entre regras e o tratamento de evidências incompletas. Uma tolerância de preço deve vir da política da empresa, com sua unidade e forma de cálculo.
Comportamentos e gatilho
Crie ou revise um comportamento com finalidade explícita, como Conferir pedido e cotação. Use Um card entrar em uma fase para iniciar a análise na etapa em que os documentos estiverem prontos. Se houver substituição de documentos após essa entrada, avalie Um campo é atualizado como alternativa, escolhendo o campo real que representa a atualização relevante.
Insira os dados pelo editor usando / ou +. Vincule o pedido, a cotação escolhida, a identificação do fornecedor e os destinos dos resultados. Escrever o nome de um campo no texto não cria o vínculo dinâmico. Escolha também as ações que registrarão o parecer e a classificação.
O comportamento do agente executa a análise e as ações configuradas nele. Uma automação do pipe pode utilizar o resultado para conduzir outro passo, mas precisa ser configurada e testada separadamente. Evite que o preenchimento do parecer provoque uma nova execução da mesma conferência.
Personalize as instruções de conferência
Use o exemplo como base e substitua os trechos entre colchetes pelos campos dinâmicos reais. Ajuste as regras à matriz aprovada antes de salvar.
Exemplo de instrução para personalizar:
Compare o pedido disponível em [PEDIDO] com a cotação selecionada em [COTAÇÃO] para o fornecedor identificado em [FORNECEDOR]. Consulte a política de compras e a matriz de risco em Conhecimento. Identifique os documentos e as versões utilizados. Compare a identificação do fornecedor, os itens, as quantidades, os valores, a moeda e as condições de entrega e pagamento exigidos pela política. Registre os valores encontrados em cada fonte e descreva as diferenças.
Aplique somente as tolerâncias e os critérios de classificação aprovados. Registre verde, amarelo ou vermelho conforme essa matriz. Quando faltar um documento, houver informação ilegível ou não for possível identificar a cotação correta, descreva a pendência e aplique o tratamento previsto para análise incompleta. Não interprete ausência de evidência como conformidade. Não declare ter consultado bases externas sem um resultado de consulta disponível.
Use as ações configuradas para preencher [CLASSIFICAÇÃO], [PENDÊNCIAS] e [PARECER]. No parecer, reúna documentos comparados, critérios aplicados, divergências, evidências e próxima ação recomendada. Mantenha a decisão final com o responsável definido pelo processo. Não emita o pedido nem altere dados de origem durante esta conferência.
O parecer registrado no card funciona como relatório da conferência. Se a equipe precisar de um arquivo específico para auditoria, configure sua geração e o armazenamento como uma etapa adicional. Para refinar a redação das regras, consulte Criando instruções eficazes para Agentes de IA.
Melhore as instruções com IA
Clique em Melhorar instruções depois de inserir os campos e as ações. Leia a sugestão e confira se ela preserva a matriz de risco, as tolerâncias e a decisão humana. Use Testar sugestão quando disponível; escolha Tentar novamente para obter outra versão ou Descartar para manter a atual. Aplique Substituir somente quando a proposta estiver adequada.
Inclua nas instruções um exemplo de divergência recorrente do seu processo, com o resultado esperado. Isso ajuda a tornar explícita a diferença entre uma pendência que exige conferência e uma condição impeditiva.
Escolha modelo, Skills e Esforço
Selecione o modelo por comportamento. Comece os testes com Pipefy AI Standard para uma comparação de documentos legíveis com critérios objetivos. Avalie Pipefy AI Pro se houver várias propostas conflitantes ou interpretação mais complexa das exceções, comparando a qualidade dos resultados e o consumo de créditos.
Ative Análise de documentos para ler os anexos. Ative Cálculos e análises quando a conferência precisar recalcular totais ou diferenças percentuais. Mantenha Pesquisa na Web desativada na configuração inicial, que usa os documentos e as fontes internas disponibilizadas ao agente. Uma pesquisa pública precisa ter objetivo e critérios próprios; ela não equivale a uma consulta autenticada a cadastro fiscal.
Em Esforço, mantenha a configuração padrão nos primeiros testes. Se avaliar Esforço Máximo, considere que essa opção habilita o modelo Pro e sua cobrança. Compare a qualidade e o consumo antes de adotá-la. Confira as opções e o consumo na FAQ sobre modelos de IA e créditos e nas condições atuais dos modelos.
Resultados e decisões humanas
Confirme que o parecer fica disponível no card e que o resultado aponta o responsável pela pendência. Na primeira implementação, mantenha a revisão humana antes de liberar o pedido, inclusive quando a classificação for verde. Uma cor favorável não substitui uma aprovação exigida pela política.
Se optar por uma etapa nativa de validação, configure o responsável e os campos da revisão conforme o guia de Validação Humana em Agentes de IA. Teste a conclusão dessa revisão antes de associar qualquer avanço do processo.
Teste o agente na prática
Use um card representativo, com documentos de teste sem dados sensíveis desnecessários. Use o botão Testar para avaliar o comportamento e depois simule o gatilho real. Salve a configuração em um ambiente de teste controlado antes de validar a execução pelo gatilho. Confira o conteúdo do parecer, as atualizações e o encaminhamento em cada cenário.
- Pedido aderente: os dados correspondem à cotação e aos critérios aprovados. O agente deve registrar verde, identificar as evidências e manter a aprovação humana prevista.
- Divergência comercial: altere quantidade, preço ou condição de pagamento. O parecer deve mostrar os dois valores ou condições e aplicar a regra correta para amarelo ou vermelho.
- Fornecedor divergente: use pedido e proposta com identificações diferentes. O agente deve apontar a divergência e solicitar a conferência, sem presumir equivalência entre empresas.
- Documento ausente ou ilegível: retire a cotação ou use um arquivo sem leitura suficiente. O resultado deve descrever a análise incompleta e seguir o tratamento da matriz, sem registrar conformidade.
- Revisão humana e nova versão: corrija uma pendência, substitua o documento e repita a análise pelo caminho definido. Confira se a nova versão é usada e se o responsável registra a decisão antes do próximo passo.
Se a resposta ficar genérica, confira os vínculos dinâmicos e a identificação da cotação de referência. Se o parecer estiver correto, mas o campo não for preenchido, revise a ação e seu destino. Em Agentes de IA > Logs > Ver detalhes > Rastreamento, examine as fontes e as ações. O artigo sobre rastreamento de execução ajuda nessa conferência.
Revise e coloque em operação
Revise o acesso ao pipe, aos documentos comerciais e ao Conhecimento. Confirme que apenas as pessoas apropriadas podem consultar informações de fornecedores e alterar políticas. Remova anexos de teste e confira destinatários e ações de qualquer comunicação que tenha acrescentado ao fluxo.
Acompanhe as primeiras execuções com Compras e Compliance. Compare a classificação com a avaliação humana e ajuste regras ambíguas. Meça o tempo de conferência, as pendências identificadas e os casos reclassificados após revisão. Quando a política ou a cotação mudar, mantenha a referência atualizada e repita os testes afetados.
Para aprofundar a configuração e a governança desse fluxo, continue na Certificação de Especialista em Inteligência Artificial do Pipefy.
Antes de avançar, confirme que você entende:
☐ Escolhi entre criar o agente, adaptar um template ou revisar o existente.
☐ Identifiquei o pedido, a cotação de referência e os dados do fornecedor.
☐ Aprovei a matriz de risco, as tolerâncias e o tratamento de análise incompleta.
☐ Vinculei campos, ações e gatilho ao momento correto da conferência.
☐ Revisei a sugestão de melhoria e selecionei modelo, Skills e Esforço.
☐ Testei divergências, arquivos ausentes e a substituição de documentos.
☐ Confirmei o responsável pela revisão e a decisão antes da emissão do pedido.
☐ Revisei acessos, removi dados de teste e defini o acompanhamento das execuções.
