Agente de IA para Avaliação de Necessidades Educacionais Especiais

Definir, a partir dos identificadores do aluno e das fontes disponíveis, os parâmetros padronizados para coleta e consulta de dados acadêmicos, comportamentais e observacionais.

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 JSON com identificadores de alunos e fontes disponíveis 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 JSON na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um JSON contendo identificadores de alunos e fontes disponíveis.
• Formatos Suportados: Esse agente deve ser capaz de receber dados no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 10.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado com os parâmetros de coleta e consulta de dados definidos.
• Exemplo de Estrutura de Output:

   {
    "payload_api": {
      "endpoint": "",
      "filtros": {
        "id_aluno": "",
        "periodo_inicio": "",
        "periodo_fim": "",
        "campos": []
      }
    },
    "parametros_consulta_documentos": {
      "colecao": "",
      "termos_busca": "",
      "filtros_temporais": ""
    },
    "especificacao_normalizacao": {
      "esquema_campos_alvo": [],
      "mapeamentos_unidades": {},
      "regras_deduplificacao": ""
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 1.500 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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 Execução de Chamada à API (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Execução de Chamada à API (RF 2).

Realizar chamada à API do Sistema Escolar para obter dados acadêmicos, de frequência e incidentes comportamentais.

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 JSON contendo o payload de API.
• 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 até 2.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser o JSON bruto retornado pela API com os registros solicitados.
• Exemplo de Estrutura de Output:

  {...}

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

2.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: Não se aplica (uso de ferramenta)

2.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá realizar a chamada à API conforme o payload recebido.

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 Consolidação e Padronização de Dados (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Consolidação e Padronização de Dados (RF 4).

Realizar consulta ao repositório de documentos escolares para recuperar relatórios e observações de professores.

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 1).
• Tipo do input: Este agente deve ser apto a receber como input parâmetros de consulta a documentos escolares.
• 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 até 2.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um conjunto de trechos/itens recuperados contendo {id_documento, data, trecho, metadados}.
• Exemplo de Estrutura de Output:

  [
    {
      "id_documento": "",
      "data": "",
      "trecho": "",
      "metadados": {}
    }
  ]

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

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: Não se aplica (uso de ferramenta)

3.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá realizar a consulta ao repositório de documentos conforme os parâmetros recebidos.

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 Consolidação e Padronização de Dados (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Consolidação e Padronização de Dados (RF 4).

Integrar e padronizar os dados brutos de APIs e documentos em um único esquema analítico.

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 ou RF 3).
• Tipo do input: Este agente deve ser apto a receber dados brutos de APIs e documentos para integração e padronização.
• 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 até 10.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON consolidado com dados integrados e padronizados.
• Exemplo de Estrutura de Output:

   {
    "qualidade_dados": {
      "completude_%": 0,
      "duplicatas_removidas": 0,
      "lacunas_identificadas": []
    },
    "desempenho_academico": [],
    "frequencia": [],
    "comportamento": [],
    "avaliacao_leitura_escrita": [],
    "observacoes_docentes": [],
    "historico_atendimentos": [],
    "linhas_do_tempo": {
      "notas": [],
      "frequencia": [],
      "incidentes": []
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.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 Triagem de Sinais de Necessidades Educacionais (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Triagem de Sinais de Necessidades Educacionais (RF 5).

Detectar sinais objetivos de possíveis necessidades educacionais a partir do consolidado.

5.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 4).
• Tipo do input: Este agente deve ser apto a receber um JSON consolidado e padronizado com dados acadêmicos e comportamentais.
• 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 até 5.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo sinais detectados e indicadores de risco de aprendizagem.
• Exemplo de Estrutura de Output:

   {
    "sinais_detectados": [
      {
        "codigo_sinal": "",
        "descricao": "",
        "severidade": 0,
        "periodo_referente": "",
        "evidencias": []
      }
    ],
    "resumo_metricas": {
      "queda_notas": 0,
      "frequencia_baixa": 0,
      "incidentes_altos": 0,
      "atraso_leitura_escrita": 0
    },
    "indicadores": {
      "risco_aprendizagem": ""
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 3.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 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 Necessidades e Nível de Suporte (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Identificação de Necessidades e Nível de Suporte (RF 6).

Agrupar sinais em categorias de necessidade e estimar nível de suporte pedagógico inicial, sem caráter diagnóstico.

6.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 5).
• Tipo do input: Este agente deve ser apto a receber um JSON com sinais detectados e indicadores de risco de aprendizagem.
• 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 até 3.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo necessidades identificadas, nível de suporte estimado e recomendação de encaminhamento.
• Exemplo de Estrutura de Output:

   {
    "necessidades_identificadas": [
      {
        "categoria": "",
        "sinais_relacionados": [],
        "nivel_suporte": "",
        "urgencia": "",
        "justificativa": ""
      }
    ],
    "prioridade_geral": 0,
    "recomendacao_encaminhamento": {
      "necessita_avaliacao_especializada": false,
      "motivo": ""
    }
  } 

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

6.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

6.3.4 Ferramentas do Agente

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

6.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 Proposição de Adaptações Curriculares (RF 7).

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

Ao concluir sua execução, esse agente aciona o Agente de Proposição de Adaptações Curriculares (RF 7).

Sugerir adaptações curriculares personalizadas alinhadas às necessidades e níveis de suporte estimados.

7.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 6).
• Tipo do input: Este agente deve ser apto a receber um JSON com necessidades identificadas e nível de suporte estimado.
• 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 até 3.000 caracteres.

7.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo adaptações curriculares sugeridas e plano de monitoramento.
• Exemplo de Estrutura de Output:

   {
    "adaptacoes": [
      {
        "categoria_necessidade": "",
        "estrategia": {
          "tipo": "",
          "descricao": ""
        },
        "justificativa": "",
        "evidencias_relacionadas": [],
        "criterio_sucesso": {
          "indicador": "",
          "meta": "",
          "prazo_semanas": 0
        },
        "impacto_esperado": ""
      }
    ],
    "plano_monitoramento": {
      "frequencia_semanal": 0,
      "revisao_em_semanas": 0
    }
  } 

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

7.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

7.3.4 Ferramentas do Agente

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

7.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 Relatórios Educacionais (RF 8).

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

Ao concluir sua execução, esse agente aciona o Agente de Relatórios Educacionais (RF 8).

Gerar relatórios claros para educadores e administradores com foco em intervenção e acompanhamento.

8.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 7).
• Tipo do input: Este agente deve ser apto a receber um JSON com sinais detectados, necessidades identificadas, adaptações e indicadores de risco de aprendizagem.
• 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 até 5.000 caracteres.

8.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo relatórios para educadores e administradores.
• Exemplo de Estrutura de Output:

   {
    "relatorio_para_educadores": "",
    "relatorio_para_administradores": "",
    "sumario_exec": {
      "risco_aprendizagem": "",
      "prioridades": [],
      "proximo_marco_revisao": ""
    }
  } 

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

8.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

8.3.4 Ferramentas do Agente

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

8.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.

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

A execução deste agente finaliza o fluxo. Os relatórios gerados são o resultado que deve ser disponibilizado aos usuários.