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
- 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 Validação de Privacidade e Conformidade (RF 2).
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
- 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 Síntese e Geração de Resumos para Responsáveis e Professores (RF 3).
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.