Agente de IA para Análise de Feedback de Pais

Converter feedbacks de pais, dados em texto livre após reuniões individuais, em um JSON padronizado, completo 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 de pais em texto livre 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 arquivo de texto na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um texto livre contendo o feedback dos pais.
• Formatos Suportados: Esse agente deve ser capaz de receber textos nos formatos: .txt, .csv.
• 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 único objeto JSON válido, estruturado com as chaves especificadas no exemplo, pronto para análise posterior.
• Exemplo de Estrutura de Output:

   {"feedback_id":"uuid-aleatorio","reuniao_id":"R-2025-11-30-5B-17","data_coleta":"2025-12-01","pai_id":"P-9182","aluno_id":"A-554","turma":"5ºB","texto_normalizado":"A professora demonstra qualidade no atendimento; comunicação sobre eventos é confusa.","idioma":"pt-BR","sentimento_global":"negativo_leve","intensidade_sentimento":-0.3,"categorias":[{"categoria":"comunicacao","sentimento":"negativo","intensidade":-0.6}],"topicos":["eventos","comunicados","clareza"],"urgencia":"media","exemplos_citados":["informações de eventos"],"conta_mencoes_negativas":1,"conta_mencoes_positivas":1,"pii_removida":true}

• Número de caracteres esperado: O JSON gerado deve ser conciso e informativo, com um tamanho estimado de 1.500 caracteres, dependendo da complexidade do feedback.

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 de Padrões de Feedback (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 de Padrões de Feedback (RF 2).

Consolidar múltiplos feedbacks estruturados para identificar padrões, áreas de melhoria priorizadas e sinais de tendência.

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 um array de objetos JSON padronizados, que foram produzidos pelo agente de coleta de feedback.
• 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é 20.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo JSON contendo a análise consolidada dos feedbacks, incluindo padrões, áreas de melhoria e tendências.
• Exemplo de Estrutura de Output:

   {"janela_avaliada":{"inicio":"2025-11-01","fim":"2025-12-01"},"total_feedbacks":128,"distribuicao_sentimento":{"positivo":35,"neutro":22,"negativo_leve":41,"negativo_moderado":22,"negativo_severo":8},"frequencia_por_categoria":[{"categoria":"comunicacao","total":57,"negativos":44,"positivos":6,"neutros":7}],"top_5_topicos":[{"topico":"eventos","ocorrencias":31},{"topico":"tarefas","ocorrencias":24}],"areas_melhoria_priorizadas":[{"categoria":"comunicacao","racional":"alta incidência de menções negativas (77%) e crescimento semanal","prioridade":"alta"}],"tendencias":[{"categoria":"comunicacao","direcao":"alta","var_perc_semanal":+18}],"cortes_por_turma":[{"turma":"5ºB","total":19,"negativos":12}],"citacoes_representativas":["\"Comunicados chegam em cima da hora\"","\"Dificuldade em entender prazos\""]}

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 3.000 caracteres, dependendo da quantidade e complexidade dos feedbacks analisados.

2.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

2.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para calcular distribuições e tendências.
• 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 Geração de Relatórios de Insights (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órios de Insights (RF 3).

Produzir um relatório executivo acionável para a equipe escolar com base na análise consolidada.

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 um único objeto JSON de análise, que foi produzido pelo agente de análise de padrões de feedback.
• 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é 5.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório em markdown estruturado, contendo sumário executivo, KPIs, áreas de melhoria, recomendações acionáveis, tendências e anexos.
• Exemplo de Estrutura de Output:

   **Sumário Executivo**
  - A comunicação foi identificada como a principal área de melhoria, com alta incidência de menções negativas.
  - Recomenda-se ações imediatas para melhorar a clareza e o timing dos comunicados.
  
  **KPIs**
  - Total de Feedbacks: 128
  - Distribuição de Sentimento: Positivo (35), Neutro (22), Negativo Leve (41), Negativo Moderado (22), Negativo Severo (8)
  
  **Top Áreas de Melhoria**
  | Prioridade | Categoria     | Racional                                    | Evidências                   |
  |------------|---------------|---------------------------------------------|------------------------------|
  | Alta       | Comunicação   | Alta incidência de menções negativas (77%) | 57 menções, 44 negativas     |
  
  **Recomendações Acionáveis**
  - **Ação:** Revisar procedimentos de comunicação
    - **Responsável:** Coordenação
    - **Prazo:** Curto (≤30 dias)
    - **Esforço:** Médio
    - **Impacto:** Alto
    - **Métrica de Sucesso:** Reduzir menções negativas em 20%
  
  **Tendências**
  - Comunicação: Alta (+18% variação semanal)
  
  **Anexos**
  - **Cortes por Turma**: 5ºB - 19 Total, 12 Negativos
  - **Citações Representativas**: "Comunicados chegam em cima da hora" - Responsável 1

• Número de caracteres esperado: O relatório gerado terá um tamanho aproximado de 2.000 caracteres, dependendo da quantidade de insights e recomendações.

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 percentuais e métricas.
• 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 (relatório em markdown) é o entregável final e não é passada para outros agentes internos.

3.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 à equipe escolar.