Agente de IA para Análise de Fraudes em Transações de Vale-Refeição

Padronizar e validar transações recebidas, saneando campos, normalizando formatos e enriquecendo com atributos derivados 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 dados de transações via API. Na fase de testes, os dados serão enviados para o agente diretamente por upload de um arquivo JSON na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um arquivo JSON contendo uma ou mais transações de vale-refeição.
• 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 texto com até 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com arrays de transacoes_validas e transacoes_rejeitadas, cada item contendo campos normalizados e atributos derivados ou motivos de rejeição.
• Exemplo de Estrutura de Output:

   {
    "transacoes_validas": [
      {
        "transaction_id": "123456",
        "valor_arredondado": 49.99,
        "ticket_bucket": "40–80",
        "eh_fim_de_semana": false,
        "ano_mes": "2025-12",
        "canal_presencial": true,
        "pos_manual": false
      }
    ],
    "transacoes_rejeitadas": [
      {
        "transaction_id": "654321",
        "motivos_rejeicao": [
          {
            "codigo": "VALOR_INVALIDO",
            "descricao": "Valor da transação não pode ser menor ou igual a zero."
          }
        ]
      }
    ]
  } 

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 5.000 caracteres, podendo variar conforme o número de transações processadas.

1.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

1.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para cálculos de normalização e derivação de atributos.
• 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 Sinalização de Risco por Regras Determinísticas (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Sinalização de Risco por Regras Determinísticas (RF 2).

Aplicar regras de negócio específicas de vale-refeição para identificar fraude evidente e gerar flags e escore de risco por regra.

2.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 1).
• Tipo do input: Este agente deve ser apto a receber como input um JSON de transacoes_validas do agente anterior, com atributos derivados e contexto opcional.
• 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 texto com até 50.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo flags de risco e escore por regra para cada transação.
• Exemplo de Estrutura de Output:

   [
    {
      "transaction_id": "123456",
      "flags": [
        {
          "codigo": "VALOR_ACIMA_LIMITE",
          "severidade": "Média",
          "descricao": "Transação acima do limite permitido de 80 BRL.",
          "evidencias": {
            "valor": 100,
            "limite": 80
          }
        }
      ],
      "score_regras": 20
    }
  ] 

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 5.000 caracteres, podendo variar conforme o número de transações processadas e flags geradas.

2.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

2.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para cálculo de escore 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 Agregação Temporal e Desvio de Padrão (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Agregação Temporal e Desvio de Padrão (RF 3).

Comparar a transação atual com o comportamento histórico resumido para detectar desvios abruptos e padrões repetitivos suspeitos.

3.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 2).
• Tipo do input: Este agente deve ser apto a receber como input transações com flags/score do agente anterior e um historico_compacto opcional.
• 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 texto com até 50.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo novas flags de risco e escore temporal para cada transação.
• Exemplo de Estrutura de Output:

   [
    {
      "transaction_id": "123456",
      "analysis_temporal": {
        "novas_flags": [
          {
            "codigo": "VALOR_FORA_PADRAO_3SIGMA",
            "severidade": "Média",
            "descricao": "Valor da transação fora do padrão normal para o usuário.",
            "evidencias": {
              "valor": 150,
              "media_ticket_30d": 50,
              "desvio_ticket_30d": 30
            }
          }
        ],
        "score_temporal": 20
      }
    }
  ] 

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 5.000 caracteres, podendo variar conforme o número de transações processadas e flags geradas.

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

3.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para cálculo de escore temporal e comparações históricas.
• 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 Decisão e Geração de Alerta (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Decisão e Geração de Alerta (RF 4).

Consolidar flags e scores, decidir ação operacional e estruturar o alerta a responsáveis de fraude.

4.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 3).
• Tipo do input: Este agente deve ser apto a receber como input transação enriquecida com flags e scores anteriores e políticas de decisão opcionais.
• 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 texto com até 50.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo decisão por transação e estrutura de alerta.
• Exemplo de Estrutura de Output:

   {
    "transaction_id": "123456",
    "score_total": 85,
    "severidade": "P1",
    "acao": "revisar",
    "recomendacao_operacional": "Revisar transação por suspeita de fraude.",
    "alerta": {
      "titulo": "Alerta de Fraude - Merchant XYZ",
      "mensagem": "Transação suspeita identificada para revisão imediata.",
      "evidencias_chave": {
        "valor": 150,
        "limite": 80,
        "mcc": "5812",
        "horario": "23:45",
        "contagem_30min": 4,
        "distancia_km": 30
      },
      "sla_minutos": 15,
      "canais_sugeridos": ["webhook", "fila"],
      "dados_minimos": {
        "transaction_id": "123456",
        "card_id": "****5678",
        "user_id": "****1234",
        "merchant_id": "987654",
        "valor": 150,
        "data_hora_local": "2025-12-21T23:45:00"
      },
      "campos_sensiveis_mascarados": {
        "user_id": "****1234",
        "card_id": "****5678"
      }
    }
  } 

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 5.000 caracteres, podendo variar conforme o número de transações processadas e flags geradas.

4.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

4.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para consolidação de scores e decisão operacional.
• Busca Online: Não utiliza.
• Sistemas Externos: O envio externo do alerta pode ser configurado na orquestração do fluxo como etapa de saída (ex.: webhook do sistema antifraude). Por se tratar de envio final do output, não é necessário um agente dedicado de execução de API.

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 (decisão e alerta) é 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. O alerta gerado é o resultado que deve ser disponibilizado ao usuário.