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

Construir os parâmetros padronizados para recuperar o score atual via API externa e o histórico/consentimentos via banco de dados, garantindo normalização de IDs e thresholds de alerta.

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 um JSON com lista de clientes e preferências via API. Na fase de testes, o fluxo será iniciado pelo envio manual dos dados, que serão enviados para o agente diretamente por upload do JSON na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um JSON com lista de clientes e preferências.
• 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 de até 10.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com parâmetros prontos, contendo os blocos api_payload_credit_bureau, db_query_params e regras.
• Exemplo de Estrutura de Output:

   {
    "api_payload_credit_bureau": {"cliente_ids": ["string"], "escopos": ["score_atual"], "correlacao_execucao_id": "uuid"},
    "db_query_params": {"tabelas": ["historico_scores", "consentimentos", "historico_alertas"], "filtros": {"cliente_ids": ["string"]}},
    "regras": {"limiares": {...}, "cooldown_horas": number, "faixas_risco": [...]} } 

• 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: Não se aplica (processo de preparação de parâmetros)
• Temperatura: Não se aplica

1.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

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 Consultas em Banco de Dados (RF 2) e o Agente de Execução de Chamada à API (Bureau de Crédito) (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Execução de Consultas em Banco de Dados (RF 2) e o Agente de Execução de Chamada à API (Bureau de Crédito) (RF 3) em paralelo.

Realizar conexão com o banco de dados operacional para obter histórico de scores, consentimentos e histórico recente de alertas dos clientes.

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 um JSON com parâmetros prontos para consulta ao banco de dados.
• 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 de até 5.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com dados recuperados, contendo histórico de scores, consentimentos e histórico recente de alertas.
• Exemplo de Estrutura de Output:

   {
    "historico_scores": [{"cliente_id": "string", "score_anterior": number, "data_score_anterior": "ISO-8601"}],
    "consentimentos": [{"cliente_id": "string", "consentimento_monitoramento": true, "expira_em": "ISO-8601"}],
    "historico_alertas": [{"cliente_id": "string", "ultimo_alerta_em": "ISO-8601", "severidade": "leve|significativa|critica"}],
    "correlacao_execucao_id": "uuid" } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 3.000 caracteres.

2.3.3 Parâmetros de Geração

• Modelo: Não se aplica (execução de consulta)
• Temperatura: Não se aplica

2.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: A consulta deve ser configurada no conector de banco de dados da plataforma. Este agente apenas executa com os parâmetros recebidos.

2.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 Detecção e Classificação de Alterações de Score (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Detecção e Classificação de Alterações de Score (RF 4).

Realizar chamada à API do bureau de crédito para obter o score atual dos clientes.

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 1).
• Tipo do input: Este agente deve ser apto a receber um JSON com payload pronto para chamada à API do bureau 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 de até 5.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com dados recuperados, contendo o score atual dos clientes.
• Exemplo de Estrutura de Output:

   {
    "scores_atuais": [{"cliente_id": "string", "score_atual": number, "data_score_atual": "ISO-8601"}],
    "correlacao_execucao_id": "uuid" } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 2.000 caracteres.

3.3.3 Parâmetros de Geração

• Modelo: Não se aplica (execução de chamada à API)
• Temperatura: Não se aplica

3.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: A integração e autenticação com o bureau de crédito devem ser configuradas externamente. Este agente apenas executa a chamada com o payload recebido.

3.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 Detecção e Classificação de Alterações de Score (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Detecção e Classificação de Alterações de Score (RF 4).

Comparar score atual com histórico e classificar a alteração por severidade, aplicando limiares, faixas de risco, supressão de ruído e verificação de consentimento.

4.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão dos agentes anteriores (RF 2 e RF 3).
• Tipo do input: Este agente deve ser apto a receber um JSON consolidado com scores atuais, histórico de scores, consentimentos e histórico de alertas.
• 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 de até 10.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo as detecções e classificações de alterações de score.
• Exemplo de Estrutura de Output:

   {
    "deteccoes": [{
      "cliente_id": "string",
      "score_anterior": number|null,
      "data_score_anterior": "ISO-8601"|null,
      "score_atual": number,
      "data_score_atual": "ISO-8601",
      "delta_abs": number,
      "delta_rel": number|null,
      "faixa_anterior": "string"|null,
      "faixa_atual": "string",
      "cruzou_faixa": true|false,
      "severidade": "sem_alteracao|leve|significativa|critica",
      "motivo_classificacao": "string",
      "consentimento_valido": true|false,
      "motivo_bloqueio": "string"|null,
      "em_cooldown": true|false,
      "gerar_alerta": true|false
    }],
    "correlacao_execucao_id": "uuid" } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 4.000 caracteres.

4.3.3 Parâmetros de Geração

• Modelo: Não se aplica (classificação e detecção de alterações)
• Temperatura: Não se aplica

4.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para cálculos de deltas e classificações.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

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 deve ser visível para o Agente de Geração de Alerta Estruturado (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Alerta Estruturado (RF 5).

Transformar detecções em alertas operacionais padronizados para envio às instituições financeiras, com conteúdo mínimo necessário e mascaramento de dados.

5.3.1 Condições de Ativação

Este agente é acionado apenas se existirem detecções com gerar_alerta=true.

5.3.2 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 4).
• Tipo do input: Este agente deve ser apto a receber um JSON com detecções e classificações de alterações de score.
• 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 de até 5.000 caracteres.

5.3.3 Especificação do Output

• Formato de output: O output deve ser um JSON contendo alertas estruturados prontos para envio às instituições financeiras.
• Exemplo de Estrutura de Output:

   {
    "alertas": [{
      "alerta_id": "uuid",
      "cliente_id": "string",
      "tipo_alerta": "alteracao_leve|alteracao_significativa|critica",
      "prioridade": "baixa|media|alta",
      "titulo": "string",
      "descricao": "string",
      "metadados": {
        "delta_abs": number,
        "delta_rel": number|null,
        "cruzou_faixa": boolean,
        "faixa_anterior": "string"|null,
        "faixa_atual": "string"
      },
      "idempotency_key": "string"
    }],
    "correlacao_execucao_id": "uuid" } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 3.000 caracteres.

5.3.4 Parâmetros de Geração

• Modelo: Não se aplica (geração de alertas estruturados)
• Temperatura: Não se aplica

5.3.5 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

5.3.6 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 Envio de Alerta à API (RF 6).

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

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

Enviar os alertas estruturados ao sistema da instituição financeira configurada.

6.3.1 Condições de Ativação

Este agente é acionado apenas se existirem alertas para envio.

6.3.2 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 5).
• Tipo do input: Este agente deve ser apto a receber um JSON contendo alertas estruturados prontos para envio.
• 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 de até 5.000 caracteres.

6.3.3 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o resultado do envio dos alertas para o sistema da instituição financeira.
• Exemplo de Estrutura de Output:

   {
    "status_envio": "sucesso|parcial|falha",
    "detalhes": [{
      "alerta_id": "uuid",
      "status": "201|200|409|400|500",
      "mensagem": "string"
    }],
    "correlacao_execucao_id": "uuid" } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 2.000 caracteres.

6.3.4 Parâmetros de Geração

• Modelo: Não se aplica (execução de envio de alertas)
• Temperatura: Não se aplica

6.3.5 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Este envio deve ser configurado manualmente na interface do fluxo na plataforma, no item de integração/saída.

6.3.6 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 Persistência em Banco de Dados (RF 7).

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

Ao concluir sua execução, esse agente aciona o Agente de Execução de Persistência em Banco de Dados (RF 7).

Persistir snapshot do score atual e registrar o alerta disparado para suportar rebalanceamento de histórico e aplicação de cooldown.

7.3.1 Condições de Ativação

Este agente é acionado apenas para finalizar o ciclo de monitoramento.

7.3.2 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 6).
• Tipo do input: Este agente deve ser apto a receber um JSON com scores atuais e alertas enviados.
• 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 de até 5.000 caracteres.

7.3.3 Especificação do Output

• Formato de output: O output deve ser um JSON confirmando a persistência dos dados no banco de dados.
• Exemplo de Estrutura de Output:

   {
    "gravacoes": {
      "historico_scores": number,
      "historico_alertas": number
    },
    "correlacao_execucao_id": "uuid" } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 1.000 caracteres.

7.3.4 Parâmetros de Geração

• Modelo: Não se aplica (execução de persistência)
• Temperatura: Não se aplica

7.3.5 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: A persistência é realizada via conector de banco configurado externamente; este agente executa com os dados fornecidos.

7.3.6 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.

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

A execução deste agente finaliza o fluxo. A confirmação de persistência é o resultado que deve ser disponibilizado ao usuário.