Agente de IA para Recomendação de Materiais Didáticos

Consolidar e normalizar, em um único diagnóstico pedagógico operacional, as características do conteúdo das aulas e do perfil dos alunos para habilitar recomendações personalizadas de materiais didáticos complementares focados em práticas laboratoriais.

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 JSON contendo informações sobre o conteúdo das aulas e o perfil 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 do JSON na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: JSON com informações sobre aulas e alunos.
• Formatos Suportados: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 50.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: JSON com o diagnóstico normalizado das aulas e alunos.
• Exemplo de Estrutura de Output:

   {
    "aula_features": {
      "topicos_normalizados": [],
      "palavras_chave_normalizadas": [],
      "objetivos_aprendizagem": [],
      "modalidade_laboratorial": "",
      "riscos_proibidos": [],
      "janela_tempo_max_min": 0,
      "idioma_alvo": "",
      "nivel_dificuldade_alvo": 0
    },
    "aluno_features": [
      {
        "aluno_id": "",
        "nivel_proficiencia": 0,
        "lacunas_prioritarias": [],
        "interesses_prioritarios": [],
        "preferencia_midia_ranked": [],
        "idioma_preferido": "",
        "necessidades_acessibilidade": [],
        "sensibilidade_custo": 0
      }
    ],
    "corpus_resumo": {
      "total_materiais": 0,
      "por_tipo": {},
      "por_idioma": {},
      "cobertura_topicos": {},
      "qualidade_media_fonte": 0
    },
    "flags_qualidade": {
      "insuficiencia_dados": false,
      "campos_faltantes": [],
      "insuficiencia_corpus": false,
      "motivos_insuficiencia_corpus": []
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho aproximado de 10.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 Recomendações de Materiais Didáticos (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Recomendações de Materiais Didáticos (RF 2).

Gerar recomendações personalizadas de materiais complementares para práticas laboratoriais por aluno, maximizando alinhamento a conteúdo da aula, perfil e restrições, e fornecendo justificativas claras e métricas de adequaçã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: JSON com o diagnóstico do agente anterior, incluindo informações sobre a aula e o perfil dos alunos.
• Formatos Suportados: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 50.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: JSON com as recomendações personalizadas de materiais didáticos.
• Exemplo de Estrutura de Output:

   {
    "lista_recomendacoes_por_aluno": [
      {
        "aluno_id": "",
        "recomendacoes": [
          {
            "material_id": "",
            "titulo": "",
            "url": "",
            "tipo": "",
            "idioma": "",
            "tempo_estimado_min": 0,
            "nivel": "",
            "topicos_cobertos": [],
            "pre_requisitos_atendidos": false,
            "requisitos_equipamento_compatíveis": false,
            "riscos_ok": false,
            "acessibilidade_atendida": [],
            "custo": "",
            "licenca": "",
            "qualidade_fonte": 0,
            "fit_score": 0,
            "rationale": ""
          }
        ],
        "resumo_justificativa_geral": "",
        "metricas": {
          "cobertura_topicos_percent": 0,
          "diversidade_tipos": 0,
          "tempo_total_min": 0,
          "ajuste_dificuldade": 0,
          "proporcao_acessibilidade_atendida": 0
        }
      }
    ],
    "gaps_quando_sem_recomendacao": [
      {
        "aluno_id": "",
        "motivo": "",
        "lacunas_catalogo": {
          "topicos_em_falta": [],
          "tipos_em_falta": [],
          "idiomas_em_falta": []
        }
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho aproximado de 10.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 é o resultado final do fluxo e não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo. As recomendações geradas devem ser disponibilizadas para os usuários finais.