Agente de IA para Assistência em Reuniões de Pais e Mestres

Converter a solicitação do usuário em parâmetros de consulta prontos para recuperar dados no documento 'dados_desempenho_alunos'.

1.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente é o ponto de partida do fluxo e deve ser acionado pela solicitação do usuário via interface conversacional. Na fase de testes, o fluxo será iniciado pelo envio manual dos dados na interface da Prototipe AI para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é uma solicitação do usuário contendo informações sobre aluno, turma, período, disciplinas e métricas.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs em texto estruturado.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input com até 1.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo os parâmetros de consulta definidos.
• Exemplo de Estrutura de Output:

   {
    "parametros_consulta": {
      "documento": "dados_desempenho_alunos",
      "identificadores": {"aluno_normalizado": "JOAO SILVA", "turma": "7B"},
      "filtros": {"periodo": {"tipo": "bimestre", "valor": 2, "ano": 2025}},
      "campos": ["disciplina", "nota", "frequencia", "participacao", "data_avaliacao"],
      "granularidade": "avaliacao",
      "limite_registros": 500
    },
    "parametros_consulta_definidos": true
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 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 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 Execução de Consulta a Documento (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 Consulta a Documento (RF 2).

Realizar consulta ao documento 'dados_desempenho_alunos' para obter dados brutos de avaliações, notas e frequência do aluno informado.

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 contendo os parâmetros de consulta.
• 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 com até 1.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo os dados brutos de desempenho recuperados.
• Exemplo de Estrutura de Output:

   {
    "dados_brutos": [
      {"disciplina": "Matemática", "nota": 8.2, "frequencia": 0.94, "participacao": 0.7, "data_avaliacao": "2025-04-15"},
      {"disciplina": "Português", "nota": 6.5, "frequencia": 0.88, "participacao": 0.6, "data_avaliacao": "2025-04-20"}
    ],
    "consulta_documento_sucesso": true
  }

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

2.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

2.3.4 Ferramentas do Agente

• Documentos: O agente deve acessar o documento 'dados_desempenho_alunos' para realizar a consulta.
• 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 Consolidação e Normalização de Dados de Desempenho (RF 3).

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

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

Padronizar os dados brutos recuperados, calcular indicadores chave e preparar um resumo acionável para uso em reuniões.

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 contendo os dados brutos de desempenho do 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 com até 1.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo os dados de desempenho normalizados e um resumo acionável.
• Exemplo de Estrutura de Output:

   {
    "aluno": "João da Silva",
    "turma": "7B",
    "periodo": {"tipo": "bimestre", "valor": 2, "ano": 2025},
    "disciplinas": [
      {
        "nome": "Matemática",
        "avaliacoes": [
          {"data": "2025-04-15", "nota": 8.2, "participacao": 0.7}
        ],
        "media_periodo": 8.2,
        "frequencia_periodo": 0.94,
        "tendencia": "estável"
      }
    ],
    "resumo": {
      "situacoes_alerta": ["frequencia_baixa_Português"],
      "forcas": ["desempenho_consistente_Matemática"],
      "intervencoes_sugeridas_curto_prazo": ["reforco_conteudo_leitura_portugues"]
    },
    "sinalizadores": {"dados_suficientes": true, "faltas_excessivas": false},
    "dados_desempenho_normalizados_disponiveis": true
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.500 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 documentos externos.
• Calculadora: Utiliza lógica interna para calcular indicadores chave.
• 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 deve ser visível para o Agente de Sugestão de Tópicos de Discussão (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Sugestão de Tópicos de Discussão (RF 4).

Gerar, a partir dos dados normalizados, uma pauta priorizada com tópicos de discussão, agenda e perguntas-chave para condução da reunião.

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 contendo os dados de desempenho normalizados.
• 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 com até 1.500 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo a agenda da reunião, tópicos priorizados e perguntas-chave.
• Exemplo de Estrutura de Output:

   {
    "agenda": {
      "duracao_total_min": 25,
      "itens": [
        {"ordem": 1, "topico": "Reconhecimentos", "tempo_min": 3},
        {"ordem": 2, "topico": "Português - queda de desempenho e frequência", "tempo_min": 12},
        {"ordem": 3, "topico": "Plano de ação e metas SMART", "tempo_min": 8},
        {"ordem": 4, "topico": "Próximos passos e acompanhamento", "tempo_min": 2}
      ]
    },
    "topicos_priorizados": [
      {
        "categoria": "reforco",
        "titulo": "Português: foco em compreensão leitora",
        "prioridade": 1,
        "justificativa": "média 6.5 (<6.0 é alerta iminente) e tendência de queda; frequência 0.88",
        "acoes_sugeridas": [
          "2 sessões semanais de leitura guiada (20-30 min)",
          "Lista de textos curtos alinhados ao conteúdo do bimestre",
          "Revisão de vocabulário antes das leituras"
        ]
      }
    ],
    "perguntas_chave": [
      "Quais horários em casa funcionam melhor para leitura?",
      "Há fatores que têm impactado a frequência às aulas?",
      "O estudante relata dificuldades específicas nos gêneros textuais trabalhados?"
    ]
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 2.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 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 é 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. A agenda gerada é o resultado que deve ser disponibilizado ao usuário.