Agente de IA para Enriquecimento de Dados de Benefícios

Este documento define todos os prompts, configurações de memória, transição entre estados e ferramentas necessárias para o Fluxo de Agentes "Enriquecimento de Dados de Benefícios", uma solução de automação projetada para integrar dados de consumo de benefícios com outras fontes de dados da empresa e enriquecer os relatórios entregues ao RH. 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 é enriquecer relatórios de benefícios com informações adicionais, fornecendo insights mais completos para o RH, através de uma integração segura e eficiente de dados.

Cenário Atual

Atualmente, a equipe de RH enfrenta dificuldades para integrar dados de consumo de benefícios com outras bases de dados da empresa. Isso resulta em relatórios incompletos que não oferecem uma visão abrangente dos benefícios utilizados pelos colaboradores.

• Necessidade de enriquecer relatórios de benefícios com dados de outras fontes da empresa.
• Dificuldade em integrar dados de consumo de benefícios com outras bases de dados.

Problemas Identificados

• Integração de Dados: A falta de integração entre diferentes fontes de dados impede a geração de relatórios completos e precisos.
• Informações Incompletas: Os relatórios atuais não conseguem capturar todas as informações relevantes sobre os benefícios, limitando a capacidade de análise do RH.
• Eficiência: O processo manual de coleta e integração de dados é demorado e sujeito a erros.

A implementação deste fluxo de automação visa alcançar os seguintes resultados:

• Melhoria na qualidade dos relatórios de benefícios, com dados mais completos e integrados.
• Aumento da eficiência na geração de relatórios, reduzindo o tempo e o esforço manual.
• Insights mais precisos para a tomada de decisão do RH.

O agente de IA para enriquecimento de dados de benefícios integra dados de consumo de benefícios com outras fontes de dados da empresa, aplicando regras de segurança e eficiência para enriquecer os relatórios entregues ao RH. 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 processo de enriquecimento de dados.

A solução consiste em um fluxo de automação composto por 12 agentes de IA. O processo inicia com a validação e padronização dos dados de consumo de benefícios e termina com a geração de um relatório enriquecido para o RH.

A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo.

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.

RF 1. Agente de Validação e Padronização do Dataset de Consumo de Benefícios

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um arquivo CSV contendo dados de consumo de benefícios, com colunas variáveis por fornecedor. Opcionalmente, um objeto JSON com metadados também pode ser fornecido.

# 2. Objetivo
Validar, higienizar e padronizar o arquivo de consumo de benefícios para um esquema canônico de integração.

# 3. Regras que você deve seguir para gerar sua resposta
- Detecte o delimitador mais apropriado e a codificação do arquivo.
- Mapeie colunas para o esquema canônico utilizando vocabulário e sinônimos.
- Higienize identificadores e normalize tipos de dados e datas.
- Classifique tipos de benefícios e calcule campos conforme necessário.
- Defina flags para indicar a inclusão de fontes externas de dados.
- Preencha indicadores de qualidade dos dados.
- Minimize e remova dados desnecessários para segurança.

# 4. Exemplo de Output que você deve produzir
{
  "schema_canonico": {"chave_colaborador":"string","cpf":"string","matricula":"string","nome":"string","centro_custo_codigo":"string","unidade":"string","beneficio_tipo":"string","beneficio_subtipo":"string","quantidade":"number","valor_unitario":"number","valor_total":"number","data_consumo":"YYYY-MM-DD"},
  "linhas": [
    {"chave_colaborador":"12345","cpf":"00000000000","matricula":"A123","nome":"Fulano","centro_custo_codigo":"CC101","unidade":"SP","beneficio_tipo":"Alimentação","beneficio_subtipo":"Cartão","quantidade":20,"valor_unitario":25.5,"valor_total":510.0,"data_consumo":"2025-10-31"} ],
  "flags": {"incluir_hris": true, "incluir_folha": true, "incluir_tabela_cc": true},
  "chaves_preferenciais_join": ["cpf","matricula"],
  "qualidade_dados": {"percentual_cpf_valido": 0.98, "linhas_descartadas": 12, "motivos_descarte": ["cpf_invalido","valor_negativo"]}
}