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 Agente de IA para Personalização de Comunicações Escolares. 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 é criar um agente de IA capaz de personalizar comunicados escolares para famílias, considerando suas preferências e histórico de comunicação, de forma a maximizar o engajamento e a relevância das mensagens transmitidas.
2. Contexto e Problema
Cenário Atual
As escolas enfrentam desafios na comunicação com as famílias devido à necessidade de personalizar mensagens para diferentes perfis e preferências. A falta de personalização pode levar a um baixo engajamento e a problemas de comunicação.
- Necessidade de personalização nas comunicações escolares para melhor engajamento.
- Dificuldade em adaptar mensagens para diferentes perfis e preferências familiares.
Atualmente, a maioria das comunicações escolares são padronizadas, o que pode resultar em mensagens que não atraem a atenção ou não são relevantes para todas as famílias.
Problemas Identificados
- Engajamento baixo: Mensagens padronizadas não atendem às necessidades específicas de cada família.
- Falta de relevância: Falta de personalização pode levar a informações importantes sendo ignoradas.
3. Impactos Esperados
A implementação deste agente de IA visa alcançar os seguintes resultados:
- Aumentar o engajamento das famílias com as comunicações escolares.
- Personalizar as mensagens para atender às preferências individuais das famílias.
- Assegurar a clareza e a consistência das informações transmitidas.
4. Visão Geral da Solução
O agente de IA para personalização de comunicações escolares analisa o histórico de comunicação e preferências das famílias para personalizar mensagens escolares. 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 comunicação escolar personalizada.
A solução consiste em um agente de IA que processa dados históricos e preferências de comunicação das famílias para gerar mensagens personalizadas.
| Agentes | Função Principal |
|---|---|
Agente de Análise de Comunicação Escolar (RF 1)
| Analisar o histórico de comunicação e preferências das famílias para personalizar mensagens escolares. |
5. Protótipos
Para proporcionar uma visão clara e tangível da solução proposta, criamos protótipos interativos que demonstram o fluxo de trabalho do agente e o resultado final que o usuário receberá. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Análise de Comunicação Escolar
1.1 Tarefa do Agente
Analisar o histórico de comunicação e preferências das famílias para personalizar mensagens escolares.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo dados históricos de comunicação e preferências das famílias em formato JSON. Estes dados incluem informações sobre frequência de comunicação, canais preferidos e tipos de conteúdo mais acessados. # 2. Objetivo Analisar os dados para personalizar mensagens escolares que maximizem o engajamento e a relevância para cada família. # 3. Regras que você deve seguir para gerar sua resposta - Analise detalhadamente os padrões de engajamento no histórico de comunicação das famílias, considerando frequência, canais preferidos e tipo de conteúdo mais acessado. - Classifique as preferências de comunicação das famílias em categorias específicas, como formato preferido (texto, e-mail, etc.) e tom (formal, informal). - Desenvolva mensagens personalizadas que integrem as preferências identificadas, garantindo que o conteúdo seja relevante e envolvente para cada perfil familiar. - Assegure que as mensagens sejam claras, evitando jargões e garantindo que as informações sejam compreendidas de forma consistente por todas as famílias. - Revise as mensagens para assegurar que todas as informações críticas sejam transmitidas de maneira precisa e sem ambiguidade, ajustando conforme a necessidade para cada perfil.
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 dados históricos de comunicação e preferências das famílias via API. Na fase de testes, os dados serão enviados diretamente por upload de um arquivo JSON na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo são dados históricos de comunicação e preferências das famílias.
-
Formatos Suportados: Esse agente deve ser capaz de receber dados no formato:
.json. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 50.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um texto formatado em **Markdown** contendo as mensagens personalizadas para cada família.
-
Exemplo de Estrutura de Output:
**Mensagem Personalizada para a Família Silva:** Olá, Família Silva! De acordo com suas preferências, gostaríamos de convidá-los para a reunião de pais que ocorrerá na próxima semana. Esperamos vê-los lá! **Mensagem Personalizada para a Família Oliveira:** Prezada Família Oliveira, conforme solicitado, estamos enviando o relatório de desempenho do aluno. Por favor, não hesitem em entrar em contato para mais informações.
- Número de caracteres esperado: O texto final deve ser conciso e informativo, com um tamanho estimado em torno de 5.000 caracteres, podendo variar conforme a complexidade das preferências familiares.
1.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.7
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 não precisa ser visível para outros agentes, pois é o entregável final.
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, este agente finaliza o fluxo, gerando mensagens personalizadas que são enviadas diretamente para as famílias.