Agente de IA para Previsão de Demanda de Serviços em Estabelecimentos Credenciados

Receber dados históricos heterogêneos e devolver dataset padronizado e validado para análise de demanda.

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 via API. Na fase de testes, os dados serão enviados 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 históricos em formato tabular.
• Formatos Suportados: Esse agente deve ser capaz de receber dados em 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 estruturado contendo o dataset padronizado e validado, pronto para análise.
• Exemplo de Estrutura de Output:

   {
    "dataset_normalizado": [
      {"estabelecimento_id": "1", "servico_id": "101", "data_hora": "2025-12-22T11:56:00Z", "quantidade": 10, "capacidade": 15, "cancelamentos": 0, "status": "completo", "preco": 100.0, "origem": "online", "evento": false, "feriado": false}
    ],
    "dicionario_campos": {"mapeamento_origem": "padrao"},
    "resumo_qualidade": {"periodo_min": "2025-01-01", "periodo_max": "2025-12-21", "dias_cobertos": 365, "granularidade_detectada": "dia", "perc_missing_por_campo": {"quantidade": 0.0}, "outliers_detectados": 0, "registros_descartados": 0, "regra_capacidade_assumida": "max(quantidade)"},
    "prontidao_para_analise": true,
    "motivo_nao_pronto": null
  } 

• 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: 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 Extração de Padrões 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 Extração de Padrões de Demanda (RF 2).

Identificar padrões sazonais, ciclos e métricas operacionais a partir do dataset validado.

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 estruturado contendo o dataset padronizado e validado.
• 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é 10.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado contendo os padrões sazonais, ciclos e métricas operacionais identificados.
• Exemplo de Estrutura de Output:

   {
    "padroes": {
      "sazonalidade_dia_semana": "1.0",
      "sazonalidade_hora": "1.0",
      "sazonalidade_mes": "1.0",
      "tendencia_simples": "0.05",
      "efeito_feriado": "0.02",
      "efeito_evento": "0.01"
    },
    "metricas": {
      "media": "15",
      "mediana": "14",
      "p50": "15",
      "p90": "20",
      "desvio_padrao": "5",
      "taxa_utilizacao_media": "0.75",
      "no_show_rate": "0.1",
      "cancelamento_rate": "0.05"
    },
    "janelas_pico": [
      {"inicio": "2025-12-22T11:56:00Z", "fim": "2025-12-22T12:56:00Z", "tz": "UTC", "criterio": "p90 > 120% da média"}
    ],
    "confiabilidade_padroes": "0.9"
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 4.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 Previsão de Demanda Futura (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Previsão de Demanda Futura (RF 3).

Projetar demanda futura por serviço e estabelecimento usando tendência e sazonalidades identificadas.

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 um JSON estruturado contendo padrões e métricas identificados.
• 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.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado contendo as previsões de demanda futura por serviço e estabelecimento.
• Exemplo de Estrutura de Output:

   {
    "horizonte": {"unidade": "semanas", "valor": 8},
    "previsoes": [
      {"estabelecimento_id": "1", "servico_id": "101", "intervalo_inicio": "2025-12-22T11:56:00Z", "intervalo_fim": "2025-12-29T11:56:00Z", "demanda_prevista": 20.5, "faixa_min": 18.0, "faixa_max": 23.0, "faixa_confianca": 0.8, "premissas": {"tendencia_aplicada": "0.05", "sazonalidades_usadas": "dia_semana, hora", "ajuste_feriado_evento": "0.02", "no_show_aplicado": "0.1"}}
    ],
    "qualidade_previsao": {"confiabilidade_insumo": 0.9, "coerencia_capacidade": true, "flags": []}
  } 

• 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.
• 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 gerada por este agente deve ser visível para o Agente de Recomendação de Capacidade e Escala (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Recomendação de Capacidade e Escala (RF 4).

Converter a previsão em recomendações operacionais de capacidade, agenda e alocação de recursos para evitar superlotação e subutilizaçã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 um JSON estruturado contendo previsões de demanda futura.
• 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é 6.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado contendo as recomendações operacionais de capacidade, agenda e alocação de recursos.
• Exemplo de Estrutura de Output:

   {
    "recomendacoes": [
      {"estabelecimento_id": "1", "servico_id": "101", "intervalo": "2025-12-22T11:56:00Z", "capacidade_requerida": 25, "profissionais_necessarios": 3, "taxa_utilizacao_esperada": "0.8", "buffers": {"percentual": "10%", "justificativa": "janela de pico"}, "riscos": ["superlotacao"], "acoes_sugeridas": ["abrir_slot", "realocar_profissional"]}
    ],
    "premissas_operacionais": {"alvo_utilizacao": "0.8", "duracao_media": "30", "janela_funcionamento": "8:00-18:00"},
    "alertas": [{"tipo": "capacidade", "severidade": "alta", "mensagem": "Capacidade fora do horário permitido."}]
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 3.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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 Relatórios de Previsão e Operação (RF 5).

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

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

Gerar relatórios executivos e operacionais claros para apoiar decisões estratégicas e táticas.

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 um JSON estruturado contendo previsões de demanda e recomendações operacionais.
• 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é 8.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório em Markdown e um resumo em JSON. O Markdown deve conter seções detalhadas com KPIs, previsões, janelas de pico, recomendações e premissas.
• Exemplo de Estrutura de Output:

   **Visão Executiva**
  - Crescimento Previsto: 10%
  - Semanas Cobertas: 8
  - Confiabilidade Média: 0.9
  - Janelas de Pico: 5
  - Risco de Superlotação: 2
  - Risco de Subutilização: 1
  
  **Previsões por Estabelecimento/Serviço**
  | Intervalo | Demanda Prevista | Faixa Min | Faixa Max | Capacidade Requerida | Profissionais Necessários | Risco |
  |-----------|------------------|-----------|-----------|----------------------|--------------------------|-------|
  | 2025-12-22T11:56:00Z | 20.5 | 18.0 | 23.0 | 25 | 3 | **Superlotação** |
  
  **Janelas de Pico e Riscos**
  - Intervalo: 2025-12-22T11:56:00Z a 2025-12-22T12:56:00Z
  - Critério: p90 > 120% da média
  - Ações Sugeridas: Abrir Slot, Realocar Profissional
  
  **Recomendações Operacionais**
  - Abrir slots adicionais em janelas de pico
  - Realocar profissionais para atender demanda
  - Campanha de balanceamento para períodos de subutilização
  
  **Premissas e Limitações**
  - Tendência e sazonalidades aplicadas conforme padrões identificados
  - Buffers aplicados em janelas de pico
  - Alvo de Utilização: 80%
  
  **Apêndice Metodológico**
  - Metodologia de cálculo de demanda e capacidade
  - Ajustes de sazonalidade e tendência
  - Considerações sobre dados ausentes
  
  **Resumo em JSON**
  {
    "kpis": {"crescimento_previsto": "10%", "semanas_cobertas": 8, "confiabilidade_media": 0.9, "janelas_pico": 5, "risco_superlotacao_count": 2, "risco_subutilizacao_count": 1},
    "riscos": ["superlotacao", "subutilizacao"],
    "decisoes_recomendadas": ["abrir_slot", "realocar_profissional"]
  }

• Número de caracteres esperado: O relatório em Markdown e o resumo em JSON juntos devem ter um tamanho estimado em 7.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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 é passada para outros agentes internos.

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