Agente de IA para Análise de Dados de Avaliações Psicopedagógicas

Validar estrutura e qualidade dos dados de avaliações psicopedagógicas, padronizar escalas e preparar um dataset coerente para análise.

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/CSV com avaliações psicopedagógicas 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 arquivo na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é uma planilha/CSV com dados de avaliações psicopedagógicas.
• Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .csv, .xls, .xlsx.
• 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: schema_validado, motivos_falha_schema, dados_normalizados, relatorio_qualidade, transformacoes_aplicadas, dicionario_variaveis, chaves_registro.
• Exemplo de Estrutura de Output:

   {
    "schema_validado": true,
    "motivos_falha_schema": [],
    "dados_normalizados": [...],
    "relatorio_qualidade": {
      "total_registros_entrada": 1000,
      "total_validos": 980,
      "total_invalidos": 20,
      "pct_faltantes_por_variavel": {...},
      "n_outliers_tratados": 5,
      "n_duplicidades_resolvidas": 3
    },
    "transformacoes_aplicadas": [...],
    "dicionario_variaveis": {...},
    "chaves_registro": {"id_aluno": "string", "data_avaliacao": "string"}
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.000 caracteres, variando conforme a complexidade dos dados processados.

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 Análise Estatística e Identificação de Padrões (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Análise Estatística e Identificação de Padrões (RF 2).

Calcular estatísticas descritivas, correlações e tendências temporais para variáveis cognitivas e emocionais.

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 JSON contendo os dados_normalizados preparados pelo agente anterior.
• 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.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON contendo: estatisticas_descritivas, correlacoes_relevantes, tendencias_temporais, discrepancias_cog_emoc, confiabilidade_medidas, parametros_utilizados.
• Exemplo de Estrutura de Output:

   {
    "estatisticas_descritivas": {...},
    "correlacoes_relevantes": [...],
    "tendencias_temporais": [...],
    "discrepancias_cog_emoc": [...],
    "confiabilidade_medidas": [...],
    "parametros_utilizados": {...}
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 7.000 caracteres, variando conforme a complexidade dos dados processados.

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 Insights Psicopedagógicos (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Insights Psicopedagógicos (RF 4).

Comparar resultados dos alunos com benchmarks/coortes de referência quando fornecidos.

3.3.1 Condições de Ativação

Este agente é acionado somente se a seguinte condição for atendida:

• O campo inclui_benchmark_referencia está presente e é true.

3.3.2 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado condicionalmente após a conclusão do agente anterior (RF 2), apenas se benchmarks de referência forem incluídos.
• Tipo do input: Este agente deve ser apto a receber dados_normalizados e dicionario_variaveis do Agente 1, estatisticas_descritivas do Agente 2, e uma tabela_benchmark.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input combinado de até 15.000 caracteres.

3.3.3 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON contendo: comparativos_por_variavel, classificacao_relativa, gaps, observacoes_benchmark.
• Exemplo de Estrutura de Output:

   {
    "comparativos_por_variavel": [...],
    "classificacao_relativa": [...],
    "gaps": [...],
    "observacoes_benchmark": [...]
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 6.000 caracteres, variando conforme a complexidade dos dados processados.

3.3.4 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

3.3.5 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.6 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 Insights Psicopedagógicos (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Insights Psicopedagógicos (RF 4).

Transformar achados estatísticos em insights acionáveis e recomendações pedagógicas, evitando linguagem diagnóstica clínica.

4.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 2 ou RF 3).
• Tipo do input: Este agente deve ser apto a receber achados dos agentes anteriores, incluindo estatisticas_descritivas, correlacoes_relevantes, tendencias_temporais, discrepancias_cog_emoc e, se existir, comparativos_por_variavel.
• 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 combinado de até 12.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON contendo: insights_acionaveis, mapa_forcas_dificuldades, riscos_e_cuidados, escopo_limites.
• Exemplo de Estrutura de Output:

   {
    "insights_acionaveis": [...],
    "mapa_forcas_dificuldades": [...],
    "riscos_e_cuidados": [...],
    "escopo_limites": [...]
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 8.000 caracteres, variando conforme a complexidade dos dados processados.

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 Geração de Relatório Estruturado (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Relatório Estruturado (RF 5).

Compilar relatório em Markdown com narrativa clara para educadores, incluindo sumário executivo, achados e recomendações.

5.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 4).
• Tipo do input: Este agente deve ser apto a receber um JSON de insights_acionaveis, mapa_forcas_dificuldades e anexos estatísticos dos agentes anteriores.
• 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 até 15.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório em formato Markdown, com seções claramente definidas: 1) Sumário Executivo; 2) Metodologia e Limitações; 3) Achados Principais; 4) Recomendações e Plano de Acompanhamento; 5) Indicadores e Metas; 6) Considerações Éticas e Privacidade; 7) Anexos Técnicos.
• Exemplo de Estrutura de Output:

   # Sumário Executivo
  - Ponto chave 1
  - Ponto chave 2
  
  # Metodologia e Limitações
  Descrição...
  
  # Achados Principais
  - Achado 1
  - Achado 2
  
  # Recomendações e Plano de Acompanhamento
  - Ação 1
  - Ação 2
  
  # Indicadores e Metas
  - Indicador 1
  - Indicador 2
  
  # Considerações Éticas e Privacidade
  - Consideração 1
  
  # Anexos Técnicos
  - Anexo 1
  - Anexo 2 

• Número de caracteres esperado: O relatório final terá um tamanho aproximado de 10.000 caracteres, variando conforme a complexidade dos dados processados.

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 resultado final e não é passada para outros agentes internos.

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.