Agente de IA para Previsão de Necessidades de Benefícios

Receber dados históricos de utilização de benefícios, validar consistência e padronizar para série temporal mensal por tipo de benefício.

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 históricos 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 de um arquivo na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: Dados históricos de benefícios em formato CSV/JSON.
• 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 texto com até 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o dataset padronizado, dicionario de campos, metricas de qualidade, flags de processamento e score de qualidade.
• Exemplo de Estrutura de Output:

   {
    "dataset_padronizado": [
      {
        "ano": 2025,
        "mes": 12,
        "tipo_beneficio": "saude",
        "quantidade": 1200
      }
    ],
    "dicionario_campos": {
      "data_origem": "data",
      "beneficio_origem": "tipo_beneficio"
    },
    "metricas_qualidade": {
      "percentual_campos_nulos": 5,
      "percentual_negativos_corrigidos": 0,
      "consistencia_datas": {
        "min_data": "2025-01",
        "max_data": "2025-12",
        "meses_continuos": true
      }
    },
    "flags_processamento": {
      "imputacao_aplicada": false,
      "agregacao_mensal": true,
      "outliers_ajustados": false
    },
    "score_qualidade": 0.9
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 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: Utiliza lógica interna para cálculos de métricas de qualidade.
• 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 Busca Online de Tendências 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 Busca Online de Tendências de Benefícios (RF 2).

Executar buscas online para coletar sinais de tendências atuais relacionadas a benefícios, políticas públicas e sazonalidades setoriais.

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) ou quando a necessidade de busca de tendências online for identificada.
• Tipo do input: Parâmetros de busca prontos, incluindo termos de busca, período, regiões, idiomas e fontes permitidas.
• 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é 2.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser uma lista de itens com dados brutos de busca, incluindo título, fonte, URL, data de publicação e trecho relevante.
• Exemplo de Estrutura de Output:

   [
    {
      "titulo": "Tendências em Benefícios de Saúde para 2025",
      "fonte": "Relatório Setorial",
      "url": "https://exemplo.com/tendencias2025",
      "data_publicacao": "2025-11-30",
      "trecho_relevante": "Aumento na demanda por telemedicina"
    }
  ] 

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

2.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: Não se aplica (uso de ferramenta)

2.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Utiliza ferramenta interna de busca online para coletar dados.
• 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 Síntese de Tendências Externas (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Síntese de Tendências Externas (RF 3).

Transformar dados de tendências em fatores quantitativos por tipo de benefício e horizonte mensal.

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: Dados de tendências coletados online ou de insumos internos, podendo incluir fontes e datas.
• 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é 5.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com fatores de ajuste por tipo de benefício e um resumo de síntese.
• Exemplo de Estrutura de Output:

   {
    "features_tendencias_externas": [
      {
        "ano": 2025,
        "mes": 12,
        "tipo_beneficio": "saude",
        "fator_ajuste_percentual": 5.0,
        "eventos_relevantes": "campanha de vacinação",
        "confianca_fonte": 0.9,
        "origem": "online"
      }
    ],
    "resumo_sintese": {
      "fontes_agrupadas": "relatórios setoriais, órgãos oficiais",
      "cobertura_temporal": "2025-01 a 2025-12",
      "media_confianca": 0.8
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 3.500 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: Utiliza lógica interna para cálculo de fatores de ajuste.
• 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 Previsão de Necessidades 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 Previsão de Necessidades de Benefícios (RF 4).

Gerar previsões mensais por tipo de benefício combinando histórico padronizado e fatores de tendência externos, com faixas de incerteza e qualidade do ajuste.

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: Dataset padronizado de benefícios e fatores de tendências externas.
• 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 com previsões mensais, métricas de ajuste e qualidade da previsão.
• Exemplo de Estrutura de Output:

   {
    "previsoes": [
      {
        "ano": 2025,
        "mes": 12,
        "tipo_beneficio": "saude",
        "quantidade_prevista": 1300,
        "intervalo_inferior": 1170,
        "intervalo_superior": 1430,
        "premissas_aplicadas": "sazonalidade, tendência externa"
      }
    ],
    "metricas_ajuste": {
      "backtest_meses": 3,
      "mape": 9.5,
      "bias": 1.2,
      "cobertura_intervalo": 95
    },
    "qualidade_previsao": {
      "nivel": "alto",
      "justificativas": "MAPE abaixo de 10%, score de qualidade acima de 0.8"
    },
    "alertas": {
      "serie_curta": false,
      "dados_baixa_qualidade": false,
      "falta_tendencias": false
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 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: Utiliza lógica interna para cálculos de previsões e métricas.
• 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ção de Ajustes Proativos de Pacotes (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Recomendação de Ajustes Proativos de Pacotes (RF 5).

Converter as previsões em recomendações de ajustes nos pacotes de benefícios, priorizando ações por impacto e urgência.

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: Previsões de necessidades de benefícios e métricas de ajuste.
• 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é 8.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com plano de ação e resumo financeiro.
• Exemplo de Estrutura de Output:

   {
    "plano_de_acao": [
      {
        "tipo_beneficio": "saude",
        "regiao": "Nacional",
        "acao_sugerida": "expandir",
        "quantidade_ajuste": 100,
        "impacto_orcamentario_estimado": 5000,
        "prioridade": "alta",
        "justificativa": "Demanda acima de capacidade em 20%",
        "riscos": "custo_desconhecido",
        "prazo_recomendado": "2026-02"
      }
    ],
    "resumo_financeiro": {
      "orcamento_total_estimado": 50000,
      "variacao_vs_atual": 10
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 3.500 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álculos de ajustes e impactos.
• 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 é o entregável final e não precisa ser visível para outros agentes internos.

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

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