👤 Para administradores do pipe e equipes de Compras, Sustentabilidade e Compliance que avaliam fornecedores
🔐 Disponível para todos os planos, conforme as condições de acesso e créditos de IA da organização
🎯 Para criar ou adaptar um agente que calcula o score ESG e prepara um parecer para decisão humana
Receber os certificados de um fornecedor resolve apenas uma parte da avaliação. A equipe ainda precisa identificar quais requisitos foram comprovados, aplicar os pesos da política interna e explicar o resultado. Quando cada analista faz essa conta de um jeito, comparar fornecedores e justificar pendências exige novas conferências.
Ao terminar a leitura, você saberá configurar o Agente de Score de Sustentabilidade para analisar evidências, calcular a pontuação conforme os critérios da empresa e registrar um parecer revisável. Você também terá um roteiro para testar o cálculo, tratar documentos incompletos e preservar a decisão humana sobre a homologação.
📖 O que você vai aprender:
- Conheça o agente e o resultado esperado
- Prepare o processo para utilizar o agente
- Configure e personalize o agente
- Teste o agente na prática
- Revise e coloque em operação
Conheça o agente e o resultado esperado
O agente atua no cálculo do score ESG, que reúne critérios ambientais, sociais e de governança. Ele analisa documentos, identifica requisitos atendidos, gera uma pontuação ponderada por certificação e justifica desvios. Com essa análise estruturada, o processo de Avaliação Inteligente de Fornecedores ganha 95% mais agilidade na avaliação ESG, reduz o retrabalho técnico em 70% e mantém 100% da conformidade monitorada.
Imagine a rotina de Compras ao avaliar um fornecedor com certificações ambientais, mas sem comprovação de um requisito social exigido pela empresa. O parecer precisa indicar a evidência encontrada, a pendência e seu efeito na pontuação. A equipe decide se solicita um complemento, estabelece uma condição para continuidade ou encaminha o caso para outra avaliação.
A conferência documental prepara a entrada do cálculo. Se você também utiliza o validador, organize essa passagem com o artigo Como configurar o Agente Validador de Certificações. O score deve considerar o resultado dessa conferência quando ele fizer parte do seu processo.
Prepare o processo para utilizar o agente
Antes de editar o agente, reúna a política ESG aprovada e identifique quem responde por suas alterações. Ela precisa definir critérios por categoria de fornecedor, evidências aceitas, pesos, fórmula, arredondamento e faixas de classificação. Registre também requisitos obrigatórios que exigem revisão mesmo quando a pontuação total é alta.
Defina como tratar informação ausente, documento ilegível e critério não aplicável. A ausência de evidência precisa ficar explícita. A política deve determinar se ela interrompe o cálculo ou recebe uma pontuação específica. Para critérios não aplicáveis, descreva se o peso é redistribuído e como isso altera o denominador da fórmula.
Organize a entrada e a saída no card. O agente deve acessar a identificação do fornecedor, os anexos e, quando houver, o parecer de validação anterior. Prepare destinos adequados para pontuação, classificação, status da análise e parecer. Esses são exemplos de informações a registrar; use os campos reais do seu pipe.
Separe certificados de teste com resultados já calculados pela equipe. Restrinja o acesso aos documentos e às políticas aos responsáveis apropriados e escolha em qual momento o conjunto de evidências estará pronto para análise.
Documentos do fornecedor pertencem à avaliação daquele card. A política e a matriz de pontuação são referências de Conhecimento. Mantenha essas funções claras para evitar que uma regra encontrada em um anexo substitua os critérios da empresa.
Configure e personalize o agente
Escolha como começar
Para criar do zero, abra o pipe, acesse Agentes de IA e selecione Novo Agente de IA. Para partir de uma base pronta, consulte a aba Templates e avalie um template de análise documental disponível. Antes de selecionar Editar agente, confira seus comportamentos: a leitura de documentos precisa ser complementada pelas regras de pontuação deste processo.
Se o agente já estiver no pipe, abra sua configuração para revisá-la. Nos três caminhos, percorra Geral, Conhecimento e Comportamentos e confira os vínculos com os campos reais. O guia de criação de Agentes de IA aprofunda a navegação.
Geral e Conhecimento
Em Geral, use o nome Agente de Score de Sustentabilidade e descreva o papel de analisar evidências ESG, aplicar a matriz aprovada e preparar um parecer para revisão. Inclua o limite de atuação: a decisão sobre homologação permanece com a pessoa responsável.
Em Conhecimento, disponibilize a política vigente e a matriz de critérios, pesos e faixas. Identifique a versão e a data de aplicação. Caso existam regras diferentes por categoria, explique como selecionar a correta. Conecte um pipe ou database somente se a avaliação precisar consultar dados mantidos ali, com acesso e filtros adequados ao fornecedor.
Comportamentos e momento do cálculo
Crie ou revise um comportamento com finalidade clara, como Calcular score ESG do fornecedor. Escolha um gatilho que corresponda ao momento em que as evidências estarão prontas, por exemplo a entrada na fase real de cálculo. Se o recálculo depender de uma atualização de campo, selecione o evento pertinente e teste quando ele deve ocorrer.
Evite usar como gatilho o próprio campo que o agente atualiza ao concluir. Defina como uma nova evidência será encaminhada para recálculo e como a equipe reconhecerá um resultado anterior que precisa de revisão.
No editor, use / ou + para inserir as referências dinâmicas de entrada e a ação de atualizar os campos de resultado. Associe os destinos corretos para pontuação e parecer. Uma automação do pipe que move cards conforme o status deve ser configurada e testada separadamente do comportamento do agente.
Instruções para a pontuação e o parecer
Adapte o exemplo aos critérios aprovados. Substitua as referências entre colchetes por campos dinâmicos e ações reais do editor. Defina na política a fórmula completa antes de pedir ao agente que a execute.
Exemplo de instrução para personalizar
Avalie o fornecedor identificado em [IDENTIFICAÇÃO DO FORNECEDOR] usando [ANEXOS] e [PARECER DOCUMENTAL, SE APLICÁVEL]. Consulte a política ESG vigente e a matriz de pontuação em Conhecimento. Identifique a categoria do fornecedor e a versão da política aplicável. Se faltar essa definição ou houver conflito entre regras, registre a pendência para revisão humana e não conclua a pontuação.
Para cada critério aplicável, registre a certificação ou evidência consultada, o requisito, o resultado da análise, o peso e a contribuição para o score. Distinga requisito atendido, requisito não atendido, evidência insuficiente e critério não aplicável. Aplique o tratamento definido na política para cada situação. Não presuma conformidade a partir do nome do documento nem atribua pontos sem evidência.
Use Cálculos e Análises para executar a fórmula aprovada, incluindo denominador, pesos e arredondamento. Apresente a memória de cálculo e aplique apenas as faixas de classificação aprovadas. Não conte duas vezes a mesma evidência e não crie critérios, pesos, faixas ou prazos de plano de ação.
Use [AÇÃO DE ATUALIZAÇÃO] para registrar o score em [DESTINO DA PONTUAÇÃO] somente quando houver condições de concluir o cálculo. Registre em [DESTINO DO STATUS] se a avaliação foi concluída ou depende de revisão, usando as opções reais desse campo. Em [DESTINO DO PARECER], informe a versão da política, os resultados por critério, a memória de cálculo, as pendências e os requisitos obrigatórios não comprovados. Se a avaliação estiver inconclusiva, sinalize que eventual score anterior precisa de revisão. Encaminhe a decisão à pessoa responsável pelo fluxo, sem aprovar ou reprovar o fornecedor.
Confira se cada destino aceita o resultado esperado. Se a análise ficar inconclusiva, estabeleça um tratamento para o score anterior, como invalidá-lo conforme a estrutura do seu pipe, e impeça que ele seja usado como resultado atual. Configure comunicações e movimentações somente quando fizerem parte do fluxo aprovado.
Melhore as instruções
Após personalizar, use Melhorar instruções e compare a sugestão com sua política. Quando disponíveis, use Testar sugestão e Tentar novamente para avaliar alternativas. Escolha Descartar se a proposta alterar a regra ou Substituir se ela preservar a lógica e os vínculos necessários.
Revise principalmente o tratamento de documentos ausentes e a condição para registrar uma pontuação final. O artigo Agentes de IA: melhorar instruções explica como incorporar essa revisão à configuração.
Escolha modelo, Skills e Esforço
Selecione o modelo por comportamento. Comece os testes com Pipefy AI Standard para uma matriz clara e um conjunto documental moderado. Compare com Pipefy AI Pro quando houver evidências conflitantes, várias categorias ou interpretação mais complexa. Escolha a configuração pelos resultados obtidos e pelo consumo de créditos.
Habilite Análise de documentos para a leitura dos anexos e Cálculos e Análises para executar a fórmula ponderada. A política fixa deve estar em Conhecimento. Ative Pesquisa na Web apenas se houver uma necessidade aprovada de consulta externa, com fontes e finalidade definidas.
Mantenha o Esforço proporcional à tarefa. Considere Máximo, disponível com Pro, quando os testes indicarem necessidade de relacionar documentos extensos ou aprofundar a análise. Mais raciocínio precisa vir acompanhado de regras claras e conferência do cálculo. Consulte como usar Cálculos e Análises para preparar essa execução.
O score orienta a avaliação. Requisitos obrigatórios, exceções e decisões de homologação precisam seguir a política da empresa e a revisão do responsável, inclusive quando a nota total for alta.
Teste o agente na prática
Use Testar comportamento para comparar a resposta com avaliações preparadas pela equipe. Depois, em ambiente de teste, confirme o preenchimento real dos campos e a passagem para revisão humana.
- Documentação completa: confira se os critérios atendidos recebem os pontos previstos, a fórmula usa os pesos corretos e o parecer permite reproduzir a conta.
- Divergência de conformidade: use um documento que não comprove um requisito. O parecer deve indicar a falha, seu efeito na nota e a necessidade de decisão humana.
- Anexo ausente ou ilegível: confirme que o agente registra evidência insuficiente e aplica o tratamento aprovado, sem apresentar um score anterior como atual.
- Limite de classificação: teste valores próximos das faixas da política, verificando arredondamento e classificação. Inclua critério não aplicável e evidência duplicada para conferir o denominador e evitar pontuação em dobro.
- Revisão e recálculo: envie uma evidência corrigida e confirme o novo resultado, a política aplicada e o encaminhamento ao responsável. Uma boa nota com requisito obrigatório pendente deve continuar visível para revisão.
Se a conta divergir, confira fórmula, pesos e tratamento das pendências. Se o parecer estiver correto, mas os campos permanecerem vazios, revise a ação de atualização. Para investigar a execução e as fontes consultadas, veja como testar e acompanhar processos com IA.
Revise e coloque em operação
Confirme os acessos, o responsável por exceções, os destinos dos resultados e o momento do gatilho. Remova resíduos de teste e verifique se notificações ou movimentações adicionais têm condições e destinatários corretos. Combine quem mantém a política e quando os fornecedores precisarão de uma nova avaliação após sua atualização.
Acompanhe as primeiras execuções pelos Logs e pelas atividades dos cards. Compare pontuação, justificativa e decisão humana, observando também tempo de análise e retrabalho. Quando houver ajuste de regra, repita os cenários conhecidos antes de ampliar o uso.
Para aprofundar configuração e governança, continue na Certificação de Especialista em Inteligência Artificial do Pipefy, com conteúdos sobre prompts, agentes e segurança de dados.
Antes de avançar, confirme que você entende
☐ Defini critérios, evidências, pesos, fórmula, faixas e versão da política.
☐ Determinei como tratar pendências, requisitos obrigatórios e critérios não aplicáveis.
☐ Vinculei anexos, identificação do fornecedor e destinos reais dos resultados.
☐ Configurei o gatilho e o caminho de recálculo sem criar execuções repetidas pelo próprio resultado.
☐ Revisei a sugestão de melhoria e selecionei modelo, Skills e Esforço.
☐ Comparei a memória de cálculo com resultados conhecidos e testei documentos incompletos.
☐ Confirmei a revisão humana, os acessos e o acompanhamento das primeiras avaliações.
