Agente de IA para Otimização de Escalas de Trabalho

Construir o perfil de demanda por período e a capacidade disponível da equipe, gerando restrições e metas para a geração de escala.

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 demanda e capacidade 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 JSON na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um arquivo JSON contendo dados históricos de demanda e capacidade.
• 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é 50.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado contendo perfis de demanda e capacidade, restrições e prioridades.
• Exemplo de Estrutura de Output:

   {
    "demand_profile": [
      {"janela": "2025-12-01T00:00:00Z", "required_headcount_por_skill": {"enfermeiro": 3, "medico": 2}},
      {"janela": "2025-12-01T01:00:00Z", "required_headcount_por_skill": {"enfermeiro": 2, "medico": 2}}
    ],
    "capacity_profile": [
      {"colaborador_id": "123", "janelas_disponiveis": [{"janela": "2025-12-01T00:00:00Z", "max_alocavel_horas": 8}]}
    ],
    "constraints": {
      "hard": ["limites legais", "não sobreposição de turnos"],
      "soft": [{"nome": "preferencias", "peso": 0.5, "descricao": "..."}]
    },
    "prioridades": ["Cobertura de hard constraints", "Minimizar lacunas em picos"]
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 3.500 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 calcular perfis de demanda e capacidade.
• 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 Gerador e Otimizador de Escalas de Trabalho (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente Gerador e Otimizador de Escalas de Trabalho (RF 2).

Produzir a escala detalhada por janela/turno atendendo às restrições obrigatórias e maximizando bem-estar e eficiência.

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).
• Tipo do input: Este agente deve ser apto a receber como input um JSON contendo perfis de demanda e capacidade, restrições e prioridades.
• 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é 50.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo a escala detalhada, métricas de cobertura e conformidade.
• Exemplo de Estrutura de Output:

   {
    "alocacoes": [
      {"colaborador_id": "123", "turno_id": "T1", "inicio": "2025-12-01T00:00:00Z", "fim": "2025-12-01T08:00:00Z", "unidade": "U1", "skill_utilizada": "enfermeiro"}
    ],
    "metricas": {
      "cobertura_total_pct": 95,
      "lacunas": [
        {"janela": "2025-12-01T00:00:00Z", "skill": "medico", "deficit": 1}
      ],
      "horas_por_colaborador": [
        {"colaborador_id": "123", "horas": 40}
      ],
      "violacoes_soft": [
        {"tipo": "preferencias", "quantidade": 2}
      ],
      "violacoes_hard": []
    },
    "conformidade": {
      "legislacao_ok": true,
      "detalhes": [
        {"tipo_regra": "descanso_min_horas", "ok": true, "evidencias": []}
      ]
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 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 documentos externos.
• Calculadora: Utiliza lógica interna para calcular a escala e métricas de conformidade.
• 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 Ajustes Reativos de Escala (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Ajustes Reativos de Escala (RF 3).

Recalcular partes afetadas da escala diante de eventos inesperados preservando a estabilidade do planejamento.

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) e sempre que um evento inesperado for detectado.
• Tipo do input: Este agente deve ser apto a receber como input um JSON contendo a escala atual e informações sobre eventos inesperados.
• 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é 30.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo a nova escala ajustada, impacto e justificativas das alterações.
• Exemplo de Estrutura de Output:

   {
    "alocacoes_ajustadas": [
      {"colaborador_id": "123", "turno_id": "T1", "inicio": "2025-12-01T00:00:00Z", "fim": "2025-12-01T08:00:00Z", "unidade": "U1", "skill_utilizada": "enfermeiro"}
    ],
    "impacto": {
      "janelas_tocadas": 3,
      "variacao_horas_por_colaborador": [
        {"colaborador_id": "123", "delta_horas": 5}
      ]
    },
    "justificativas": [
      {"janela": "2025-12-01T00:00:00Z", "motivo_ajuste": "absenteismo", "regra_aplicada": "realocar folguistas"}
    ]
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 2.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 recalcular a escala e impactos.
• 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 Monitoramento de Bem-Estar da Equipe (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Monitoramento de Bem-Estar da Equipe (RF 4).

Avaliar risco de fadiga e burnout e sugerir ajustes preventivos na escala.

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 contendo a escala atual e dados de bem-estar da equipe.
• 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é 20.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo riscos de fadiga, recomendações de ajustes e um resumo por unidade.
• Exemplo de Estrutura de Output:

   {
    "riscos": [
      {"colaborador_id": "123", "score_risco": 75, "fatores": [{"fator": "horas_extras", "peso": 0.35, "evidencia": "10 horas extras na última semana"}]}
    ],
    "recomendacoes": [
      {"tipo": "troca_turno", "detalhes": "Trocar turno noturno do colaborador 123 com colaborador 456"}
    ],
    "ajustes_sugeridos": {
      "alocacoes_ajustadas": []
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 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 documentos externos.
• Calculadora: Utiliza lógica interna para calcular riscos de fadiga e burnout.
• 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 é o resultado final do fluxo e não precisa ser visível para outros agentes.

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

A execução deste agente finaliza o fluxo. As recomendações e ajustes sugeridos devem ser disponibilizados para análise e intervenção humana, se necessário.