Agente de IA para Análise de Carga Horária Docente

Validar a consistência e normalizar os dados de carga horária docente para um formato padronizado antes da análise de conformidade.

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 sobre carga horária docente 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: O input inicial para o fluxo é um conjunto de dados estruturados contendo informações sobre professores, turmas e normas institucionais.
• 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 dados com até 50.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um conjunto de dados normalizados e uma lista de issues de validação, se houver.
• Exemplo de Estrutura de Output:

   {
    "dataset_normalizado": { "professores": [...], "turmas": [...], "atribuicoes": {...} },
    "issues_validacao": [{ "tipo": "conflito_horario", "severidade": "erro", "entidade": "professor", "id": "123", "descricao": "Conflito de horário detectado.", "sugestao_correcao": "Revisar atribuições." }],
    "dataset_aprovado": true
  }

• Número de caracteres esperado: O output 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.7

1.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para normalização de dados.
• 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 próximo agente no fluxo.

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

Ao concluir sua execução, esse agente aciona o próximo agente no fluxo.

Calcular métricas de carga por professor, comparar com normas institucionais e classificar o status de conformidade.

2.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior.
• Tipo do input: Este agente deve ser apto a receber um conjunto de dados normalizados e issues de validação do agente anterior.
• Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de dados com até 50.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um diagnóstico detalhado de conformidade por professor.
• Exemplo de Estrutura de Output:

   {
    "diagnostico": {
      "por_professor": [
        {
          "id_prof": "123",
          "horas": { "docencia": 20, "por_tipo_extras": {...}, "total": 40 },
          "limites": { "docencia": { "min": 10, "max": 40 }, "total": { "min": 30, "max": 50 } },
          "status": { "docencia": "em_conformidade", "total": "abaixo" },
          "conflitos_horarios": 1,
          "preparacoes_diferentes": 3,
          "dias_trabalhados": 5,
          "carga_noturna": { "horas": 5, "status": "em_conformidade" },
          "alertas": [...]
        }
      ],
      "lacunas_oferta": [...],
      "desequilibrio_equidade": { "desvio_padrao_horas_docencia": 5, "faixa_min_max": [20, 40], "professores_em_desvio_acima_percentual": [...] },
      "indicadores_globais": { "distribuicao_horas_docencia": { "p10": 15, "p50": 25, "p90": 35, "media": 27.5 }, "taxa_conflitos_por_professor": 0.1, "porcentagem_vagas_abertas": 0.05 }
    }
  }

• Número de caracteres esperado: O output deve ser detalhado e preciso, com um tamanho estimado em 5.000 caracteres.

2.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.7

2.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para cálculo de 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 próximo agente no fluxo.

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

Ao concluir sua execução, esse agente aciona o próximo agente no fluxo.

Produzir propostas de redistribuição de carga que corrijam inconformidades e reduzam desequilíbrios, com impacto quantificado e justificativas.

3.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior.
• Tipo do input: Este agente deve ser apto a receber um diagnóstico detalhado de conformidade por professor e um conjunto de dados normalizados.
• Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de dados com até 50.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um conjunto de propostas de ajuste de carga horária docente.
• Exemplo de Estrutura de Output:

   {
    "propostas": [
      {
        "id_proposta": "1",
        "descricao_curta": "Ajuste de carga horária para equilíbrio.",
        "mudancas": [...],
        "aderencia_pos_ajuste": { "violacoes_remanescentes": 0, "metas_equidade": true },
        "riscos_e_observacoes": [...]
      }
    ],
    "criterios_utilizados": { "prioridades": [...], "restricoes_consideradas": [...] }
  }

• Número de caracteres esperado: O output deve ser claro e detalhado, com um tamanho estimado em 5.000 caracteres.

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.7

3.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para cálculo de propostas de ajuste.
• 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 próximo agente no fluxo.

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

Ao concluir sua execução, esse agente aciona o próximo agente no fluxo.

Avaliar cenários específicos solicitados (por exemplo, remoção temporária de professor, inclusão de nova turma) e medir impactos na conformidade e equidade.

4.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado conforme necessidade de simulação de cenários.
• Tipo do input: Este agente deve ser apto a receber um conjunto de dados normalizados e uma lista de ajustes hipotéticos.
• Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de dados com até 50.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um resultado de simulação de cenários.
• Exemplo de Estrutura de Output:

   {
    "resultado_simulacao": {
      "cenarios": [
        {
          "nome": "Cenário 1",
          "mudancas_aplicadas": [...],
          "diagnostico_pos": {...},
          "impactos_globais": { "conformidade": true, "equidade": true, "vagas_abertas": 0 }
        }
      ]
    }
  }

• Número de caracteres esperado: O output deve ser claro e detalhado, com um tamanho estimado em 5.000 caracteres.

4.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.7

4.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para simulação de cenários.
• 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 próximo agente no fluxo.

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

Ao concluir sua execução, esse agente aciona o próximo agente no fluxo.

Consolidar diagnóstico e propostas em um pacote final padronizado para decisão gerencial.

5.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior.
• Tipo do input: Este agente deve ser apto a receber um diagnóstico, propostas de ajuste e um conjunto de dados normalizados.
• Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de dados com até 50.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório final consolidado para decisão gerencial.
• Exemplo de Estrutura de Output:

   {
    "relatorio_final": {
      "resumo_execucao": { "datahora": "2025-12-21T12:39:00", "total_professores": 100, "total_turmas": 50, "principais_inconformidades": [...] },
      "destaques": { "professores_sobrecarga": [...], "professores_subcarga": [...], "conflitos_horarios": [...], "vagas_abertas": [...] },
      "comparativo_cenarios": [...],
      "recomendacao_sugerida": { "id_proposta": "1", "justificativa": "Menor violação residual." },
      "anexos": { "tabelas_csv_like": { "professores": [...], "turmas": [...], "atribuicoes": [...] }, "json_machine_readable": { "diagnostico": {...}, "propostas": [...] } }
    }
  }

• Número de caracteres esperado: O output deve ser detalhado e abrangente, com um tamanho estimado em 10.000 caracteres.

5.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.7

5.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para consolidação de dados.
• 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 é o entregável final do fluxo.

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.