Como configurar o agente Análise de Risco em Contas a Receber

Quando várias faturas precisam de atenção ao mesmo tempo, conferir o histórico de cada cliente antes de decidir quem contatar primeiro consome parte da rotina do Financeiro. O agente Análise de Risco organiza essa avaliação e recomenda uma estratégia para cada cliente, contribuindo para processar cobranças com 95% menos tempo e concentrar a equipe nas decisões que exigem acompanhamento.

Ao terminar a leitura, você terá o caminho para criar ou adaptar o agente, fornecer os critérios da sua empresa, configurar as saídas e testar a análise antes de colocar o agente em operação. Considere uma fatura próxima do vencimento de um cliente que passou a pagar com atraso: a equipe precisa identificar essa mudança, entender a evidência e decidir se cabe antecipar o contato.

📖 O que você vai aprender:

Conheça o agente e o resultado esperado

O agente avalia o risco de cobrança, gera uma pontuação de 0 a 100 e recomenda a estratégia de abordagem. A pontuação precisa ter um significado definido pela empresa: qual direção representa maior risco, quais fatores entram no cálculo e como o resultado orienta a cobrança.

Uma mudança no histórico pode justificar acompanhamento mais próximo, mas precisa ser interpretada com contexto. Se uma fatura está em contestação, o analista deve verificar a divergência antes de seguir com a abordagem sugerida. Um resultado útil explica os fatores considerados e permite conferir por que aquela estratégia foi recomendada.

A análise prepara a decisão de cobrança. Confirmar pagamento, conceder desconto ou enviar mensagens são atividades que precisam de regras e ações próprias. Para entender a sequência operacional, consulte Contas a Receber: configure o template.

Prepare o processo para utilizar o agente

Defina com a equipe quais evidências permitem analisar o risco: identificação do cliente, documentos do débito e histórico de pagamentos disponível. Confira o período coberto pelo histórico e se os documentos pertencem ao mesmo cliente. Uma ausência de histórico deve ser tratada como informação insuficiente, sem virar sinal automático de baixo risco.

Separe a política de risco e cobrança dos documentos de cada card. A política deve explicar os fatores, pesos e faixas de classificação, os critérios de exceção e quem revisa recomendações. Também deve esclarecer quando interromper a análise e pedir complementação. Se a empresa usa um score externo, determine sua fonte e atualização antes de incluir esse dado na avaliação.

Prepare os destinos do resultado. No template de Contas a Receber, Pontuação de Risco, Grupo de Risco e Estratégia de Cobrança Sugerida ajudam a organizar a saída. Para a justificativa, confira o campo Comentários da Análise de Risco. Em um pipe personalizado, selecione os campos equivalentes que a equipe utiliza.

Escolha uma pessoa responsável por validar a recomendação antes do contato. Restrinja o acesso aos dados financeiros às pessoas que precisam trabalhar com eles e prepare cards de teste com documentos representativos.

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. Para partir de uma base pronta, abra Agentes de IA > Templates, examine as opções e selecione Editar agente na opção escolhida. Confira se ela atende à leitura de dados e ao registro de resultados necessários à análise de risco antes de adaptar essa base.

Se já existe um agente no pipe, abra sua configuração e revise o mesmo conjunto: identidade, Conhecimento e Comportamentos. O artigo Como configurar um agente de IA para economizar tempo ajuda a reconhecer esse caminho na interface.

Geral: defina o papel do agente

Use Análise de Risco como nome e descreva sua função de forma específica. Uma base para personalizar é: Você apoia a equipe de Contas a Receber. Analise as evidências do débito e o histórico do cliente conforme a política aprovada, registre a avaliação e recomende uma abordagem para revisão do analista. Quando faltarem informações, descreva o que impede a conclusão.

Essa descrição delimita o trabalho. A responsabilidade pela negociação e pelas exceções deve permanecer com as pessoas definidas no processo.

Conhecimento: forneça a política e o contexto

Em Conhecimento, adicione a política de risco e cobrança vigente. Inclua exemplos aprovados de avaliação, principalmente casos próximos dos limites entre faixas. O agente precisa encontrar critérios que permitam repetir a mesma lógica em situações semelhantes.

Quando o histórico estiver em outro pipe ou database, disponibilize essa fonte conforme as permissões do processo e defina como identificar o cliente correto. Dados mantidos no ERP precisam chegar por uma integração configurada ou por uma fonte disponibilizada ao agente. Citar o sistema nas instruções não concede acesso às suas informações.

Mantenha os anexos específicos do débito no card e associe os campos às instruções. Use Conhecimento para as referências compartilhadas entre análises.

Comportamentos: determine o momento e as ações

Crie ou revise um comportamento com uma finalidade clara, como Avaliar risco de cobrança. Escolha um gatilho que ocorra quando os dados estiverem prontos. A entrada na fase de análise é uma opção; se a conclusão depende de uma informação adicionada depois, avalie o gatilho de atualização desse campo.

Selecione os campos e a ação de atualizar o card pelo menu / ou pelo botão + do editor. Mapeie as entradas do cliente e dos documentos e os destinos da avaliação. A configuração do comportamento define a análise do agente; revise separadamente as automações do pipe que usam seus resultados para enviar mensagens ou mover cards.

Evite usar como gatilho um campo que o próprio comportamento atualiza. Teste também se a mesma análise pode ser executada novamente após a correção de um documento, sem iniciar contatos duplicados.

Personalize as instruções de análise

Adapte o exemplo abaixo à política aprovada. Os trechos entre colchetes representam referências a substituir pelos campos e ações reais do editor.

Exemplo de instrução para personalizar

Analise o débito do cliente em [IDENTIFICAÇÃO DO CLIENTE] usando [DOCUMENTOS DO DÉBITO] e [HISTÓRICO DE PAGAMENTOS]. Consulte a política de risco e cobrança em Conhecimento. Confira se as evidências se referem ao mesmo cliente e registre o período do histórico considerado.

Verifique se existem as informações exigidas pela política. Se faltar um documento, houver conteúdo ilegível ou os dados divergirem, use [AÇÃO DE ATUALIZAR RESULTADOS] para descrever a pendência em [CAMPO DE JUSTIFICATIVA]. Nesse caso, deixe a pontuação e a classificação sem resultado conclusivo e solicite revisão pelo fluxo definido pela equipe. Não reutilize uma avaliação anterior como se fosse atual.

Quando os dados forem suficientes, aplique os fatores, pesos e faixas aprovados para calcular uma pontuação de 0 a 100. Use [AÇÃO DE ATUALIZAR RESULTADOS] para registrar [CAMPO DE PONTUAÇÃO], [CAMPO DE GRUPO], [CAMPO DE JUSTIFICATIVA] e [CAMPO DE ESTRATÉGIA]. Explique as evidências utilizadas e recomende somente abordagens permitidas pela política. Não invente score externo, datas, pagamentos ou informações de outros sistemas. Aguarde a revisão do analista antes de qualquer contato, desconto ou negociação.

Configure a ação de atualização para tratar também resultados anteriores quando uma nova análise ficar inconclusiva. Garanta que a equipe consiga distinguir uma pendência atual de uma recomendação válida antes de continuar a cobrança.

Melhore as instruções com IA

Após personalizar o texto, use Melhorar instruções. Leia a sugestão e confira se ela preserva a fórmula, as faixas e os limites de atuação. Use Testar sugestão para observar o resultado, Tentar novamente para gerar outra redação ou Descartar. Aplique com Substituir somente depois de revisar os vínculos e as regras.

Uma melhoria de redação não deve acrescentar uma cobrança automática ou mudar a forma de calcular o risco. Compare o resultado sugerido com os mesmos casos usados para validar a instrução original.

Escolha modelo, Skills e Esforço

Selecione o modelo por comportamento. Comece com uma opção adequada a leitura documental e aplicação de regras de complexidade intermediária. Compare com uma opção de maior capacidade se os testes envolverem históricos extensos ou evidências conflitantes. Avalie a qualidade do resultado, o tempo de execução e os créditos consumidos. Veja como funciona o controle de modelo e Skills por comportamento.

Ative Análise de documentos para ler os anexos e Cálculos e análises quando a pontuação exigir cálculos a partir do histórico. Mantenha Pesquisa na Web desativada para uma avaliação baseada em registros internos. Uma consulta externa exige fonte, finalidade e critérios de validação próprios.

Comece sem Esforço Máximo. Considere essa opção quando a análise exigir várias verificações encadeadas e os testes mostrarem benefício. Uma fórmula ambígua precisa ser esclarecida na política antes de aumentar a capacidade do modelo.

Teste o agente na prática

Execute o comportamento com o recurso de teste e depois pelo gatilho real em cards controlados. Confira os valores gravados e a justificativa, além da resposta exibida na tela.

• Caso regular: forneça documentos legíveis e histórico completo. Calcule a pontuação esperada com a política e compare com a saída do agente.
• Mudança de comportamento: use um histórico com aumento de atrasos. A justificativa deve identificar a mudança e recomendar a abordagem correspondente aos critérios aprovados.
• Dados divergentes: apresente documentos de clientes diferentes ou valores conflitantes. O resultado deve explicar a divergência e aguardar conferência.
• Documento ausente ou ilegível: confirme que a avaliação fica inconclusiva e que uma pontuação anterior não permanece disponível como resultado atual.
• Limite de faixa e revisão humana: teste valores próximos da mudança de grupo. O analista deve conseguir conferir o cálculo e ajustar a recomendação com justificativa antes do contato.

Se a pontuação variar sem mudança nos dados, confira a fórmula e os exemplos da política. Se o resultado não chegar ao card, revise as ações e seus destinos. Use os Logs e o Rastreamento dos Agentes de IA para investigar a execução.

Revise e coloque em operação

Confirme as permissões, a versão da política, o responsável pela revisão e o gatilho escolhido. Verifique também se uma atualização do risco pode acionar alguma automação de cobrança. Teste essa sequência com destinatários controlados antes de usar dados reais.

Acompanhe as primeiras análises e compare as recomendações com a avaliação do time. Meça o tempo entre a chegada dos dados e a estratégia revisada, a frequência de pendências e as correções feitas pelo analista. Reavalie os testes quando os critérios de risco mudarem.

Antes de avançar, confirme que você entende:

☐ Escolhi entre criar o agente, adaptar um template ou revisar um agente existente.

☐ Defini a política, os fatores, os pesos e as faixas da pontuação.

☐ Vinculei os documentos, o histórico e os campos de saída.

☐ Configurei o gatilho e conferi as automações que utilizam os resultados.

☐ Revisei a melhoria das instruções, o modelo, as Skills e o Esforço.

☐ Testei casos regulares, divergentes, incompletos e próximos dos limites de faixa.

☐ Confirmei quem revisa o resultado e autoriza a abordagem de cobrança.