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 Detecção de Sinais de Alerta em Relatos de Alunos. 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 é analisar relatos textuais dos alunos para detectar sinais de alerta que possam indicar necessidade de intervenção psicológica imediata, utilizando técnicas de NLP.
2. Contexto e Problema
No ambiente educacional, a identificação tardia de alunos em risco que necessitam de intervenção psicológica urgente é um problema crítico. Além disso, há uma falta de recursos para monitorar continuamente os relatos dos alunos em busca de sinais de alerta.
Atualmente, a análise dos relatos dos alunos é feita de maneira manual e reativa, dependendo da percepção dos educadores ou psicólogos, o que pode levar a atrasos na identificação de casos que necessitam de atenção imediata.
3. Impactos Esperados
A implementação deste agente de IA visa alcançar os seguintes resultados:
- Reduzir o tempo de resposta na identificação de alunos em risco, proporcionando intervenções psicológicas mais rápidas.
- Aumentar a precisão na detecção de sinais de alerta através de análise automatizada e contínua.
- Manter registros dos sinais de alerta detectados para acompanhamento e análise futura, melhorando a base de dados para intervenções futuras.
4. Visão Geral da Solução
O agente de IA para detecção de sinais de alerta em relatos de alunos analisa textos usando técnicas de NLP para identificar palavras ou frases que indiquem risco potencial. 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 proativo na detecção de sinais de alerta em ambiente educacional.
A solução consiste em um único agente de IA que monitora continuamente os relatos textuais dos alunos. Ao identificar sinais de alerta, o agente envia notificações imediatas aos psicólogos responsáveis.
| Agentes | Função Principal |
|---|---|
Agente de Detecção de Sinais de Alerta (RF 1)
| Analisar relatos textuais dos alunos para identificar sinais de alerta e notificar psicólogos. |
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 a equipe de psicólogos receberá. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Detecção de Sinais de Alerta
1.1 Tarefa do Agente
Analisar relatos textuais dos alunos usando técnicas de NLP para identificar palavras ou frases que indiquem risco potencial e alertar psicólogos imediatamente.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo relatos textuais dos alunos. Estes textos são registros das experiências e sentimentos dos alunos no ambiente escolar. # 2. Objetivo Analisar os relatos para identificar sinais de alerta que possam indicar necessidade de intervenção psicológica urgente. # 3. Regras que você deve seguir para gerar sua resposta - Use técnicas de NLP para analisar o texto e identificar palavras ou frases que possam indicar risco emocional ou psicológico. - Mantenha um registro dos sinais de alerta detectados, incluindo o tipo de sinal e o contexto em que foi identificado. - Notifique imediatamente um psicólogo responsável sempre que um sinal de alerta for detectado. # 4. Exemplo de Output que você deve produzir **Sinal de Alerta Detectado:** Pensamentos de autoagressão **Contexto:** Aluno mencionou sentir-se sobrecarregado e sem esperança **Ação:** Notificação enviada ao psicólogo responsável
1.3 Configurações do Agente
1.3.1 Especificação do Input
- Mecanismo de Acionamento: Este agente deve ser acionado pelo envio de relatos textuais dos alunos 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 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, que contém os relatos dos alunos.
-
Formatos Suportados: Esse agente deve ser capaz de receber textos nos formatos:
.txt,.md. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 5.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um texto formatado em **Markdown**. A estrutura deve incluir o sinal de alerta detectado, o contexto e a ação tomada.
-
Exemplo de Estrutura de Output:
**Sinal de Alerta Detectado:** Pensamentos de autoagressão **Contexto:** Aluno mencionou sentir-se sobrecarregado e sem esperança **Ação:** Notificação enviada ao psicólogo responsável
- Número de caracteres esperado: O texto final deve ser conciso e informativo, com um tamanho estimado em torno de 500 caracteres.
1.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
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 exclusivamente para o psicólogo responsável.
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente envia automaticamente uma notificação ao psicólogo responsável.