Agente de IA para Acompanhamento de Desenvolvimento Infantil

Unificar e estruturar registros de progresso escolar em um JSON padronizado por aluno, consolidando observações, avaliações e metadados prontos 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 um conjunto de registros acadêmicos e observacionais 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 dos arquivos na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um conjunto de registros acadêmicos e observacionais dos alunos.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .csv, .xlsx, .txt, .docx, .pdf.
• 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 padronizado por aluno, contendo observações, avaliações e metadados prontos para análise.
• Exemplo de Estrutura de Output:

   {
    "alunos": [
      {
        "aluno_id": "A123",
        "nome": "Nome da Criança",
        "idade_meses": 72,
        "serie": "1º ano",
        "turma": "A",
        "metadados": {
          "escola": "",
          "periodo_avaliado": {"inicio": "2025-02-01", "fim": "2025-06-30"},
          "fontes_presentes": ["professor_regente", "coordenacao", "familia"]
        },
        "observacoes": [
          {
            "id": "obs_0001",
            "data": "2025-03-12",
            "fonte": "professor_regente",
            "dominio_informado": "linguagem",
            "dominio_canonico": "linguagem",
            "texto": "Leu sílabas simples com apoio.",
            "contexto": "sala",
            "frequencia": "as_vezes",
            "nivel_apoio": "apoio_leve",
            "evidencias": ["foto_atividade_123.jpg"],
            "pontuacao_instrumento": {"instrumento": "Rubrica Leitura 1º ano", "escala": "0-4", "valor": 2}
          }
        ],
        "avaliacoes": [
          {
            "id": "av_0001",
            "data": "2025-04-05",
            "instrumento": "Prova Diagnóstica Matemática",
            "escala": "0-100",
            "nota": 65,
            "dominio_canonico": "cognitivo"
          }
        ],
        "mapeamento_dominios": {
          "cognitivo": [],
          "socioemocional": [],
          "emocional": [],
          "linguagem": [],
          "motricidade_fina": [],
          "motricidade_grossa": []
        }
      }
    ]
  }

• Número de caracteres esperado: O JSON gerado 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 Análise e Geração de Insights de Desenvolvimento (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 e Geração de Insights de Desenvolvimento (RF 2).

Avaliar o desenvolvimento por domínio para cada aluno, identificar progressos, necessidades de atenção, tendências e prioridades, e sintetizar recomendações acionáveis.

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 um objeto JSON padronizado produzido pelo Agente de Normalização e Estruturação de Registros.
• 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é 12.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON contendo insights por aluno e visão geral da turma.
• Exemplo de Estrutura de Output:

   {
    "insights_por_aluno": [
      {
        "aluno_id": "A123",
        "resumo": "Progresso consistente em linguagem; atenção para autorregulação.",
        "status_dominios": {
          "cognitivo": {"classificacao": "esperado", "justificativa": "Notas 60–70/100 e resolução de problemas observada"},
          "socioemocional": {"classificacao": "atencao", "justificativa": "Dificuldades em turnos de fala reportadas em 3 contextos"},
          "emocional": {"classificacao": "atencao", "justificativa": "Apoio moderado necessário em transições"}
        },
        "tendencias": {
          "linguagem": {"delta_90d": "+12", "unidade": "pontos_escala_0_100", "confianca": "media"}
        },
        "flags_risco": ["regressao_pontual_emocional", "baixa_consistencia_observacional"],
        "recomendacoes_priorizadas": [
          {"acao": "Rotinas de transição com pistas visuais", "contexto": "sala", "prioridade": 1, "justificativa": "Crises em mudanças 2x/semana"},
          {"acao": "Grupos cooperativos com papéis definidos", "contexto": "sala", "prioridade": 2, "justificativa": "Aprimorar turnos de fala"}
        ],
        "proximos_passos_sugeridos": {"monitorar": ["autorregulação em transições", "cooperação em grupo"], "reavaliar_em": "2026-02-15"}
      }
    ],
    "visao_geral_turma": {
      "coorte": {
        "n_alunos": 25,
        "distribuicao_por_status": {
          "cognitivo": {"adiantado": 4, "esperado": 17, "atencao": 4},
          "socioemocional": {"adiantado": 3, "esperado": 15, "atencao": 7},
          "emocional": {"adiantado": 2, "esperado": 18, "atencao": 5}
        },
        "top_needs": ["autorregulação", "turnos de fala"],
        "top_progressos": ["consciência fonêmica", "contagem até 100"]
      }
    }
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 8.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.
• Calculadora: Utiliza lógica interna para calcular tendências e classificações.
• 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 gerada por este agente deve ser visível para o Agente de Geração de Relatório para Educadores (RF 3) e o Agente de Geração de Relatório para Pais/Responsáveis (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 Relatório para Educadores (RF 3).

Gerar relatório técnico acessível a docentes, com recomendações aplicáveis em sala, evidências rastreáveis e visão de coorte para planejamento pedagógico.

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 com "insights_por_aluno" e "visao_geral_turma".
• 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.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório técnico em Markdown, acessível a docentes, com recomendações aplicáveis em sala, evidências rastreáveis e visão de coorte para planejamento pedagógico.
• Exemplo de Estrutura de Output:

  # Relatório de Desenvolvimento – Educadores
  
  ## Resumo executivo
  - Turma:  - 
  - Período:  a 
  - Principais necessidades: 
  - Principais progressos: 
  
  ## Visão geral da turma
  - Distribuição por domínio (adiantado/esperado/atenção)
  - Alertas recorrentes: 
  
  ## Relatórios por aluno
  ###  (ID: )
  - Idade (meses): 
  - Status por domínio: 
  - Tendências (90 dias): 
  - Recomendações priorizadas:
    1.  — contexto:  — justificativa (obs/av: )
  - Próximos passos: monitorar ; reavaliar em 
  
  ## Anexo (Instrumentos e rubricas)
  - Lista de instrumentos, escalas e critérios sintéticos
  

• Número de caracteres esperado: O relatório gerado 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.
• 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 gerada por este agente deve ser visível para o Agente de Validação de Consistência e Privacidade (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Validação de Consistência e Privacidade (RF 5).

Produzir relatório em linguagem simples e acolhedora para famílias, com sugestões práticas de atividades em casa alinhadas às necessidades identificadas.

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 2).
• Tipo do input: Este agente deve ser apto a receber como input um objeto JSON com "insights_por_aluno".
• 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.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório em Markdown, em linguagem simples e acolhedora, com sugestões práticas de atividades em casa.
• Exemplo de Estrutura de Output:

  # Relatório de Acompanhamento – Famílias
  
  Olá! Preparamos um resumo do desenvolvimento de  no período  a .
  
  ## Como  está indo
  - Pontos fortes: 
  - O que vamos apoiar nos próximos meses: 
  
  ## Sugestões de atividades em casa
  - Atividade 1:  (10–15 min, 3x/sem)
  - Atividade 2: 
  
  ## Como acompanhar
  - Sinais de progresso: 
  - Quando vamos rever: 
  
  ## Fale conosco
  - Espaço para comentários da família
  

• Número de caracteres esperado: O relatório gerado terá um tamanho estimado em torno de 4.000 caracteres.

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 gerada por este agente deve ser visível para o Agente de Validação de Consistência e Privacidade (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Validação de Consistência e Privacidade (RF 5).

Verificar conformidade estrutural, consistência interna e respeito à privacidade dos outputs anteriores antes de distribuição.

5.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão dos agentes anteriores (RF 3 ou RF 4).
• Tipo do input: Este agente deve ser apto a receber qualquer um dos outputs produzidos pelos agentes de relatório (educadores ou pais) acompanhado do JSON de insights correspondente.
• 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 JSON indicando a conformidade estrutural, consistência interna e respeito à privacidade dos outputs anteriores.
• Exemplo de Estrutura de Output:

  {
    "validacao": {
      "schema_ok": true,
      "rastreabilidade_ok": true,
      "privacidade_ok": true,
      "itens_incorretos": [
        {"tipo": "rastreabilidade", "descricao": "Recomendação sem referência a evidência", "aluno_id": "A123"}
      ],
      "pronto_para_envio": true
    }
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.000 caracteres.

5.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

5.3.4 Ferramentas do Agente

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

5.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta gerada por este agente é o entregável 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. A validação gerada é o resultado que deve ser disponibilizado ao usuário.