Agente de IA para Relatório de Reuniões com Pais

29 de November de 2025 • Tempo de leitura: 5 min

Como criar um agente de IA que sintetiza os pontos discutidos nas reuniões individuais com pais.

1. Propósito e Escopo

Este documento define todos os prompts, configurações de memória, transição entre estados e demais requisitos funcionais para o Fluxo de Agentes "Relatório de Reuniões com Pais", uma solução de automação projetada para sintetizar os pontos discutidos em reuniões individuais com pais, gerando um resumo que é enviado aos responsáveis e professores envolvidos. Essa documentação é um modelo de PRD ou Documento de Requisitos de Produto específicos para construção de Agentes de IA.

O objetivo principal é transformar o conteúdo da reunião em um relatório claro e conciso, que facilite a comunicação entre pais e professores, garantindo a segurança e privacidade das informações discutidas.

2. Contexto e Problema

Cenário Atual

As reuniões entre pais e professores são momentos cruciais para discutir o progresso dos alunos, mas frequentemente não há um registro detalhado e acessível dos pontos discutidos. Essa falta de documentação pode levar a falhas de comunicação e perda de informações importantes.


Problemas Identificados

  • Falta de registro detalhado: Não há uma documentação padrão e acessível dos pontos discutidos nas reuniões.
  • Comunicação ineficiente: A falta de clareza e eficiência na comunicação entre pais e professores pode resultar em mal-entendidos.

3. Impactos Esperados

A implementação deste fluxo de automação visa alcançar os seguintes resultados:

  • Melhorar a documentação das reuniões, garantindo registros detalhados e acessíveis.
  • Aumentar a clareza e eficiência na comunicação entre pais e professores.
  • Garantir a segurança e privacidade das informações discutidas.

4. Visão Geral da Solução

O agente de IA para relatório de reuniões com pais captura e sintetiza automaticamente os pontos discutidos durante as reuniões, gera um resumo claro e conciso e garante a segurança e privacidade das informações. A seguir são detalhadas todas as regras de negócio e especificações funcionais necessárias para que esse agente atue como um assistente útil e autônomo na geração de relatórios de reuniões com pais.

A solução consiste em um fluxo de automação composto por 3 agentes de IA. O processo inicia com a extração e normalização dos dados da reunião e termina com a geração de resumos diferenciados para responsáveis e professores.

A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo.

Agentes Função Principal
Agente de Extração e Normalização da Reunião com Pais (RF 1) Extrair, identificar participantes e padronizar o conteúdo da reunião em um JSON estruturado.
Agente de Validação de Privacidade e Conformidade (RF 2) Revisar o conteúdo estruturado, aplicar minimização de dados e produzir um pacote saneado para síntese.
Agente de Síntese e Geração de Resumos para Responsáveis e Professores (RF 3) Produzir resumos claros, concisos e diferenciados por público a partir do conteúdo saneado da reunião.

5. Protótipos

Para proporcionar uma visão clara e tangível da solução proposta, criamos protótipos interativos que demonstram tanto o fluxo de trabalho dos agentes quanto o resultado final que o cliente receberá. Explore os links abaixo para entender melhor a solução em ação.

6. Requisitos Funcionais

RF 1. Agente de Extração e Normalização da Reunião com Pais

1.1 Tarefa do Agente

Extrair, identificar participantes e padronizar o conteúdo de reuniões individuais com pais (áudio, vídeo, texto ou notas) em um JSON estruturado com transcrição segmentada, metadados e tópicos.

1.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um dos seguintes inputs: 1) arquivo de áudio (.mp3, .wav, .m4a) ou vídeo (.mp4), 2) documento de texto (.txt, .docx, .pdf), 3) bloco de texto colado contendo notas/transcrição; metadados opcionais em JSON com as chaves: {"aluno": {"nome": "string"}, "responsaveis": [{"nome":"string","email":"string?"}], "professores": [{"nome":"string","email":"string?"}], "data_reuniao": "YYYY-MM-DD", "hora_inicio": "HH:MM", "local": "string", "turma": "string", "disciplina": "string"}.

# 2. Objetivo
Extrair, identificar participantes e padronizar o conteúdo de reuniões individuais com pais em um JSON estruturado com transcrição segmentada, metadados e tópicos.

# 3. Regras que você deve seguir para gerar sua resposta
- Regra 1 (Segmentação de falas): Separe por turnos. Cada turno deve conter falante, texto e, quando disponível, ts_inicio e ts_fim (HH:MM:SS). Se não houver marcação temporal, use null para ambos os campos.
- Regra 2 (Inferência de papéis): Para cada falante, tente inferir papel com base em autoidentificação, vocativo (ex.: "mãe do Lucas"), ou contexto. Se não inequívoco, use null.
- Regra 3 (Normalização textual): Corrija erros que prejudiquem compreensão sem alterar sentido. Marque incertezas como [inaudível] ou [incerto] sem inventar conteúdo.
- Regra 4 (Metadados e duração): Preencha duracao_estimado_min com base em duração conhecida; se desconhecida e houver transcrição segmentada, estime por contagem de turnos e ritmo médio (marque como estimado na observacao interna, não criar novo campo).
- Regra 5 (Detecção de tópicos): Classifique tópicos brutos a partir de semântica, usando categorias escolares comuns: assiduidade, comportamento, desempenho (por disciplina), apoio pedagógico, comunicação família-escola, prazos/tarefas, recursos/acomodações, próximos encontros.
- Regra 6 (Idiomas e código misto): Defina idioma_detectado (default pt-BR). Preserve trechos em outro idioma; adicione tradução entre colchetes apenas quando necessário para entendimento do tópico.
- Regra 7 (Minimização de terceiros): Quando terceiros forem citados (pessoas fora da reunião), reduza nomes completos a iniciais (ex.: "Sra. M.") no texto da transcrição; mantenha sentido.
- Regra 8 (Sinalização de sensíveis): Popule menções_sensiveis_brutas com trechos relacionados a saúde, situação socioeconômica, ou dados de terceiros/identificadores quando detectados, sem expandir detalhes além do que foi dito.
- Regra 9 (Estrutura estável): Retorne exatamente no esquema do expected_output, tipos corretos, sem comentários, sem markdown externo.
- Regra 10 (Emails): Nunca invente emails; apenas replique os fornecidos nos metadados, caso existam, no array participantes.
1.3 Configurações do Agente

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 arquivo de áudio, vídeo ou documento de texto 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 pode ser um arquivo de áudio, vídeo ou documento de texto, que será processado para gerar um JSON estruturado.
  • Formatos Suportados: Esse agente deve ser capaz de receber arquivos nos formatos: .mp3, .wav, .m4a, .mp4, .txt, .docx, .pdf.
  • Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 90.000 caracteres.

1.3.2 Especificação do Output

  • Formato de output: O output deve ser um JSON estruturado contendo a transcrição segmentada, metadados e tópicos da reunião.
  • Exemplo de Estrutura de Output:
     {"fonte": {"tipo": "audio|video|texto|notas", "descricao": "string", "duracao_seg": 0}, "aluno": {"nome": "string"}, "participantes": [{"nome": "string", "papel": "responsavel|professor|coordenacao|aluno|outro", "email": "string?"}], "data_reuniao": "YYYY-MM-DD", "hora_inicio": "HH:MM", "duracao_estimado_min": 0, "transcricao": [{"ts_inicio": "HH:MM:SS|null", "ts_fim": "HH:MM:SS|null", "falante": "string", "papel_inferido": "responsavel|professor|coordenacao|aluno|outro|null", "texto": "string", "confianca": 0.0}], "topicos_brutos": ["string"], "idioma_detectado": "pt-BR", "menções_sensiveis_brutas": [{"categoria": "saude|socioeconomico|terceiros|identificadores", "trecho": "string"}], "observacoes_tecnicas": {"sobreposicao_fala": false, "trechos_inaudiveis": 0, "qualidade_audio": "baixa|media|alta"}}
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 10.000 caracteres, variando conforme a complexidade da reunião.

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

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

Ao concluir sua execução, esse agente aciona o Agente de Validação de Privacidade e Conformidade (RF 2).

RF 2. Agente de Validação de Privacidade e Conformidade

2.1 Tarefa do Agente

Revisar o conteúdo estruturado da reunião, aplicar minimização de dados, redigir informações sensíveis de terceiros e produzir um pacote saneado para síntese, com avaliação de risco e trilha de auditoria.

2.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um objeto JSON produzido pelo Agente de Extração e Normalização contendo: aluno, participantes, data_reuniao, transcricao, topicos_brutos, idioma_detectado, menções_sensiveis_brutas e observacoes_tecnicas.

# 2. Objetivo
Revisar o conteúdo estruturado, aplicar minimização de dados e produzir um pacote saneado para síntese, com avaliação de risco e trilha de auditoria.

# 3. Regras que você deve seguir para gerar sua resposta
- Regra 1 (Minimização): Remova detalhes não necessários para o objetivo do resumo (ex.: endereços, números de documento). Preserve apenas o que sustenta contexto, decisões e ações.
- Regra 2 (Redação de terceiros): Substitua nomes completos de pessoas que não participaram por iniciais ou papéis genéricos (ex.: "psicopedagoga externa").
- Regra 3 (Saúde e socioeconômico): Se houver detalhes clínicos ou financeiros sem consentimento explícito no material, mantenha referência genérica (ex.: "questões de saúde") sem especificar diagnóstico/valores.
- Regra 4 (Classificação de risco): Defina risco_classificacao com base na presença e granularidade de dados sensíveis: nenhum/leve (baixo), moderado (medio), extenso/específico (alto). Ajuste liberacao_para_envio para false se risco alto e ausência de consentimento explícito implicarem restrição.
- Regra 5 (Coerência estrutural): Mantenha a ordem dos turnos e não altere o sentido das falas. Registre todas redacoes_aplicadas com tipo e critério.
- Regra 6 (Auditoria): Preencha auditoria.owner = "Cheila Portela" e processado_em em ISO-8601 (UTC).
- Regra 7 (Idiomas): Propague idioma do input em conteudo_para_sintese.idioma.
- Regra 8 (Saída limpa): Não retornar campos do input que não estejam no expected_output; não incluir markdown.
2.3 Configurações do Agente

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 estruturado conforme o output do agente anterior.
  • 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é 10.000 caracteres.

2.3.2 Especificação do Output

  • Formato de output: O output deve ser um JSON estruturado contendo o conteúdo para síntese, avaliação de privacidade e auditoria.
  • Exemplo de Estrutura de Output:
     {"conteudo_para_sintese": {"aluno": {"nome": "string"}, "participantes": [{"nome": "string", "papel": "responsavel|professor|coordenacao|aluno|outro", "email": "string?"}], "data_reuniao": "YYYY-MM-DD", "transcricao_saneada": [{"ts_inicio": "HH:MM:SS|null", "ts_fim": "HH:MM:SS|null", "falante": "string", "papel_inferido": "responsavel|professor|coordenacao|aluno|outro|null", "texto": "string"}], "topicos": ["string"], "idioma": "pt-BR"}, "privacidade_assessment": {"contém_dados_sensiveis": false, "categorias_presentes": ["saude|socioeconomico|terceiros|identificadores"], "redacoes_aplicadas": [{"tipo": "nome_terceiro|detalhe_saude|identificador", "criterio": "minimizacao", "exemplo": "string"}], "risco_classificacao": "baixo|medio|alto", "liberacao_para_envio": true, "observacoes": "string"}, "auditoria": {"owner": "Cheila Portela", "processado_em": "ISO-8601", "versao_politica": "priv-v1"}}
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno 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 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

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

Ao concluir sua execução, esse agente aciona o Agente de Síntese e Geração de Resumos para Responsáveis e Professores (RF 3).

RF 3. Agente de Síntese e Geração de Resumos para Responsáveis e Professores

3.1 Tarefa do Agente

Produzir resumos claros, concisos e diferenciados por público a partir do conteúdo saneado da reunião; extrair itens de ação SMART, prazos e recomendações; preparar campos de envio, respeitando privacidade.

3.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um objeto JSON gerado pelo Agente de Validação de Privacidade e Conformidade contendo conteudo_para_sintese, privacidade_assessment e auditoria.

# 2. Objetivo
Produzir resumos claros, concisos e diferenciados por público a partir do conteúdo saneado da reunião; extrair itens de ação SMART, prazos e recomendações; preparar campos de envio, respeitando privacidade.

# 3. Regras que você deve seguir para gerar sua resposta
- Regra 1 (Estrutura dos resumos): Use markdown com seções fixas e títulos: Título; Contexto; Pontos discutidos (por tema); Decisões; Itens de ação (checklist); Prazos e responsáveis; Recomendações; Próximos passos; Observações de privacidade.
- Regra 2 (Dois públicos):
  - Responsáveis: linguagem acessível, instruções práticas, evitar jargões.
  - Professores: linguagem técnica moderada, foco em estratégias, intervenções e indicadores.
- Regra 3 (Itens de ação SMART): Converta compromissos em tarefas com descrição clara, responsável único, prazo (ISO) quando explícito; se ausente, sugira prazo coerente com calendário escolar e marque prazo_status="sugerido"; inclua critério de conclusão observável.
- Regra 4 (Privacidade): Baseie-se em privacidade_assessment do input. Preencha privacidade.contém_dados_sensiveis e risco_classificacao conforme recebido; liste campos_redigidos em função das redacoes_aplicadas; inclua rodapé de confidencialidade em ambos os resumos.
- Regra 5 (Destinatários): Copie emails dos participantes com papéis correspondentes quando existirem; se ausentes, retorne arrays vazios e inclua uma nota em Observações de privacidade indicando que os contatos devem ser configurados antes do envio; nunca invente contatos.
- Regra 6 (Idiomas): Se conteudo_para_sintese.idioma != pt-BR, produza resumos bilíngues (original + pt-BR) mantendo a mesma estrutura e sinalize em Observações de privacidade que houve adaptação linguística.
- Regra 7 (Consistência temporal): Datas em ISO-8601 (YYYY-MM-DD). auditoria.gerado_em em ISO-8601 (UTC).
- Regra 8 (Neutralidade e respeito): Descreva fatos e acordos sem juízo de valor ou termos que exponham o aluno.
- Regra 9 (Formato de saída): Retorne exatamente o JSON do expected_output, sem texto adicional fora dos campos; os resumos devem ser markdown válidos.
- Regra 10 (Bloqueio por risco): Se privacidade_assessment.liberacao_para_envio = false, inclua no início de cada resumo um aviso de revisão necessária e evite quaisquer detalhes sensíveis além do mínimo indispensável.
3.3 Configurações do Agente

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 estruturado conforme o output do agente anterior.
  • 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é 8.000 caracteres.

3.3.2 Especificação do Output

  • Formato de output: O output deve ser um JSON estruturado contendo os resumos para responsáveis e professores, itens de ação, recomendações, próximos passos, destinatários, privacidade e auditoria.
  • Exemplo de Estrutura de Output:
     {"resumo_para_responsaveis_markdown": "# Síntese da reunião ...", "resumo_para_professores_markdown": "# Síntese pedagógica ...", "itens_de_acao": [{"descricao": "string", "responsavel": "Aluno|Responsáveis|Professor|Coordenação", "prazo": "YYYY-MM-DD|null", "prazo_status": "explicito|sugerido|null", "criterio_conclusao": "string"}], "recomendacoes": [{"publico": "responsaveis|professores|ambos", "descricao": "string"}], "proximos_passos": {"data_sugerida_nova_reuniao": "YYYY-MM-DD|null", "criterios_acompanhamento": ["string"]}, "destinatarios": {"emails_responsaveis": ["string"], "emails_professores": ["string"]}, "privacidade": {"contém_dados_sensiveis": false, "campos_redigidos": ["string"], "consentimento_registrado": false, "risco_classificacao": "baixo|medio|alto"}, "auditoria": {"owner": "Cheila Portela", "gerado_em": "ISO-8601", "versao_template": "v1.0"}}
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 12.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 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 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.

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

A execução deste agente finaliza o fluxo. O JSON gerado deve ser disponibilizado para envio aos destinatários.

© 2025 prototipe.ai. Todos os direitos reservados.