Agente de IA para Análise de Satisfação de Pais e Alunos

Receber respostas brutas de pais e alunos (texto livre ou formulários) e convertê-las em um JSON padronizado, deduplicado e pronto 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 feedbacks brutos de pais e 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 na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é uma lista de objetos representando feedbacks brutos.
• 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 de texto com até 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser uma lista de objetos JSON normalizados com campos padronizados.
• Exemplo de Estrutura de Output:

   [{
    "id_feedback": "uuid",
    "id_original": "original_id",
    "origem": "formulario",
    "remetente_tipo": "pai",
    "canal": "email",
    "datahora_iso": "2025-12-10T08:22:00Z",
    "idioma_origem": "en",
    "idioma_normalizado": "pt-BR",
    "texto_original": "Original text",
    "texto_limpo": "Texto limpo",
    "consentimento": "sim",
    "anonimo": "nao",
    "unidade_escolar": "Escola ABC",
    "serie_turma": "5A",
    "metadados": {},
    "registro_valido": "sim",
    "motivo_invalidacao": null,
    "hash_conteudo": "hash",
    "deduplicado": "nao"
  }]

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 5.000 caracteres, podendo variar conforme a quantidade de feedbacks processados.

1.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.5

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 Classificação de Tema, Subtema e Sentimento (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Classificação de Tema, Subtema e Sentimento (RF 2).

Classificar cada feedback em uma taxonomia de temas/subtemas e atribuir sentimento e emoção, permitindo múltiplas categorias por item.

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 uma lista de feedbacks padronizados e válidos.
• 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é 50.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser a mesma lista com campos adicionais para temas, subtemas, palavras-chave, sentimento, intensidade, emoção, evidências e classificação concluída.
• Exemplo de Estrutura de Output:

   [{
    "id_feedback": "uuid",
    "temas": ["Infraestrutura", "Ensino"],
    "subtemas": ["salas", "qualidade_didática"],
    "palavras_chave": ["termo1", "termo2"],
    "sentimento": "positivo",
    "intensidade_sentimento": 1,
    "emocao": "alegria",
    "evidencias_classificacao": ["Exemplo de evidência."],
    "classificacao_concluida": true
  }]

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 4.000 caracteres, podendo variar conforme a quantidade de feedbacks processados.

2.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.5

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 Sinalização de Incidentes Críticos (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Sinalização de Incidentes Críticos (RF 3).

Detectar e sinalizar feedbacks que indicam risco imediato ou temas sensíveis que exijam atenção rápida da administração.

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 feedbacks com classificação concluída.
• 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é 40.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser a mesma lista com campos adicionais para sinalização de incidentes críticos, categoria de incidente, urgência, resumo de ação imediata e justificativa de sinalização.
• Exemplo de Estrutura de Output:

   [{
    "id_feedback": "uuid",
    "incidente_critico": true,
    "categoria_incidente": "bullying_discriminacao",
    "urgencia": 2,
    "resumo_acao_imediata": "Acionar equipe de orientação e contatar responsáveis em 24h",
    "justificativa_sinalizacao": "Exemplo de citação do feedback."
  }]

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 3.500 caracteres, podendo variar conforme a quantidade de feedbacks processados.

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.5

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

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 Agregação e Métricas (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Agregação e Métricas (RF 4).

Consolidar os feedbacks classificados em métricas e distribuições por período e segmentos (unidade, série/turma, remetente).

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 feedbacks com temas, sentimentos e sinalizações, além do período de referência e segmentos.
• 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é 50.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON consolidando as métricas e distribuições por período e segmentos.
• Exemplo de Estrutura de Output:

   {
    "periodo_referencia": "Dezembro 2025",
    "totais": {
      "volume_total": 100,
      "volume_validos": 90,
      "volume_incidentes": 5
    },
    "sentimento": {
      "pct_positivo": 45.0,
      "pct_neutro": 35.0,
      "pct_negativo": 20.0,
      "score_medio": 0.75
    },
    "distribuicoes_por_tema": ["Infraestrutura", "Ensino"],
    "distribuicoes_por_subtema": ["salas", "qualidade_didática"],
    "top_palavras_chave": ["termo1", "termo2"],
    "segmentos": [
      {
        "segmento": "unidade",
        "chaves": ["Escola ABC"],
        "métricas": {
          "volume_total": 50,
          "volume_validos": 45,
          "volume_incidentes": 3
        }
      }
    ],
    "amostras_citacoes": ["Exemplo de citação."]
  }

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 6.000 caracteres, podendo variar conforme a quantidade de feedbacks processados.

4.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.5

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 Insights e Recomendações (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 Insights e Recomendações (RF 5).

Transformar métricas e feedbacks em insights acionáveis e priorizados para melhoria institucional.

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 métricas agregadas e uma lista sintetizada de feedbacks classificados.
• 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é 30.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser uma lista de insights estruturados com título, tipo, descrição, evidências, impacto esperado, recorrência, prioridade, área responsável sugerida, indicadores sugeridos e horizonte de implantação.
• Exemplo de Estrutura de Output:

   [{
    "titulo": "Melhoria na Infraestrutura",
    "tipo": "oportunidade",
    "descricao": "Identificamos uma necessidade de melhoria nas salas de aula. Passos recomendados: 1. Revisar infraestrutura, 2. Planejar reformas, 3. Implementar melhorias.",
    "evidencias": ["50% das menções foram negativas."],
    "impacto_esperado": "medio",
    "recorrencia": "media",
    "prioridade": "P2",
    "area_responsavel_sugerida": "Manutenção",
    "indicadores_sugeridos": [{"nome": "Índice de Satisfação por Tema", "objetivo": "Medir a satisfação geral", "formula": "média normalizada de intensidades de sentimento no tema"}],
    "horizonte_implantacao": "medio"
  }]

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 4.500 caracteres, podendo variar conforme a quantidade de insights gerados.

5.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.5

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 deve ser visível para o Agente de Relatório Executivo (RF 6).

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

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

Gerar um relatório claro e acionável para a administração escolar com visão geral, detalhes por tema e próximos passos.

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 métricas agregadas e uma lista de insights priorizados.
• 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é 20.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório em texto estruturado (markdown) contendo capa, sumário executivo, panorama geral, destaques, detalhes por tema, incidentes críticos, plano de ação sugerido e apêndice metodológico.
• Exemplo de Estrutura de Output:

   "# Relatório Executivo - Dezembro 2025\n\n## Sumário Executivo\n- Feedbacks positivos em infraestrutura destacam melhorias.\n- Necessidade de atenção em segurança escolar.\n\n## Panorama Geral\n- Volume total de feedbacks: 100\n- Sentimento geral: 45% positivo, 35% neutro, 20% negativo\n\n## Destaques\n- Infraestrutura: 50% das menções foram positivas, indicando melhorias.\n- Segurança: 20% das menções foram negativas, indicando necessidade de atenção.\n\n## Detalhes por Tema\n### Infraestrutura\n- Principais menções: salas de aula, manutenção.\n- Recomendações: 1. Revisar infraestrutura, 2. Planejar reformas, 3. Implementar melhorias.\n\n## Incidentes Críticos\n- Bullying: 3 incidentes registrados.\n- Ações sugeridas: Reforçar protocolos de segurança.\n\n## Plano de Ação Sugerido\n- Infraestrutura: Revisar e implementar melhorias até março de 2026.\n\n## Apêndice Metodológico\n- Taxa de resposta desconhecida.\n- Amostras podem estar desbalanceadas."

• Número de caracteres esperado: O relatório final deve ser conciso e informativo, com um tamanho estimado em torno de 10.000 caracteres, podendo variar conforme a quantidade de informações processadas.

6.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.5

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

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

6.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 à administração escolar.