Agente de IA para Criação de Relatórios Psicopedagógicos

Receber dados brutos acadêmicos e comportamentais de múltiplas fontes e padronizar em um esquema único, validando consistência, integridade e preparando-os 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 dados brutos de múltiplas fontes 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 de um csv na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um arquivo csv contendo dados brutos de alunos.
• Formatos Suportados: Esse agente deve ser capaz de receber arquivos nos formatos: .csv.
• 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 objeto JSON contendo os dados padronizados dos alunos e um relatório de qualidade dos dados processados.
• Exemplo de Estrutura de Output:

   {
    "alunos": [
      {
        "aluno_id": "...",
        "identificacao": {"nome": "...", "turma": "...", "data_nascimento": "AAAA-MM-DD"},
        "academico": [ {...} ],
        "comportamental": [ {...} ]
      }
    ],
    "data_quality_report": {"registros_processados": n, "registros_com_erro": n, "campos_faltantes": ["..."], "normalizacoes_aplicadas": ["..."], "padronizacao_realizada": "sim|nao"}
  } 

• Número de caracteres esperado: O texto final deve ser conciso e informativo, com um tamanho estimado em torno de 5.000 caracteres, podendo variar conforme a quantidade de alunos e 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 Integração e Enriquecimento de Dados (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Integração e Enriquecimento de Dados (RF 2).

Integrar dados padronizados por aluno, calcular indicadores acadêmicos e comportamentais e gerar um perfil consolidado para suportar a elaboração do relatório.

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 padronizado, que corresponde aos dados processados 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é 50.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo os perfis consolidados dos alunos, com indicadores acadêmicos e comportamentais calculados.
• Exemplo de Estrutura de Output:

   {
    "perfis_alunos": [
      {
        "aluno_id": "...",
        "resumo_academico": {"medias_por_disciplina": {...}, "media_geral": n, ...},
        "resumo_comportamental": {"padrões": [...], "intensidade_media_1_5": n, ...},
        "hipoteses_pedagogicas_preliminares": [...],
        "dados_referencia": {"periodo_analise": "AAAA", ...}
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 10.000 caracteres, variando conforme a quantidade de dados 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.
• Calculadora: Utiliza lógica interna para calcular indicadores acadêmicos e comportamentais.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 (JSON consolidado) deve ser visível para o Agente de Geração de Relatório Psicopedagógico (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 Relatório Psicopedagógico (RF 3).

Produzir relatório psicopedagógico detalhado e personalizado por aluno, transformando os perfis consolidados em análises, recomendações e plano de acompanhamento prático.

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 objeto JSON consolidado, que corresponde aos perfis gerados 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é 50.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo relatórios psicopedagógicos detalhados e personalizados para cada aluno.
• Exemplo de Estrutura de Output:

   {
    "relatorios": [
      {
        "aluno_id": "...",
        "identificacao": {"nome": "...", "turma": "...", "data_nascimento": "AAAA-MM-DD"},
        "resumo_executivo": "...",
        "forcas": [...],
        "areas_de_atencao": [...],
        "analise_academica": {...},
        "analise_comportamental": {...},
        "hipoteses_pedagogicas": [...],
        "recomendacoes": [...],
        "plano_de_acompanhamento": {...},
        "anexos_evidencias": [...]
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 20.000 caracteres, variando conforme a quantidade de dados 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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 (JSON dos relatórios) deve ser visível para o Agente de Preparação de Entrega e Acessibilidade do Relatório (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Preparação de Entrega e Acessibilidade do Relatório (RF 4).

Facilitar o acesso e a compreensão por educadores e pais, formatando saídas em diferentes níveis de detalhe e gerando versões adequadas ao público.

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 como input um objeto JSON dos relatórios gerados 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é 50.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo as versões dos relatórios adaptadas para pais, educadores e uma cheat sheet para sala de aula.
• Exemplo de Estrutura de Output:

   {
    "entregaveis": [
      {
        "aluno_id": "...",
        "versao_para_pais": {"linguagem_simples": true, "resumo_executivo": "...", ...},
        "versao_tecnica_educadores": {"secao_detalhada": "...", ...},
        "cheat_sheet_sala": ["..."]
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 15.000 caracteres, variando conforme a quantidade de dados por aluno.

4.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

4.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 (JSON dos entregáveis) é o entregável final e não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo. Os entregáveis gerados são o resultado que deve ser disponibilizado ao usuário.