Agente de IA para Análise de Utilização de Vale-Saúde

Validar, padronizar e preparar o dataset de utilização de vales-saúde 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 ou objeto tabular 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 ou objeto tabular.
• Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .csv, .xlsx.
• 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 objeto JSON contendo: dataset_padronizado (linhas válidas, tipos coerentes), linhas_descartadas (motivo, contagem e amostras), periodo_referencia (data_min, data_max), parametros_aplicados (timezone, moeda, normalizações), sumario_qualidade (n_registros, % nulos por campo, duplicados removidos).
• Exemplo de Estrutura de Output:

   {
    "dataset_padronizado": "linhas válidas, tipos coerentes",
    "linhas_descartadas": "motivo, contagem e amostras",
    "periodo_referencia": "data_min, data_max",
    "parametros_aplicados": "timezone, moeda, normalizações",
    "sumario_qualidade": "n_registros, % nulos por campo, duplicados removidos"
  } 

• 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-4
• Temperatura: 0.5

1.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para validação de dados.
• 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 de Métricas e KPIs (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 de Métricas e KPIs (RF 2).

Calcular KPIs e distribuições essenciais de utilização dos vales-saúde.

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 objeto JSON contendo o dataset_padronizado e o periodo_referencia do 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é 10.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON "kpis" contendo: totais (gasto_total, transacoes_total), usuarios (usuarios_unicos, usuarios_ativos_mensal, taxa_adesao se houver base_usuarios), uso (ticket_medio, gasto_medio_por_usuario, frequencia_media_mensal), distribuicoes (por_categoria, por_dia_da_semana, por_hora, por_mes), percentis (p50, p75, p90, p95, p99 de valor_utilizado e gasto_mensal_por_usuario), concentracao (top_10_usuarios_%_gasto, indice_gini_aproximado), cobertura_limite (se limites fornecidos).
• Exemplo de Estrutura de Output:

   {
    "kpis": {
      "totais": "gasto_total, transacoes_total",
      "usuarios": "usuarios_unicos, usuarios_ativos_mensal, taxa_adesao",
      "uso": "ticket_medio, gasto_medio_por_usuario, frequencia_media_mensal",
      "distribuicoes": "por_categoria, por_dia_da_semana, por_hora, por_mes",
      "percentis": "p50, p75, p90, p95, p99",
      "concentracao": "top_10_usuarios_%_gasto, indice_gini_aproximado",
      "cobertura_limite": "%, %"
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 3.000 caracteres.

2.3.3 Parâmetros de Geração

• Modelo: GPT-4
• Temperatura: 0.5

2.3.4 Ferramentas do Agente

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

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

Ao concluir sua execução, esse agente aciona o Agente de Detecção de Padrões e Anomalias (RF 3).

Detectar padrões relevantes e anomalias que possam indicar uso atípico, abuso ou mudanças abruptas.

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 o dataset_padronizado e os kpis gerados 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é 10.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON "anomalias_e_padroes" com listas: anomalias_transacoes (usuario, data, valor, motivo, limiar), anomalias_agregadas (periodo, categoria, metrica, variacao, base_minima, limiar), padroes_relevantes (sazonalidades, horários de pico, categorias em ascensão/queda).
• Exemplo de Estrutura de Output:

   {
    "anomalias_e_padroes": {
      "anomalias_transacoes": "usuario, data, valor, motivo, limiar",
      "anomalias_agregadas": "periodo, categoria, metrica, variacao, base_minima, limiar",
      "padroes_relevantes": "sazonalidades, horários de pico, categorias em ascensão/queda"
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 3.000 caracteres.

3.3.3 Parâmetros de Geração

• Modelo: GPT-4
• Temperatura: 0.5

3.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para detecção de padrões e anomalias.
• 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 Segmentação de Usuários por Padrão de Uso (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Segmentação de Usuários por Padrão de Uso (RF 4).

Segmentar usuários em grupos operacionais para gestão de benefícios e comunicação.

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 o dataset_padronizado e os kpis gerados 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é 10.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON "segmentos" com definições, critérios e contagens: heavy_users, moderados, leves, novos, inativos, por_categoria_dominante, sensiveis_a_horario; para cada segmento, lista de critérios e métricas (gasto_mensal_medio, frequencia, ticket_medio).
• Exemplo de Estrutura de Output:

   {
    "segmentos": {
      "heavy_users": "definições, critérios e contagens",
      "moderados": "definições, critérios e contagens",
      "leves": "definições, critérios e contagens",
      "novos": "definições, critérios e contagens",
      "inativos": "definições, critérios e contagens",
      "por_categoria_dominante": "definições, critérios e contagens",
      "sensiveis_a_horario": "definições, critérios e contagens"
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 3.000 caracteres.

4.3.3 Parâmetros de Geração

• Modelo: GPT-4
• Temperatura: 0.5

4.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para segmentação de usuários.
• 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 Recomendações para Otimização 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 Recomendações para Otimização de Benefícios (RF 5).

Gerar recomendações acionáveis para otimização de custos e melhoria de acesso/uso do benefício.

5.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 4).
• Tipo do input: Este agente deve ser apto a receber como input os kpis, anomalias_e_padroes e segmentos gerados 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é 10.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON "recomendacoes" com lista priorizada: recomendacao, objetivo, segmento_alvo/dimensao, regra_acionadora, impacto_estimado (economia% ou melhora adesao%), custo_complexidade (baixa/média/alta), KPIs_afetados, prazo_sugerido.
• Exemplo de Estrutura de Output:

   {
    "recomendacoes": {
      "recomendacao": "objetivo, segmento_alvo/dimensao, regra_acionadora",
      "impacto_estimado": "economia% ou melhora adesao%",
      "custo_complexidade": "baixa/média/alta",
      "KPIs_afetados": "KPIs_afetados",
      "prazo_sugerido": "prazo_sugerido"
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 3.000 caracteres.

5.3.3 Parâmetros de Geração

• Modelo: GPT-4
• Temperatura: 0.5

5.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para geração de recomendações.
• 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ório Executivo (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ório Executivo (RF 6).

Consolidar achados em relatório executivo claro com insights, tendências e recomendações priorizadas.

6.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 5).
• Tipo do input: Este agente deve ser apto a receber como input os kpis, anomalias_e_padroes, segmentos e recomendacoes gerados 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é 10.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório em markdown estruturado com: Sumário Executivo (3–5 bullet points), Período Analisado, KPIs principais, Padrões e Tendências, Anomalias e Riscos, Segmentação de Usuários, Recomendações Prioritárias (com impacto e custo), Próximos Passos, Apêndice Metodológico (definições e fórmulas).
• Exemplo de Estrutura de Output:

   **Sumário Executivo:**
  - Insight 1
  - Insight 2
  
  **Período Analisado:**
  - De XX/XX/XXXX a XX/XX/XXXX
  
  **KPIs principais:**
  - KPI 1
  - KPI 2
  
  **Padrões e Tendências:**
  - Padrão 1
  - Padrão 2
  
  **Anomalias e Riscos:**
  - Anomalia 1
  - Anomalia 2
  
  **Segmentação de Usuários:**
  - Segmento 1
  - Segmento 2
  
  **Recomendações Prioritárias:**
  - Recomendação 1
  - Recomendação 2
  
  **Próximos Passos:**
  - Passo 1
  - Passo 2
  
  **Apêndice Metodológico:**
  - Definição 1
  - Definição 2 

• Número de caracteres esperado: O relatório gerado deve ter um tamanho estimado em torno de 5.000 caracteres.

6.3.3 Parâmetros de Geração

• Modelo: GPT-4
• Temperatura: 0.5

6.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para formatação e cálculo de dados.
• 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 (relatório executivo) é 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.