Agente de IA para Previsão de Picos de Atendimento

Receber e padronizar o histórico de atendimentos, validar integridade e gerar série temporal horária pronta para previsão.

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 de dados de atendimento via API. Na fase de testes, os dados serão enviados pelo 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 arquivo CSV ou JSON contendo registros de atendimentos.
• Formatos Suportados: Esse agente deve ser capaz de receber dados 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 estruturado contendo a série temporal horária padronizada e informações de validação.
• Exemplo de Estrutura de Output:

   {
    "serie_horaria_padronizada": [ { "datetime_utc": "2025-12-12T10:00:00Z", "dow": "Segunda", "hora": "10", "atendimentos": 45 } ],
    "timezone_origem": "America/Sao_Paulo",
    "lacunas_preenchidas": 3,
    "outliers_ajustados": 2,
    "periodo_coberto": { "inicio": "2025-10-01", "fim": "2025-12-12" },
    "semanas_de_dados": 10,
    "historico_validado": true,
    "motivos_invalidacao": [],
    "capacidade_base_por_hora": { "seg_09": 35, "seg_10": 40 }
  } 

• Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 5.000 caracteres, podendo variar conforme a complexidade dos dados processados.

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 Projeção de Demanda e Identificação de Picos (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Projeção de Demanda e Identificação de Picos (RF 2).

Gerar previsão base horária e identificar janelas de pico a partir do histórico 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 a série temporal horária padronizada e informações de validação.
• 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 JSON estruturado contendo a previsão de demanda e as janelas de pico identificadas.
• Exemplo de Estrutura de Output:

   {
    "previsao_base": [ { "datetime_utc": "2025-12-13T10:00:00Z", "demanda_prevista": 50, "baseline_dow_hora": 45, "ajuste_tendencia": 0.1 } ],
    "picos_detectados": [ { "inicio_utc": "2025-12-13T10:00:00Z", "fim_utc": "2025-12-13T12:00:00Z", "intensidade_relativa": 0.2, "motivo": "baseline+desvio" } ],
    "previsao_base_disponivel": true
  } 

• Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 3.000 caracteres, podendo variar conforme a complexidade dos dados processados.

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: 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 Preparação de Parâmetros de Busca de Fatores Externos (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Preparação de Parâmetros de Busca de Fatores Externos (RF 3).

Definir parâmetros de busca online para clima, feriados e eventos relevantes ao período previsto.

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: Este agente deve ser apto a receber como input um JSON estruturado contendo o calendário de picos detectados e o contexto de busca.
• 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é 3.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado contendo os parâmetros de busca definidos para clima, feriados e eventos.
• Exemplo de Estrutura de Output:

   {
    "parametros_busca": {
      "consultas": [
        { "categoria": "clima", "termos": ["previsão do tempo", "São Paulo", "chuva"], "intervalo": {"inicio_utc": "2025-12-10T00:00:00Z", "fim_utc": "2025-12-15T23:59:59Z"}, "localidade": "São Paulo, SP, Brasil", "idioma": "pt-BR" }
      ]
    }
  } 

• Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 2.000 caracteres, podendo variar conforme a complexidade dos dados processados.

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: Não utiliza.
• 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 Busca Online (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Busca Online (RF 4).

Realizar busca online para obter dados de clima, feriados e eventos no período e localidade definidos.

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: Este agente deve ser apto a receber como input um JSON estruturado contendo os parâmetros de busca online.
• 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é 2.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON consolidado contendo os resultados da busca online.
• Exemplo de Estrutura de Output:

   {
    "resultados_busca": {
      "itens": [
        { "categoria": "clima", "titulo": "Previsão de Chuva", "descricao_resumida": "Chuva intensa prevista para São Paulo", "data_inicio": "2025-12-12T00:00:00Z", "data_fim": "2025-12-12T23:59:59Z", "local": "São Paulo", "fonte_url": "http://exemplo.com/clima"
        }
      ]
    }
  } 

• Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 4.000 caracteres, podendo variar conforme a complexidade dos dados processados.

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: Não utiliza.
• Busca Online: Utiliza ferramenta de busca online para coletar dados.
• 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 Normalização e Impacto de Fatores Externos (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Normalização e Impacto de Fatores Externos (RF 5).

Transformar resultados de busca em fatores de impacto por data/hora.

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: Este agente deve ser apto a receber como input os resultados de busca online e a série de previsão base.
• 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.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado contendo os fatores de impacto normalizados por data/hora.
• Exemplo de Estrutura de Output:

   {
    "fatores_externos_normalizados": [
      { "intervalo": { "inicio_utc": "2025-12-12T07:00:00Z", "fim_utc": "2025-12-12T09:00:00Z" }, "tipo": "chuva forte", "impacto_multiplicador": 1.2, "justificativa": "Previsão de Chuva intensa", "confianca": 0.6 }
    ],
    "fatores_externos_disponiveis": true
  } 

• Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 3.500 caracteres, podendo variar conforme a complexidade dos dados processados.

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: 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 Ajuste da Previsão por Fatores Externos (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Ajuste da Previsão por Fatores Externos (RF 6).

Aplicar fatores externos à previsão base e recalcular janelas de pico.

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: Este agente deve ser apto a receber como input a previsão base e os fatores externos normalizados.
• 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é 4.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado contendo a previsão ajustada e as janelas de pico recalculadas.
• Exemplo de Estrutura de Output:

   {
    "previsao_ajustada": [ { "datetime_utc": "2025-12-13T10:00:00Z", "demanda_prevista_ajustada": 60, "multiplicador_externo_aplicado": 1.2 } ],
    "picos_ajustados": [ { "inicio_utc": "2025-12-13T10:00:00Z", "fim_utc": "2025-12-13T12:00:00Z", "intensidade_relativa": 0.3 } ],
    "previsao_ajustada_disponivel": true
  } 

• Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 3.500 caracteres, podendo variar conforme a complexidade dos dados processados.

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: Não utiliza.
• 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 Sugestão de Ações Preventivas Operacionais (RF 7).

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

Ao concluir sua execução, esse agente aciona o Agente de Sugestão de Ações Preventivas Operacionais (RF 7).

Gerar plano de ações preventivas por janela de pico ajustada com cálculo de recursos e timings.

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: Este agente deve ser apto a receber como input a previsão ajustada e dados de capacidade base por hora.
• 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.

7.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado contendo o plano de ações preventivas por janela de pico ajustada.
• Exemplo de Estrutura de Output:

   {
    "plano_preventivo": [
      { "janela_pico": { "inicio_utc": "2025-12-13T10:00:00Z", "fim_utc": "2025-12-13T12:00:00Z" }, "sobrecarga_max_relativa": 0.3, "headcount_extra": 2, "inicio_acionamento_recomendado_utc": "2025-12-13T09:00:00Z", "acoes": ["reforco_equipe", "reagendar_tarefas", "fila_prioritaria"], "detalhes": { "comunicacao": "Previsão de pico devido a evento", "configuracoes_canais": "priorizar atendimento digital" } }
    ],
    "parametros_utilizados": { "produtividade": 12, "capacidade_base": { "seg_09": 35, "seg_10": 40 }, "sla": 15 }
  } 

• Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 4.000 caracteres, podendo variar conforme a complexidade dos dados processados.

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: Não utiliza.
• 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 do fluxo.

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

A execução deste agente finaliza o fluxo. O plano de ações preventivas gerado é o resultado que deve ser disponibilizado ao usuário.