Agente de IA para Monitoramento de Alterações de Crédito

28 de November de 2025 • Tempo de leitura: 5 min

Como criar um agente de IA que monitora alterações nos dados de crédito dos consumidores e notifica as partes interessadas.

Biblioteca de Prompts e Agentes

1. Propósito e Escopo

Este documento define todos os prompts, configurações de memória, transição entre estados e demais requisitos funcionais para o Agente de IA para Monitoramento de Alterações de Crédito, uma solução projetada para monitorar alterações nos dados de crédito dos consumidores e notificar as partes interessadas. Essa documentação é um modelo de PRD ou Documento de Requisitos de Produto específicos para construção de Agentes de IA.

O objetivo principal é garantir que as alterações nos dados de crédito sejam monitoradas continuamente e comunicadas de forma eficaz e precisa às partes interessadas.

2. Contexto e Problema

O monitoramento de crédito é uma necessidade crítica para consumidores e instituições financeiras. Alterações nos dados de crédito podem indicar mudanças na saúde financeira de um consumidor, potencialmente afetando decisões de crédito e risco. Atualmente, as partes interessadas enfrentam desafios significativos:

  • Necessidade de monitoramento contínuo das alterações nos dados de crédito dos consumidores.
  • Comunicação eficaz das mudanças para as partes interessadas.

Essas questões exigem soluções automatizadas que possam operar em tempo real, garantindo que as notificações sejam precisas e atualizadas.

3. Impactos Esperados

A implementação deste agente de IA visa alcançar os seguintes resultados:

  • Monitoramento Contínuo: Assegurar que todas as alterações nos dados de crédito sejam capturadas em tempo real.
  • Notificações Precisas: Garantir que as partes interessadas sejam informadas de maneira eficaz e precisa sobre as mudanças detectadas.
  • Redução de Riscos: Minimizar o risco associado a decisões de crédito baseadas em dados desatualizados.

4. Visão Geral da Solução

O agente de IA para monitoramento de alterações de crédito processa dados de crédito dos consumidores, identifica alterações significativas e notifica as partes interessadas de forma automatizada. A seguir são detalhadas todas as regras de negócio e especificações funcionais necessárias para que esse agente atue como um assistente útil e autônomo no monitoramento de crédito.

A solução é composta por um fluxo de automação com múltiplos agentes de IA. O processo começa com a preparação de consultas de alterações de crédito e culmina na geração de notificações para os stakeholders.

Agentes Função Principal
Agente Preparador de Consulta de Alterações de Crédito (RF 1) Preparar payloads padronizados para consultar alterações nos dados de crédito.
Agente de Execução de Chamada à API (RF 2) Executar chamadas às APIs dos fornecedores de crédito com os payloads preparados.
Agente de Normalização e Detecção de Mudanças de Crédito (RF 3) Unificar formatos de resposta de múltiplos fornecedores e detectar alterações relevantes.
Agente Preparador de Notificações de Alterações de Crédito (RF 4) Gerar mensagens claras e acionáveis para cada stakeholder com base nos eventos consolidados.

5. Protótipos

Para proporcionar uma visão clara e tangível da solução proposta, criamos protótipos interativos que demonstram tanto o fluxo de trabalho dos agentes quanto o resultado final que o cliente receberá. Explore os links abaixo para entender melhor a solução em ação.

Ver Agente na Prototipe AI

6. Requisitos Funcionais

RF 1. Agente Preparador de Consulta de Alterações de Crédito

1.1 Tarefa do Agente

Preparar payloads padronizados por fornecedor/bureau de crédito para consultar alterações desde o último snapshot conhecido, garantindo escopo mínimo necessário, idempotência e aderência a limites operacionais.

1.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados sobre consumidores e fornecedores de crédito. Seu objetivo é preparar consultas padronizadas para monitoramento de alterações de crédito.

# 2. Objetivo
Preparar payloads padronizados para consultar alterações desde o último snapshot conhecido, garantindo escopo mínimo necessário, idempotência e aderência a limites operacionais.

# 3. Regras que você deve seguir para gerar sua resposta
- Valide entradas fora do padrão e ajuste conforme necessário.
- Defina a janela temporal para consultas baseando-se no último snapshot conhecido.
- Prepare consultas que respeitem limites de CPFs por request e padronize nomes de fornecedores e endpoints.
- Gere correlation_id único por request para garantir idempotência.

# 4. Exemplo de Output que você deve produzir
{"requests": [{"fornecedor": "serasa", "endpoint": "/credit/changes", "params": {"cpfs": ["00000000000", "11111111111"], "fields": ["score", "novas_contas", "inadimplencia", "consultas_duras", "enderecos", "alertas_fraude"], "updated_after": "2025-11-27T00:00:00Z", "updated_before": "2025-11-28T14:55:00Z", "page_size": 200}, "correlation_id": "uuid-1"}], "janela_consulta": {"updated_after": "2025-11-27T00:00:00Z", "updated_before": "2025-11-28T14:55:00Z"}, "metadados_preparacao": {"cpfs_total": 2, "fornecedores_total": 1, "batches_total": 1}}
1.3 Configurações do Agente

1.3.1 Especificação do Input

  • Mecanismo de Acionamento: Este agente é o ponto de partida do fluxo e deve ser acionado pelo envio de dados sobre consumidores e fornecedores de crédito via API. Na fase de testes, os dados serão enviados diretamente por upload na interface da Prototipe AI, para acelerar o processo de validação.
  • Tipo do input: O input inicial para o fluxo é um JSON contendo dados de consumidores e fornecedores.
  • Formatos Suportados: Esse agente deve ser capaz de receber dados no formato: .json.
  • Número de caracteres esperado: Este agente deve ter capacidade para processar um input com até 10.000 caracteres.

1.3.2 Especificação do Output

  • Formato de output: O output deve ser um JSON contendo os payloads padronizados para consultas de alterações de crédito.
  • Exemplo de Estrutura de Output: 
     {"requests": [{"fornecedor": "serasa", "endpoint": "/credit/changes", "params": {"cpfs": ["00000000000", "11111111111"], "fields": ["score", "novas_contas", "inadimplencia", "consultas_duras", "enderecos", "alertas_fraude"], "updated_after": "2025-11-27T00:00:00Z", "updated_before": "2025-11-28T14:55:00Z", "page_size": 200}, "correlation_id": "uuid-1"}], "janela_consulta": {"updated_after": "2025-11-27T00:00:00Z", "updated_before": "2025-11-28T14:55:00Z"}, "metadados_preparacao": {"cpfs_total": 2, "fornecedores_total": 1, "batches_total": 1}}
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 2.000 caracteres.

1.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.6

1.3.4 Ferramentas do Agente

  • Documentos: Não consulta.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não utiliza.

1.3.5 Memória

  • Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente subsequente.
  • Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Execução de Chamada à API (RF 2).

1.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Execução de Chamada à API (RF 2).

RF 2. Agente de Execução de Chamada à API

2.1 Tarefa do Agente

Executar chamadas às APIs dos fornecedores de crédito com os payloads preparados, retornando respostas brutas completas, paginadas quando aplicável.

2.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo payloads padronizados para consulta de alterações de crédito. Sua tarefa é executá-las nas APIs dos fornecedores e retornar as respostas.

# 2. Objetivo
Executar chamadas às APIs dos fornecedores de crédito com os payloads preparados, retornando respostas brutas completas, paginadas quando aplicável.

# 3. Regras que você deve seguir para gerar sua resposta
- Execute as chamadas às APIs com o payload recebido.
- Retorne os dados brutos, incluindo paginação quando aplicável.

# 4. Exemplo de Output que você deve produzir
{"responses": [{"fornecedor": "serasa", "correlation_id": "uuid-1", "status_code": 200, "body": {"results": [{"cpf": "00000000000", "field": "score", "old": 650, "new": 620, "updated_at": "2025-11-28T12:03:00Z", "id_evento": "evt_123"}], "next_cursor": null}, "headers": {}}]}
2.3 Configurações do Agente

2.3.1 Especificação do Input

  • Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 1).
  • Tipo do input: Este agente deve ser apto a receber JSON contendo os payloads padronizados para consulta de alterações de crédito.
  • Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
  • Número de caracteres esperado: Este agente deve ter capacidade para processar um input com até 10.000 caracteres.

2.3.2 Especificação do Output

  • Formato de output: O output deve ser um JSON contendo as respostas brutas das APIs dos fornecedores de crédito.
  • Exemplo de Estrutura de Output: 
     {"responses": [{"fornecedor": "serasa", "correlation_id": "uuid-1", "status_code": 200, "body": {"results": [{"cpf": "00000000000", "field": "score", "old": 650, "new": 620, "updated_at": "2025-11-28T12:03:00Z", "id_evento": "evt_123"}], "next_cursor": null}, "headers": {}}]}
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 5.000 caracteres.

2.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: Não se aplica (uso de ferramenta)

2.3.4 Ferramentas do Agente

  • Documentos: Não consulta.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: O agente deverá enviar os payloads recebidos para as APIs externas dos fornecedores de crédito e retornar as respostas.

2.3.5 Memória

2.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Normalização e Detecção de Mudanças de Crédito (RF 3).

RF 3. Agente de Normalização e Detecção de Mudanças de Crédito

3.1 Tarefa do Agente

Unificar formatos de resposta de múltiplos fornecedores, comparar com o snapshot anterior e detectar, classificar e consolidar alterações relevantes para decisão de notificação.

3.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo respostas de múltiplos fornecedores de crédito. Sua tarefa é unificar esses dados e detectar alterações relevantes.

# 2. Objetivo
Unificar formatos de resposta de múltiplos fornecedores, comparar com o snapshot anterior e detectar, classificar e consolidar alterações relevantes para decisão de notificação.

# 3. Regras que você deve seguir para gerar sua resposta
- Transforme cada resultado em um formato unificado.
- Compare com o snapshot anterior para detectar mudanças significativas.
- Classifique a severidade das alterações e determine se são notificáveis.

# 4. Exemplo de Output que você deve produzir
{"changes": [{"cpf": "00000000000", "campo": "score", "valor_anterior": 650, "valor_novo": 620, "delta": -30, "fonte": "serasa", "timestamp_evento": "2025-11-28T12:03:00Z", "severidade": "grave", "precisa_notificar": true, "motivos": ["queda_de_score_acima_limiar"], "confiabilidade": 0.92, "id_evento_origem": "evt_123"}], "resumo": {"total_analisados": 1, "total_notificaveis": 1, "janela_avaliada": {"from": "2025-11-27T00:00:00Z", "to": "2025-11-28T14:55:00Z"}}}
3.3 Configurações do Agente

3.3.1 Especificação do Input

  • Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 2).
  • Tipo do input: Este agente deve ser apto a receber JSON contendo as respostas brutas das APIs dos fornecedores de crédito.
  • Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
  • Número de caracteres esperado: Este agente deve ter capacidade para processar um input com até 10.000 caracteres.

3.3.2 Especificação do Output

  • Formato de output: O output deve ser um JSON contendo as alterações detectadas e classificadas.
  • Exemplo de Estrutura de Output: 
     {"changes": [{"cpf": "00000000000", "campo": "score", "valor_anterior": 650, "valor_novo": 620, "delta": -30, "fonte": "serasa", "timestamp_evento": "2025-11-28T12:03:00Z", "severidade": "grave", "precisa_notificar": true, "motivos": ["queda_de_score_acima_limiar"], "confiabilidade": 0.92, "id_evento_origem": "evt_123"}], "resumo": {"total_analisados": 1, "total_notificaveis": 1, "janela_avaliada": {"from": "2025-11-27T00:00:00Z", "to": "2025-11-28T14:55:00Z"}}}
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 4.000 caracteres.

3.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.6

3.3.4 Ferramentas do Agente

  • Documentos: Não consulta.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não utiliza.

3.3.5 Memória

3.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente Preparador de Notificações de Alterações de Crédito (RF 4).

RF 4. Agente Preparador de Notificações de Alterações de Crédito

4.1 Tarefa do Agente

Gerar mensagens claras, precisas e acionáveis para cada stakeholder com base nos eventos consolidados, aplicando políticas de silêncio, priorização e adequação por canal.

4.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo eventos consolidados de alterações de crédito. Sua tarefa é preparar notificações para os stakeholders relevantes.

# 2. Objetivo
Gerar mensagens claras, precisas e acionáveis para cada stakeholder com base nos eventos consolidados, aplicando políticas de silêncio, priorização e adequação por canal.

# 3. Regras que você deve seguir para gerar sua resposta
- Selecione stakeholders elegíveis para notificação com base nas políticas definidas.
- Prepare mensagens que incluam detalhes das alterações, severidade e ações recomendadas.
- Respeite as políticas de privacidade e formato por canal de comunicação.

# 4. Exemplo de Output que você deve produzir
{"mensagens": [{"to": {"id": "cheila_portela", "canal": "email"}, "prioridade": "alta", "assunto": "Alerta: Queda de score e nova conta", "corpo": "Detectamos alterações em 28/11/2025 12:03 UTC: score -30 (650→620) e abertura de conta no Banco X. Severidade: grave. Fonte: Serasa.", "metadata": {"cpf": "00000000000", "severidade": "grave", "timestamp_evento": "2025-11-28T12:03:00Z", "correlation_id": "uuid-notif-1"}}], "resumo_batch": {"total_mensagens": 1, "stakeholders_alcancados": 1}}
4.3 Configurações do Agente

4.3.1 Especificação do Input

  • Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 3).
  • Tipo do input: Este agente deve ser apto a receber JSON contendo as alterações detectadas e classificadas.
  • Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
  • Número de caracteres esperado: Este agente deve ter capacidade para processar um input com até 10.000 caracteres.

4.3.2 Especificação do Output

  • Formato de output: O output deve ser um JSON contendo as mensagens preparadas para envio aos stakeholders.
  • Exemplo de Estrutura de Output: 
     {"mensagens": [{"to": {"id": "cheila_portela", "canal": "email"}, "prioridade": "alta", "assunto": "Alerta: Queda de score e nova conta", "corpo": "Detectamos alterações em 28/11/2025 12:03 UTC: score -30 (650→620) e abertura de conta no Banco X. Severidade: grave. Fonte: Serasa.", "metadata": {"cpf": "00000000000", "severidade": "grave", "timestamp_evento": "2025-11-28T12:03:00Z", "correlation_id": "uuid-notif-1"}}], "resumo_batch": {"total_mensagens": 1, "stakeholders_alcancados": 1}}
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 3.000 caracteres.

4.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.6

4.3.4 Ferramentas do Agente

  • Documentos: Não consulta.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não utiliza.

4.3.5 Memória

  • Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente subsequente.
  • Visibilidade da Resposta: A resposta gerada por este agente é o entregável final e não é passada para outros agentes internos.

4.3.6 Regras de Orquestração e Transição

A execução deste agente finaliza o fluxo. As mensagens geradas são o resultado que deve ser disponibilizado ao usuário.

Posts Relacionados

© 2025 prototipe.ai. Todos os direitos reservados.