Agente de IA para Criação de Conteúdo Educacional

Consolidar currículo e dados dos alunos em um perfil de aprendizagem estruturado, com lacunas, metas SMART e parâmetros de personalizaçã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 dos dados do currículo e dos alunos 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 são dados estruturados do currículo e dos alunos.
• 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 texto com até 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON contendo o perfil de aprendizagem estruturado. A estrutura deve incluir lacunas, metas SMART e parâmetros de personalização para cada aluno.
• Exemplo de Estrutura de Output:

   {
    "perfil_aprendizagem": {
      "alunos": [
        {
          "id": "A001",
          "lacunas": ["interpretação de gráficos de velocidade x tempo"],
          "prioridades": [{"topico": "Dinâmica", "prioridade": "A"}],
          "metas_smart": [{"topico": "Cinemática", "meta": "Resolver 80% de exercícios de MRU em 2 semanas", "metricas": ["% acerto"], "prazo_dias": 14}],
          "nivel_complexidade_target": {"Cinemática": "Aplicar", "Dinâmica": "Compreender"},
          "estrategias_engajamento": ["usar exemplos com futebol e bicicleta"],
          "ajustes_acessibilidade": ["instruções curtas e objetivas", "quebrar tarefas em passos"],
          "idioma": "pt-BR"
        }
      ],
      "dados_suficientes": true
    }
  } 

• 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 Planejamento de Sequência Didática (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Planejamento de Sequência Didática (RF 2).

Converter o perfil de aprendizagem em um plano de unidades e aulas com objetivos, pré-requisitos, duração, atividades e avaliação.

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 arquivo JSON, que corresponde ao perfil de aprendizagem gerado pelo agente anterior.
• 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 arquivo no formato JSON contendo o plano de sequência didática. A estrutura deve definir unidades, aulas, objetivos, pré-requisitos, duração, atividades e avaliação.
• Exemplo de Estrutura de Output:

   {
    "plano_sequencia": {
      "unidades": [
        {
          "titulo": "Movimento e Força",
          "aulas": [
            {
              "id": "Aula-1",
              "objetivo": "Aplicar MRU a situações do cotidiano",
              "conteudos": ["posição", "velocidade", "gráficos v x t"],
              "prerequisitos": ["Grandezas e unidades"],
              "estrategia": "exposição breve + prática guiada",
              "duracao_min": 45,
              "avaliacao_formativa": {"tipo": "quiz diagnóstico", "criterios": [">=75% acertos"]},
              "recursos_previstos": ["planilha simples", "cartolinas"]
            }
          ],
          "mapa_objetivos_curriculares": ["BNCC-CN08-01"]
        }
      ],
      "carga_semanal_min": 90,
      "checkpoints": ["Revisão após Aula-2"],
      "sumativa": {"tipo": "projeto curto", "rubrica": ["conceitos", "aplicação", "comunicação"]}
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 6.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: 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 Geração de Materiais Didáticos Personalizados (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Materiais Didáticos Personalizados (RF 3).

Produzir materiais de aula personalizados e nivelados com base no plano de sequência e perfil do aluno.

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 dois artefatos como input: o plano de sequência didática e o perfil de aprendizagem dos alunos.
• 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é 15.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON contendo os materiais didáticos personalizados para cada aula. A estrutura deve incluir roteiro, explicação, exemplos, atividades práticas, exercícios, versões niveladas, e itens de engajamento.
• Exemplo de Estrutura de Output:

   {
    "materiais": {
      "por_aula": [
        {
          "aula_id": "Aula-1",
          "roteiro": "Abertura (5m), exemplo do cotidiano com futebol (10m), prática guiada (20m), checagem (10m)",
          "explicacao": "Texto claro e conciso...",
          "exemplos": ["Calcular velocidade média na corrida"],
          "atividade_pratica": {"descricao": "Medir deslocamento e tempo", "passos": ["passo 1", "passo 2"]},
          "exercicios": [{"enunciado": "...", "nivel": "básico", "gabarito": "..."}],
          "versoes_niveladas": {"basico": "...", "intermediario": "...", "avancado": "..."},
          "diferenciacoes": ["quebrar tarefas em micro-passos"],
          "itens_engajamento": ["exemplo com bicicleta"],
          "indicadores_leiturabilidade": {"alvo": "8º ano", "complexidade_relativa": "média"}
        }
      ]
    }
  } 

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

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

Ao concluir sua execução, esse agente aciona o Agente de Avaliação de Alinhamento e Qualidade (RF 4).

Verificar se os materiais atendem ao currículo, ao perfil do aluno e aos critérios de clareza, acessibilidade, segurança e cobertura; emitir veredicto e ajustes.

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 três artefatos como input: os materiais didáticos produzidos, o plano de sequência e o perfil de aprendizagem.
• 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 arquivo no formato JSON contendo o relatório de qualidade e alinhamento dos materiais. A estrutura deve incluir cobertura de objetivos, alinhamento de nível, acessibilidade, leiturabilidade, erros detectados, ajustes recomendados, e o veredicto de aprovação.
• Exemplo de Estrutura de Output:

   {
    "qa_relatorio": {
      "cobertura_objetivos": 0.93,
      "alinhamento_nivel": "adequado",
      "acessibilidade": "adequada",
      "leiturabilidade": "coerente com 8º ano",
      "erros_detectados": [],
      "ajustes_recomendados": [],
      "aprovado": true,
      "motivo_reprovacao": null
    }
  } 

• 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 documentos externos.
• Calculadora: Não utiliza.
• 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 Revisão e Ajustes Finais (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Revisão e Ajustes Finais (RF 5).

Aplicar os ajustes recomendados pelo QA e devolver materiais revisados com controle de versão e changelog.

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 dois artefatos como input: os materiais didáticos e o relatório de qualidade.
• 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é 25.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON contendo os materiais revisados e aprovados. A estrutura deve incluir controle de versão e changelog.
• Exemplo de Estrutura de Output:

   {
    "materiais_revisados": {
      "versao": "1.1",
      "por_aula": [...],
      "changelog": [
        {"alvo": "por_aula[0].explicacao", "mudanca": "reduzido para ~150 palavras", "motivo": "leiturabilidade"}
      ]
    },
    "aprovacao_final_prevista": true
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 5.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 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 é o entregável final e não precisa ser visível para outros agentes.

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

A execução deste agente finaliza o fluxo. Os materiais revisados e aprovados são o resultado que deve ser disponibilizado ao usuário.