Agente de IA para Geração de Relatórios de Consumo de Benefícios

Definir escopo e preparar, por fonte de dados, os parâmetros completos para coleta de consumo de benefícios.

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 contexto do RH 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 contexto na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um contexto do RH, que após ser processado, resulta em parâmetros de coleta.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 15.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um pacote de parâmetros por fonte de dados em formato **JSON**.
• Exemplo de Estrutura de Output:

   {
    "fonte_id": "api_beneficios",
    "tipo_fonte": "api",
    "endpoint": "https://api.beneficios.com/v1/consumo",
    "range_datas_normalizado": {
      "inicio": "2025-12-01",
      "fim": "2025-12-31",
      "timezone": "America/Sao_Paulo"
    },
    "filtros": {
      "unidade": "São Paulo",
      "centro_custo": "RH"
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 1.500 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 documentos externos.
• Calculadora: Utiliza lógica interna para definir parâmetros de coleta.
• 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 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).

Realizar chamadas às APIs dos sistemas de benefícios para obter dados brutos de consumo conforme parâmetros preparados.

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 uma lista de payloads prontos por fonte do tipo API.
• 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é 10.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser uma lista de dados brutos recuperados por fonte_api em formato **JSON**.
• Exemplo de Estrutura de Output:

   {
    "fonte_id": "api_beneficios",
    "registros": [
      {
        "colaborador_id": "123",
        "tipo_beneficio": "vale_refeicao",
        "data_consumo": "2025-12-01",
        "quantidade": 1,
        "valor_moeda": 20.00,
        "moeda": "BRL"
      }
    ],
    "metadados_coleta": {
      "inicio": "2025-12-01",
      "fim": "2025-12-31",
      "paginacao": "page/size"
    }
  } 

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

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: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Realiza chamadas diretas às APIs dos sistemas de benefícios.

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 Execução de Consultas em Banco de Dados (RF 3).

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

Executar consultas em bancos de dados para obter dados de elegibilidade e/ou consumo complementares.

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 parâmetros prontos para execução da consulta SQL.
• 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é 8.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser uma lista de dados brutos recuperados por fonte_bd em formato **JSON**.
• Exemplo de Estrutura de Output:

   {
    "fonte_id": "bd_hris",
    "registros": [
      {
        "colaborador_id": "123",
        "tipo_beneficio": "plano_saude",
        "data_consumo": "2025-12-01",
        "quantidade": 1,
        "valor_moeda": 300.00,
        "moeda": "BRL"
      }
    ],
    "metadados_coleta": {
      "inicio": "2025-12-01",
      "fim": "2025-12-31"
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 2.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 documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Realiza consultas diretas aos bancos de dados dos sistemas de RH.

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 Consolidação e Normalização de Dados de Benefícios (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Consolidação e Normalização de Dados de Benefícios (RF 4).

Unificar, limpar, deduplicar e normalizar os dados brutos no esquema canônico de consumo de benefícios.

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 dados brutos de APIs e/ou BD, mais o mapeamento canônico e regras de inclusão/estorno.
• 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é 20.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um dataset canônico consolidado em formato **JSON**.
• Exemplo de Estrutura de Output:

   {
    "colaborador_id": "123",
    "tipo_beneficio": "plano_saude",
    "data_consumo": "2025-12-01",
    "competencia": "2025-12",
    "quantidade": 1,
    "valor_moeda": 300.00,
    "moeda": "BRL",
    "status_lancamento": "valido"
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 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 documentos externos.
• Calculadora: Utiliza lógica interna para normalização e deduplicação de dados.
• 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 Análise de Consumo de Benefícios (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Análise de Consumo de Benefícios (RF 5).

Calcular métricas e gerar insights sobre o consumo por colaborador, por tipo de benefício e por período.

5.3.1 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 o dataset canônico consolidado e parâmetros analíticos.
• 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é 12.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um pacote analítico em formato **JSON**.
• Exemplo de Estrutura de Output:

   {
    "kpis_gerais": {
      "total_valor_brl": 5000.00,
      "gasto_medio_por_colaborador": 250.00
    },
    "por_colaborador": {
      "123": {
        "total_valor_brl": 300.00,
        "beneficios": [
          {
            "tipo": "plano_saude",
            "valor": 300.00
          }
        ]
      }
    }
  } 

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

5.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

5.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para cálculo de métricas e análise de dados.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

5.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 Relatórios de Benefícios (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Relatórios de Benefícios (RF 6).

Produzir relatórios personalizados e prontos para apresentação com foco em visualização por colaborador e por tipo de benefício.

6.3.1 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 o pacote analítico estruturado, preferências de layout e metadados institucionais.
• 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é 10.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório estruturado em formato **JSON** com versão em markdown pronta para exportação.
• Exemplo de Estrutura de Output:

   {
    "capa": {
      "titulo": "Relatório de Consumo de Benefícios",
      "empresa": "Empresa XYZ",
      "periodo_referencia": "Dezembro 2025"
    },
    "kpis_gerais": {
      "total_valor_brl": 5000.00,
      "gasto_medio_por_colaborador": 250.00
    },
    "visao_por_beneficio": {
      "plano_saude": {
        "total_valor_brl": 3000.00,
        "colaboradores": 10
      }
    }
  } 

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

6.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

6.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para formatação de relatórios.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

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

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

A execução deste agente finaliza o fluxo. O relatório gerado é o resultado que deve ser disponibilizado ao usuário.