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 "Comunicação de Atualizações de Matrícula", uma solução projetada para notificar automaticamente pais e responsáveis sobre o status das matrículas e quaisquer documentos ou ações pendentes. 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 é garantir que os responsáveis sejam informados de maneira eficaz e em tempo hábil sobre o status das matrículas, pendências e prazos, utilizando notificações automáticas personalizadas com base nas preferências dos pais.
2. Contexto e Problema
Cenário Atual
A comunicação ineficaz pode deixar pais desinformados sobre o status das matrículas, resultando em atrasos na entrega de documentos, o que pode comprometer o processo de matrícula.
Problemas Identificados
- Falta de comunicação eficaz: Os responsáveis frequentemente não recebem atualizações oportunas sobre o status das matrículas.
- Atrasos na entrega de documentos: A falta de notificações automáticas pode levar a atrasos e comprometer o processo de matrícula.
3. Impactos Esperados
A implementação deste agente de IA visa alcançar os seguintes resultados:
- Melhorar a comunicação com pais e responsáveis, garantindo que estejam sempre informados sobre o status das matrículas.
- Reduzir atrasos na entrega de documentos necessários para a matrícula.
- Personalizar notificações de acordo com as preferências dos responsáveis, aumentando a eficácia da comunicação.
4. Visão Geral da Solução
O agente de IA para comunicação de atualizações de matrícula notifica automaticamente pais e responsáveis sobre o status das matrículas e quaisquer documentos ou ações pendentes. 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 de atualizações de matrícula.
A solução consiste em um fluxo de automação composto por múltiplos agentes de IA. O processo inicia com a validação da identidade do responsável e termina com a confirmação de leitura das notificações enviadas.
A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo. O fluxo inclui etapas condicionais que são executadas apenas se critérios específicos forem atendidos.
| Agentes | Função Principal |
|---|---|
Agente de Validação de Identidade (RF 1)
| Validar a identidade do responsável utilizando a chave CPF. |
Agente de Notificação de Status de Matrícula (RF 2)
| Informar o status atualizado da matrícula do aluno. |
Agente de Lembretes de Documentos (RF 3)
| Enviar lembretes automáticos sobre documentos pendentes. |
Agente de Personalização de Notificações (RF 4)
| Personalizar notificações com base nas preferências dos responsáveis. |
Agente de Confirmação de Leitura (RF 5)
| Confirmar recebimento e leitura das notificações enviadas. |
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 Validação de Identidade
1.1 Tarefa do Agente
Validar a identidade do responsável utilizando a chave CPF antes de prosseguir com qualquer interação.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você deve validar a identidade do usuário utilizando a chave CPF do responsável antes de prosseguir com as interações. # 2. Objetivo Garantir que apenas usuários autorizados acessem informações sensíveis sobre matrículas. # 3. Regras que você deve seguir para gerar sua resposta - Verifique se o CPF fornecido está correto e corresponde a um responsável cadastrado. - Em caso de falha na validação, solicite o CPF novamente ou ofereça suporte para correção. - Não prossiga com interações até que a validação seja bem-sucedida. # 4. Exemplo de Output que você deve produzir Sua identidade foi validada com sucesso. Podemos prosseguir com as atualizações de matrícula.
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 do CPF do responsável via API. Na fase de testes, o fluxo será iniciado pelo envio manual do CPF na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo é um número de CPF, que é utilizado para validar a identidade do responsável.
-
Formatos Suportados: Esse agente deve ser capaz de receber CPFs no formato:
xxx.xxx.xxx-xx. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 14 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um texto simples confirmando a validação da identidade.
-
Exemplo de Estrutura de Output:
Sua identidade foi validada com sucesso. Podemos prosseguir com as atualizações de matrícula.
- Número de caracteres esperado: O texto final deve ser conciso, com um tamanho estimado em torno de 100 caracteres.
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: Conecta-se ao sistema SIS_Escolar para validação do CPF.
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 Notificação de Status de Matrícula (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Notificação de Status de Matrícula (RF 2).
RF 2. Agente de Notificação de Status de Matrícula
2.1 Tarefa do Agente
Informar o status atualizado da matrícula do aluno para o responsável.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo um pedido para informar o status atualizado da matrícula de um aluno. # 2. Objetivo Fornecer informações precisas e atualizadas sobre o status da matrícula para o responsável. # 3. Regras que você deve seguir para gerar sua resposta - Consulte o sistema SIS_Escolar para obter o status atual da matrícula. - Informe o status ao responsável de maneira clara e objetiva. - Se houver pendências, liste-as juntamente com os prazos e instruções para resolução. # 4. Exemplo de Output que você deve produzir O status atual da matrícula do aluno é: Em Processamento. Pendências: Certidão de nascimento (prazo: 10/12/2025).
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 validação bem-sucedida do agente anterior (RF 1).
- Tipo do input: Este agente recebe uma solicitação para informar o status da matrícula do aluno.
- Formatos Suportados: Esse agente deve ser capaz de processar inputs no formato de solicitação de status.
- Número de caracteres esperado: Este agente deve ter capacidade para processar uma solicitação de texto com até 500 caracteres.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um texto simples informando o status da matrícula e quaisquer pendências.
-
Exemplo de Estrutura de Output:
O status atual da matrícula do aluno é: Em Processamento. Pendências: Certidão de nascimento (prazo: 10/12/2025).
- Número de caracteres esperado: O texto final deve ser conciso e informativo, com um tamanho estimado em torno de 200 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.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Conecta-se ao sistema SIS_Escolar para obter o status da matrícula.
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 Lembretes de Documentos (RF 3).
2.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Lembretes de Documentos (RF 3).
RF 3. Agente de Lembretes de Documentos
3.1 Tarefa do Agente
Enviar lembretes automáticos sobre documentos pendentes para o responsável.
3.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo uma lista de documentos pendentes e prazos associados. # 2. Objetivo Enviar lembretes automáticos para o responsável sobre documentos pendentes, garantindo que sejam entregues no prazo. # 3. Regras que você deve seguir para gerar sua resposta - Utilize as preferências de notificação do responsável para determinar o canal e a frequência dos lembretes. - Envie lembretes 48 horas antes do prazo final de entrega dos documentos. - Se todos os documentos forem entregues antes do prazo, cancele os lembretes agendados. # 4. Exemplo de Output que você deve produzir Lembrete: A certidão de nascimento do aluno ainda está pendente. Prazo de entrega: 10/12/2025.
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 recebe uma lista de documentos pendentes e prazos associados.
- Formatos Suportados: Esse agente deve ser capaz de processar inputs no formato de lista de documentos pendentes.
- Número de caracteres esperado: Este agente deve ter capacidade para processar uma lista de texto com até 1.000 caracteres.
3.3.2 Especificação do Output
- Formato de output: O output deve ser um texto simples de lembrete sobre documentos pendentes.
-
Exemplo de Estrutura de Output:
Lembrete: A certidão de nascimento do aluno ainda está pendente. Prazo de entrega: 10/12/2025.
- Número de caracteres esperado: O texto final deve ser conciso e direto, com um tamanho estimado em torno de 150 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.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Conecta-se ao sistema SIS_Escolar para obter informações sobre documentos pendentes.
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 Personalização de Notificações (RF 4).
3.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Personalização de Notificações (RF 4).
RF 4. Agente de Personalização de Notificações
4.1 Tarefa do Agente
Personalizar notificações com base nas preferências dos responsáveis.
4.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo informações sobre as preferências de notificação dos responsáveis. # 2. Objetivo Garantir que as notificações sejam enviadas de acordo com as preferências de canal, tom, frequência e horários silenciosos dos responsáveis. # 3. Regras que você deve seguir para gerar sua resposta - Respeite o canal preferido do responsável ao enviar notificações (WhatsApp, SMS, Email). - Utilize o tom preferido (objetivo ou acolhedor) nas mensagens. - Envie notificações apenas nos horários permitidos pelo responsável. # 4. Exemplo de Output que você deve produzir Mensagem personalizada enviada via WhatsApp: "Olá, [Nome do Responsável], a matrícula do [Nome do Aluno] está em processamento. Não se esqueça de enviar a certidão de nascimento até 10/12/2025."
4.3 Configurações do Agente
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 recebe informações sobre preferências de notificação dos responsáveis.
- Formatos Suportados: Esse agente deve ser capaz de processar inputs no formato de preferências de notificação.
- Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 500 caracteres.
4.3.2 Especificação do Output
- Formato de output: O output deve ser uma mensagem personalizada de notificação.
-
Exemplo de Estrutura de Output:
Mensagem personalizada enviada via WhatsApp: "Olá, [Nome do Responsável], a matrícula do [Nome do Aluno] está em processamento. Não se esqueça de enviar a certidão de nascimento até 10/12/2025."
- Número de caracteres esperado: O texto final deve ser conciso e personalizado, com um tamanho estimado em torno de 200 caracteres.
4.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.6
4.3.4 Ferramentas do Agente
- Documentos: Não consulta.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Conecta-se ao sistema SIS_Escolar para registrar as preferências de notificação.
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 Confirmação de Leitura (RF 5).
4.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Confirmação de Leitura (RF 5).
RF 5. Agente de Confirmação de Leitura
5.1 Tarefa do Agente
Confirmar recebimento e leitura das notificações enviadas aos responsáveis.
5.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está responsável por confirmar o recebimento e leitura das notificações enviadas aos responsáveis. # 2. Objetivo Garantir que os responsáveis receberam e leram as notificações sobre o status das matrículas e pendências. # 3. Regras que você deve seguir para gerar sua resposta - Utilize o sistema SIS_Escolar para registrar a confirmação de leitura. - Caso não haja confirmação, programe o reenvio da notificação após 24 horas. - Informe ao responsável que a leitura foi confirmada e ofereça ajuda adicional, se necessário. # 4. Exemplo de Output que você deve produzir A leitura da notificação sobre a matrícula do aluno foi confirmada. Se precisar de mais informações, estamos à disposição.
5.3 Configurações do Agente
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 recebe informações sobre o status de leitura das notificações enviadas.
- Formatos Suportados: Esse agente deve ser capaz de processar inputs no formato de status de leitura.
- Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 200 caracteres.
5.3.2 Especificação do Output
- Formato de output: O output deve ser um texto simples confirmando a leitura das notificações.
-
Exemplo de Estrutura de Output:
A leitura da notificação sobre a matrícula do aluno foi confirmada. Se precisar de mais informações, estamos à disposição.
- Número de caracteres esperado: O texto final deve ser claro e objetivo, com um tamanho estimado em torno de 150 caracteres.
5.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.6
5.3.4 Ferramentas do Agente
- Documentos: Não consulta.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Conecta-se ao sistema SIS_Escolar para registrar a confirmação de leitura.
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 não precisa ser visível para outros agentes, pois conclui o fluxo.
5.3.6 Regras de Orquestração e Transição
A execução deste agente finaliza o fluxo. A confirmação de leitura é o resultado que deve ser registrado no sistema.