Agente de IA para Relatórios de Desempenho de Benefícios

Receber dados brutos de desempenho dos programas de benefícios, validar integridade e padronizar o dataset para análises subsequentes.

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 arquivo CSV ou JSON com os dados de desempenho dos programas de benefícios 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 na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um arquivo CSV ou JSON contendo dados de desempenho dos programas de benefícios.
• Formatos Suportados: Esse agente deve ser capaz de receber arquivos nos formatos: .csv, .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON único padronizado com registros validados e normalizados, incluindo esquema e metadados de qualidade.
• Exemplo de Estrutura de Output:

   {
    "schema_version": "1.0",
    "records": [...],
    "data_quality": {"rows_in": 1000, "rows_valid": 950, "rows_invalid": 50, "issues": [...]},
    "normalization": {"currency_base": "USD", "fx_applied": false, "date_format": "ISO8601"}
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 5.000 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: 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 Cálculo e Padronização de KPIs de Benefícios (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Cálculo e Padronização de KPIs de Benefícios (RF 2).

Calcular KPIs padronizados por programa, período e segmentos organizacionais a partir dos dados validados.

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 padronizado com registros validados, incluindo schema_version, normalization e data_quality.
• 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.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com KPIs calculados por granularidade, incluindo definições de KPIs e notas de agregação.
• Exemplo de Estrutura de Output:

   {
    "kpis": [
      {"grain": "program", "keys": {...}, "period": {...}, "metrics": {...}, "data_flags": [...]}
    ],
    "kpi_definitions": {...},
    "aggregation_notes": [...]
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 6.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: 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 Análise de Coortes e Segmentação (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Análise de Coortes e Segmentação (RF 3).

Comparar desempenho entre coortes e segmentos para revelar diferenças estruturais e oportunidades direcionadas.

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 de KPIs calculados contendo kpis, kpi_definitions e aggregation_notes.
• 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é 8.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com análises de coortes, incluindo segmentos, comparações de coortes, drivers-chave e notas.
• Exemplo de Estrutura de Output:

   {
    "segments": [...],
    "cohort_comparisons": [...],
    "key_drivers": [...],
    "notes": [...]
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 4.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: 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 Detecção de Tendências e Anomalias (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 de Tendências e Anomalias (RF 4).

Avaliar evolução temporal dos KPIs e sinalizar quebras de tendência e anomalias relevantes.

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 de KPIs com granularidade mensal por programa e segmentos.
• 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é 8.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON de insights temporais, incluindo tendências, anomalias e índice de estabilidade.
• Exemplo de Estrutura de Output:

   {
    "trends": [...],
    "anomalies": [...],
    "stability_index": {...}
  } 

• 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: GPT-5
• Temperatura: 0.6

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

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 Identificação de Oportunidades de Otimização (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Identificação de Oportunidades de Otimização (RF 5).

Gerar oportunidades concretas de otimização com estimativas de impacto financeiro e de experiência do colaborador.

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 como input JSONs dos agentes anteriores: KPIs, segmentações, tendências e anomalias.
• 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 combinado de até 12.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser uma lista estruturada de oportunidades de otimização, incluindo metodologia.
• Exemplo de Estrutura de Output:

   {
    "opportunities": [
      {"id": "opt1", "program_id": "123", "tipo": "renegociação", "descricao": "Reduzir custos através de renegociação de contratos.", "alavancas": [...], "estimativa_economia": 10000, "impacto_satisfacao": "alto", "effort": "médio", "prioridade": "alta", "premissas": [...], "riscos": [...]
      }
    ],
    "metodologia": {...}
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 5.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: Não utiliza.
• 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 Montagem e Redação do Relatório de Desempenho 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 Montagem e Redação do Relatório de Desempenho de Benefícios (RF 6).

Produzir o relatório final em formato markdown, integrando resultados de KPIs, segmentações, tendências e oportunidades, com narrativa executiva e anexos técnicos.

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 como input outputs consolidados dos agentes anteriores: dados de qualidade, KPIs, análises de coortes, tendências/anomalias e oportunidades.
• 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é 15.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório em markdown e um anexo técnico em JSON.
• Exemplo de Estrutura de Output:

   {
    "relatorio": "# Relatório de Desempenho de Benefícios
  ## Sumário Executivo
  ...",
    "anexo_tecnico": {...}
  } 

• Número de caracteres esperado: O relatório final deve ter um tamanho estimado em torno de 10.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: Não utiliza.
• 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.