Agente de IA para Detecção de Fraude em Relatórios de Crédito

Receber relatórios de crédito em PDF ou texto estruturado e produzir um JSON padronizado com todas as seções relevantes para análise de fraude.

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 relatórios de crédito em formato PDF ou texto estruturado via API. Na fase de testes, os dados serão enviados manualmente por upload na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um relatório de crédito.
• Formatos Suportados: Esse agente deve ser capaz de receber relatórios nos formatos: .pdf, .txt.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 50.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON. A estrutura deve conter todas as seções relevantes do relatório de crédito, padronizadas para análise de fraude.
• Exemplo de Estrutura de Output:

   {
    "cliente_id": "string",
    "data_referencia": "AAAA-MM-DD",
    "resumo_score": { "score": 0-1000, "faixa": "string" },
    "enderecos": [ { "tipo": "atual|anterior", "cep": "string", "cidade": "string", "uf": "string", "data_inicio": "AAAA-MM-DD", "data_fim": "AAAA-MM-DD|null" } ],
    "contas": [ { "instituicao": "string", "tipo": "cartao|emprestimo|financiamento|outro", "abertura": "AAAA-MM-DD", "limite": number|null, "saldo": number|null, "situacao": "ativa|encerrada|em_atraso", "ultima_atualizacao": "AAAA-MM-DD" } ],
    "transacoes": [ { "data": "AAAA-MM-DD", "valor": number, "moeda": "BRL", "estabelecimento": "string|null", "mcc": "string|null", "cidade": "string|null", "uf": "string|null", "pais": "string|null", "canal": "presencial|online|outro", "conta_relacionada": "string|null", "status": "confirmada|contestada|chargeback" } ],
    "consultas_credito": [ { "data": "AAAA-MM-DD", "origem": "banco|varejo|telecom|outro", "instituicao": "string", "tipo": "hard|soft" } ],
    "alteracoes_cadastrais": [ { "tipo": "endereco|telefone|email|nome_mae|estado_civil|outro", "data": "AAAA-MM-DD", "valor_anterior": "string|null", "valor_novo": "string" } ],
    "limites_eventos": [ { "data": "AAAA-MM-DD", "conta_relacionada": "string", "limite_anterior": number|null, "limite_novo": number|null } ],
    "metadados_origem": { "fonte": "string", "arquivo": "string|null", "versao_relatorio": "string|null" }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e detalhado, com um tamanho estimado em torno de 5.000 caracteres.

1.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.5

1.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• 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 Detecção de Fraude e Atividades Suspeitas (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Detecção de Fraude e Atividades Suspeitas (RF 2).

Aplicar regras de negócio e sinais de risco ao JSON padronizado do relatório de crédito para identificar fraudes ou suspeitas, com evidências e classificação de severidade.

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 como input um JSON padronizado, que corresponde ao relatório de crédito processado pelo agente anterior.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (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 arquivo no formato JSON contendo a análise de fraude, com evidências e classificação de severidade.
• Exemplo de Estrutura de Output:

   {
    "cliente_id": "string",
    "fraude_detectada": true|false,
    "severidade": "alta|media|baixa|nenhuma",
    "score_risco": 0-100,
    "sinais_suspeitos": [ { "codigo": "string", "descricao": "string", "evidencias": ["string"], "peso": 1-10 } ],
    "resumo_metricas": { "qtd_transacoes": number, "qtd_consultas_hard_30d": number, "variacao_limite_30d": number, "qtd_alteracoes_cadastrais_30d": number },
    "janelas_tempo": { "inicio": "AAAA-MM-DD", "fim": "AAAA-MM-DD" }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e detalhado, com um tamanho estimado em torno de 3.000 caracteres.

2.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.5

2.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para calcular métricas e score de risco.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

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 Preparação de Alertas e Ações Corretivas (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Preparação de Alertas e Ações Corretivas (RF 3).

Gerar mensagens de alerta ao cliente e um plano de ações corretivas proporcionais à severidade e aos sinais detectados.

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 como input um JSON contendo a análise de fraude, com evidências e classificação de severidade.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 3.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON contendo as mensagens de alerta e o plano de ações corretivas.
• Exemplo de Estrutura de Output:

   {
    "cliente_id": "string",
    "fraude_detectada": true|false,
    "severidade": "alta|media|baixa|nenhuma",
    "alerta": { "titulo": "string", "mensagem_curta": "string", "detalhes": "string" },
    "acoes_corretivas": [ { "acao": "string", "prazo": "imediato|24h|7d", "instrucoes": "string" } ],
    "payload_notificacao": { "canal": "app|email|sms", "urgencia": "alta|media|baixa", "conteudo": { "assunto": "string", "corpo": "string" } }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e detalhado, com um tamanho estimado em torno de 2.500 caracteres.

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.5

3.3.4 Ferramentas do Agente

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

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 Execução de Chamada à API (RF 4).

3.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 4).

Realizar chamada à API de Notificações para enviar o alerta ao cliente utilizando o payload preparado.

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 como input um JSON contendo o payload de notificação preparado pelo agente anterior.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 2.500 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output final e único deste agente deve ser um JSON contendo a resposta da API, incluindo status_code, id_notificacao e timestamp_envio.
• Exemplo de Estrutura de Output:

   {
    "status_code": 200,
    "id_notificacao": "string",
    "timestamp_envio": "AAAA-MM-DDThh:mm:ssZ"
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em torno de 500 caracteres.

4.3.3 Parâmetros de Geração

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

4.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o JSON recebido para a API externa e retornar a resposta recebida.

4.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta (JSON da API) é 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. A resposta da API é o resultado que deve ser registrado para análise.