Agente de IA para Previsão de Demanda de Leitos de Observação

Produzir previsão-base de demanda de leitos de observação a partir de séries históricas e calendário de eventos locais, capturando efeitos sazonais e de eventos.

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 ocupação de leitos e calendário de eventos locais via API. Na fase de testes, os dados serão enviados para o agente diretamente por upload de um csv na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um conjunto de dados estruturados em formato JSON.
• Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .json, .csv.
• 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 arquivo no formato JSON contendo a previsão-base e a qualidade dos dados analisados.
• Exemplo de Estrutura de Output:

   {
    "forecast_base": [
      {
        "data": "2025-12-01",
        "demanda_prevista": 120.5,
        "intervalo_confianca_p5": 100,
        "intervalo_confianca_p95": 140,
        "sazonalidade_idx": 1.2,
        "efeito_evento_pct": 15,
        "variacao_vs_media_28d_pct": 10
      }
    ],
    "qualidade_dados": {
      "faltantes": 0,
      "outliers_detectados": 2,
      "cobertura_dias_pct": 98
    },
    "pressupostos": ["Sem mudanças estruturais de oferta"],
    "parametros_utilizados": {
      "janela_sazonal_dias": 30,
      "janela_tendencia_dias": 60,
      "mapeamento_categorias_evento": {"evento_local": 10}
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 2.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 Modelagem de Cenários de Demanda (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Modelagem de Cenários de Demanda (RF 2).

Transformar a previsão-base em cenários de capacidade acionáveis (pessimista, base, otimista) com recomendações de leitos e alertas de risco.

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 arquivo JSON, que corresponde à previsão-base gerada pelo agente anterior.
• 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é 5.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON contendo os cenários de capacidade e as recomendações de leitos.
• Exemplo de Estrutura de Output:

   {
    "cenarios": {
      "pessimista": [
        {
          "data": "2025-12-01",
          "demanda_prevista": 140,
          "leitos_recomendados": 150,
          "risco_overflow_pct": 20
        }
      ],
      "base": [...],
      "otimista": [...]
    },
    "recomendacoes_capacidade": [
      {
        "data": "2025-12-01",
        "acao": "ativar",
        "quantidade_leitos": 10,
        "justificativa": "Previsão de alta demanda devido a evento local"
      }
    ],
    "alertas": [
      {
        "data": "2025-12-01",
        "tipo": "risco_overflow",
        "severidade": "alta",
        "mensagem": "Risco de superlotação devido a alta demanda prevista"
      }
    ],
    "parametros_utilizados": {
      "uplift_risco_pessimista_pct": 25,
      "reducao_risco_otimista_pct": 15,
      "ocupacao_max_pct": 90
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 3.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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 Ajuste de Previsões em Tempo Real (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Ajuste de Previsões em Tempo Real (RF 3).

Ajustar e reemitir previsões e cenários com base em desvios de curto prazo e variáveis externas em tempo quase real.

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 dois artefatos como input: o JSON com previsões e cenários de demanda e dados de sinais reais e variáveis externas.
• 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é 7.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON contendo as previsões ajustadas e os cenários de capacidade revisados.
• Exemplo de Estrutura de Output:

   {
    "previsao_ajustada": [
      {
        "data": "2025-12-01",
        "demanda_ajustada": 130,
        "intervalo_confianca_p5": 110,
        "intervalo_confianca_p95": 150
      }
    ],
    "cenarios_ajustados": {
      "pessimista": [...],
      "base": [...],
      "otimista": [...]
    },
    "alertas_realtime": [
      {
        "timestamp": "2025-12-01T10:00:00",
        "tipo": "ocupacao_alta",
        "severidade": "media",
        "mensagem": "Ocupação acima do esperado devido a fatores climáticos"
      }
    ],
    "rationale_ajuste": ["Ajuste realizado com base em desvio de curto prazo e alerta de clima"]
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 (JSON ajustado) é o entregável final e não é passada para outros agentes internos.

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

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