Agente de IA para Previsão de Demandas no Pronto Atendimento

Validar e estruturar os parâmetros de coleta e preparo dos dados históricos para previsão de demanda do pronto atendimento.

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 JSON com parâmetros para coleta de dados 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: JSON com parâmetros de coleta de dados.
• 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.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON 'query_params' estruturado com os parâmetros validados e ajustados para consulta.
• Exemplo de Estrutura de Output:

   {
    "periodo_inicio": "2022-01-01T00:00:00Z",
    "periodo_fim": "2025-12-05T12:55:00Z",
    "granularidade": "hora",
    "unidade_id": "123",
    "lista_servicos": ["clinico_geral","ortopedia"],
    "campos_requeridos": ["timestamp_atendimento","servico","classificacao_risco","qtd_atendimentos","tempo_espera_min","origem_demanda"],
    "filtros_exclusao": ["origem='teste'","pacientes_dummy=true"],
    "chaves_de_agrupamento": ["timestamp_trunc_hora","servico"],
    "timezone": "America/Sao_Paulo",
    "lista_eventos_sazonais_solicitados": ["feriados_nacionais","feriados_locais","vesperas","pos-feriado","calendario_escolar"]
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 800 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 Execução de Consultas em Banco de Dados (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 Consultas em Banco de Dados (RF 2).

Realizar conexão com o Data Warehouse hospitalar para obter séries históricas de atendimentos do pronto atendimento.

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: JSON 'query_params' com os parâmetros validados e ajustados para consulta.
• 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: Dataset JSON com os dados recuperados do Data Warehouse.
• Exemplo de Estrutura de Output:

   {
    "timestamp_trunc_hora": "2025-12-05T12:00:00Z",
    "servico": "clinico_geral",
    "qtd_atendimentos": 25,
    "tempo_medio_espera_min": 30,
    "classificacao_risco_distribuicao": {"baixa": 15, "media": 5, "alta": 5},
    "origem_demanda_distribuicao": {"emergencia": 15, "agendamento": 10}
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 1.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: Conecta-se ao Data Warehouse hospitalar para execução de consultas.

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 Enriquecimento Sazonal e Qualidade 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 Enriquecimento Sazonal e Qualidade de Dados (RF 3).

Tratar qualidade do dataset e gerar variáveis sazonais e de calendário para suporte à previsão.

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: Dataset histórico por hora do pronto atendimento e, quando disponível, listas de feriados/eventos.
• 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é 20.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: JSON com dataset enriquecido e relatório de qualidade dos dados.
• Exemplo de Estrutura de Output:

   {
    "dataset_enriquecido": [
      {
        "timestamp_trunc_hora": "2025-12-05T12:00:00Z",
        "servico": "clinico_geral",
        "qtd_atendimentos": 25,
        "is_outlier": false,
        "dow": 2,
        "hora_do_dia": 12,
        "trafego_base": 22
      }
    ],
    "relatorio_qualidade": {
      "completude": 95,
      "outliers": 5,
      "datas_faltantes": ["2025-11-01","2025-11-02"]
    }
  } 

• 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: Utiliza lógica interna para cálculos estatísticos e de qualidade dos dados.
• 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 Demanda (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 Demanda (RF 4).

Gerar previsões de demanda por hora para cada serviço do pronto atendimento, incorporando efeitos sazonais e eventos.

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 enriquecido com variáveis sazonais e de calendário.
• 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é 20.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: JSON 'previsoes' com previsões de demanda e métricas de backtest.
• Exemplo de Estrutura de Output:

   {
    "previsoes": [
      {
        "timestamp": "2025-12-06T00:00:00Z",
        "servico": "clinico_geral",
        "demanda_prevista": 30,
        "pi_inferior": 25,
        "pi_superior": 35,
        "qualidade_previsao": "alta",
        "metricas_backtest": {"MAPE": 10, "MAE": 2, "RMSE": 3}
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 2.500 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ão e métricas de backtest.
• 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 Execução de Chamada à API (RF 5).

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

Realizar chamada à API do Sistema de Gestão Hospitalar para obter capacidade atual de recursos.

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: Payload pronto com endpoint, headers e filtros para a chamada à 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 até 5.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: JSON 'recursos_disponiveis' com dados de capacidade de recursos.
• Exemplo de Estrutura de Output:

   {
    "recursos_disponiveis": {
      "headcount": {"clinico_geral": 10, "ortopedia": 5},
      "produtividade_por_profissional_h": {"clinico_geral": 5, "ortopedia": 4},
      "restricoes": {"leitos": 20, "salas": 5},
      "janelas_indisponibilidade": ["2025-12-06T00:00:00Z","2025-12-06T01:00:00Z"]
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 1.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: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Conecta-se ao Sistema de Gestão Hospitalar para execução de chamadas à API.

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 Otimização de Recursos (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Otimização de Recursos (RF 6).

Transformar previsões de demanda e capacidade disponível em um plano de alocação de recursos e pessoal por turno.

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: Previsões de demanda e dados de capacidade de recursos.
• 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.

6.3.2 Especificação do Output

• Formato de output: JSON 'plano_otimizado' com plano de alocação de recursos e pessoal.
• Exemplo de Estrutura de Output:

   {
    "plano_otimizado": [
      {
        "turno": "manha",
        "servico": "clinico_geral",
        "headcount_sugerido": 12,
        "variacao_vs_atual": 2,
        "necessidade_sobreaviso": false,
        "leitos_sugeridos": 15,
        "salas_sugeridas": 3,
        "risco_SLA": "baixo",
        "kpis": {"utilizacao_prevista": 85, "tempo_espera_previsto_p50": 10, "tempo_espera_previsto_p90": 20}
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 2.500 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 otimização de recursos e cálculos de KPIs.
• 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 deve ser visível para o Agente de Relatórios e Dashboards (RF 7).

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

Ao concluir sua execução, esse agente aciona o Agente de Relatórios e Dashboards (RF 7).

Gerar relatórios e dashboards para acompanhamento das previsões e do plano de alocação, com destaques de riscos e recomendações.

7.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 6).
• Tipo do input: Previsões de demanda, métricas de backtest e plano otimizado de alocação de recursos.
• 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é 20.000 caracteres.

7.3.2 Especificação do Output

• Formato de output: Relatório em HTML/JSON com visão executiva, operacional e de qualidade.
• Exemplo de Estrutura de Output:

   {
    "relatorio": {
      "visao_executiva": "Resumo da demanda prevista e impacto em headcount.",
      "visao_operacional": "Tabela por turno/serviço com headcount_sugerido e risco_SLA.",
      "visao_qualidade": "MAPE/MAE por serviço e períodos com qualidade baixa."
    }
  } 

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

7.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

7.3.4 Ferramentas do Agente

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

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

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