Agente de IA para Detecção de Talentos Especiais

Validar integridade e padronizar dados de desempenho acadêmico e atividades extracurriculares, gerando atributos comparáveis por aluno e por área.

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 de desempenho acadêmico e atividades extracurriculares via API. Na fase de testes, os dados serão enviados pelo 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 registros por aluno.
• 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é 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os dados validados e padronizados, incluindo z-scores e percentis calculados.
• Exemplo de Estrutura de Output:

   {
    "aluno_id": "string",
    "dados_validos": true,
    "academico": { "disciplinas": [{"nome": "string", "periodo": "AAAA-Sn", "nota_normalizada": number, "media_turma": number, "desvio_turma": number, "z_score": number, "percentil_aprox": number }], "z_score_area": {"Matemática": number, "Linguagens": number, "Ciências": number, "Humanas": number}, "percentil_area": {"Matemática": number, "Linguagens": number, "Ciências": number, "Humanas": number} },
    "extracurricular": { "horas_area": {"Matemática": number, ...}, "lideranca_area": {"Matemática": true, ...}, "competicoes": [{"area": "string", "nivel": "municipal", "colocacao": "ouro"}] }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho estimado de 5.000 caracteres por aluno.

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 cálculos estatísticos.
• 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 Especiais (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 Especiais (RF 2).

Determinar, por área, se o aluno apresenta talento especial com base em padrões objetivos de desempenho acadêmico e reforços extracurriculares.

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 o output padronizado do Agente de Validação e Padronização de Dados.
• 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 por aluno.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON detalhando as identificações de talentos por área, incluindo critérios atingidos e evidências.
• Exemplo de Estrutura de Output:

   {
    "aluno_id": "string",
    "identificacoes": [{ "area": "Matemática", "nivel_talento": "avancado", "score_total": 1.2, "criterios_atingidos": ["z_area>=1.5", "percentil_area>=90", "consistencia>=3"], "evidencias": ["Medalha de ouro em competição nacional"] }],
    "status_identificacao": "identificado",
    "lacunas_de_dados": [],
    "justificativa_texto": "O aluno apresentou desempenho excepcional em Matemática com z_score de 1.7 e medalha de ouro em competição nacional." 
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho estimado de 3.000 caracteres por aluno.

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 cálculos de score e avaliação de critérios.
• 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 Preparação de Saída Padronizada (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Preparação de Saída Padronizada (RF 3).

Consolidar por aluno a lista final de talentos identificados e formatar a resposta em JSON padronizado por registro.

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 a lista de identificações geradas pelo Agente de Identificação de Talentos.
• 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 por aluno.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON padronizado por registro de aluno, consolidando as identificações de talentos.
• Exemplo de Estrutura de Output:

   {
    "aluno_id": "string",
    "talentos": [{"area": "Matemática", "nivel": "excepcional", "score": 1.45, "evidencias": ["Medalha de ouro em competição internacional"]}],
    "status": "identificado",
    "resumo": "O aluno destacou-se em Matemática com medalha de ouro e z_score de 2.0.",
    "auditoria": {"criterios": ["z_area>=2.0", "percentil_area>=97"], "lacunas": []}
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho estimado de 2.000 caracteres por aluno.

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 precisa ser passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo, e o JSON padronizado gerado é o resultado que deve ser disponibilizado ao usuário.