Agente de IA para Identificação de Talentos Acadêmicos

Unificar e padronizar dados acadêmicos de múltiplas fontes para um esquema único, validando consistência e preparando o dataset para análise de talentos.

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 uma planilha de desempenho acadêmico 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 da planilha na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é uma planilha de desempenho acadêmico.
• Formatos Suportados: Esse agente deve ser capaz de receber planilhas nos formatos: .xlsx, .csv.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 200.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo o esquema de dados padronizado e os registros normalizados.
• Exemplo de Estrutura de Output:

   {"schema": {"aluno_id": "string", "nome": "string", "serie": "string", "periodo": "string", "disciplina": "string", "nota_normalizada": "number(0..1)", "z_score": "number", "percentil": "number(0..100)", "fonte": "string", "flags": {"dados_insuficientes": "boolean", "escala_desconhecida": "boolean", "outlier_potencial": "boolean"}}, "registros": [ {"aluno_id": "A123", "nome": "Fulano", "serie": "8º ano", "periodo": "2025-1", "disciplina": "Matemática", "nota_normalizada": 0.92, "z_score": 2.1, "percentil": 98, "fonte": "boletim_escolar", "flags": {"dados_insuficientes": false, "escala_desconhecida": false, "outlier_potencial": false}} ]}

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno 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 Identificação de Talentos Acadêmicos (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Identificação de Talentos Acadêmicos (RF 2).

Detectar alunos com talentos excepcionais por área/competência a partir do dataset normalizado, produzindo lista priorizada com evidências e explicabilidade.

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 objeto JSON contendo registros normalizados com nota_normalizada, z_score, percentil, flags e metadados.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 15.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo a lista de talentos identificados, com evidências e explicabilidade.
• Exemplo de Estrutura de Output:

   {"criterios_utilizados": {"limiar_percentil": 95, "limiar_z_score": 2.0, "min_periodos_por_disciplina": 3}, "talentos": [ {"aluno_id": "A123", "nome": "Fulano", "serie": "8º ano", "area": "Matemática", "nivel_talento": "excepcional", "evidencias": {"percentis_recorrentes": [97, 98, 99], "z_scores": [2.1, 2.4], "trajetoria": "ascendente", "premiacoes": [{"evento": "OBMEP", "nivel": "prata", "ano": 2024}]}, "confianca": 0.86, "racional": "Desempenho > p95 por 3 períodos consecutivos e medalha em olimpíada." } ]}

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 5.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 Recomendação de Programas de Enriquecimento (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Recomendação de Programas de Enriquecimento (RF 3).

Sugerir programas de enriquecimento personalizados por área e nível de talento, com plano de progressão e critérios de entrada.

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 com lista de talentos por aluno, incluindo área, nível_talento, confiança, trajetória e evidências.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 10.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo recomendações de programas de enriquecimento personalizados.
• Exemplo de Estrutura de Output:

   {"recomendacoes": [ {"aluno_id": "A123", "nome": "Fulano", "area": "Matemática", "nivel_talento": "excepcional", "sugestoes": [ {"tipo_programa": "Olimpíadas e Treinamento Avançado", "descricao": "Treinamento semanal para OBMEP/OBM com listas de nível 2-3.", "carga_horaria_semanal": 3, "modalidade": "presencial", "duracao_semanas": 16, "pré_requisitos": ["percentil>=95 em 2+ períodos", "base algébrica sólida"], "materiais_base": ["Lista OBMEP Nível 2", "Art of Problem Solving (AOPS)"], "metas": ["Classificação fase 2", "Medalha regional"], "avaliação_progresso": "simulado mensal" } ], "plano_progressao": ["Curto prazo: consolidar geometria", "Médio prazo: iniciar teoria dos números"], "observacoes": "Confiança alta (0.86)." } ]}

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 5.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 é o entregável final e não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo. As recomendações geradas são o resultado que deve ser disponibilizado ao usuário.