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 "Apoio ao Ensino de Habilidades Socioemocionais", uma solução projetada para auxiliar na criação e avaliação de programas de ensino voltados para o desenvolvimento de habilidades socioemocionais em crianças. 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 é proporcionar suporte contínuo a educadores na elaboração e avaliação de programas, medindo o impacto e sugerindo melhorias para o desenvolvimento socioemocional eficaz.
2. Contexto e Problema
Cenário Atual
Os programas de habilidades socioemocionais são cruciais para o desenvolvimento integral das crianças, mas muitos educadores enfrentam desafios significativos na criação e avaliação desses programas. Os problemas mais comuns incluem:
- Falta de apoio na criação e avaliação de programas de habilidades socioemocionais.
- Dificuldade em medir o impacto dos programas de habilidades socioemocionais.
Sem ferramentas adequadas, os educadores podem ter dificuldades em estruturar programas eficazes e em avaliar seu impacto, o que pode comprometer o desenvolvimento das habilidades socioemocionais nos alunos.
3. Impactos Esperados
A implementação deste agente de IA visa alcançar os seguintes resultados:
- Facilitar a criação de programas de ensino de habilidades socioemocionais, proporcionando modelos e orientações estruturadas.
- Avaliar continuamente o impacto dos programas, usando métricas padronizadas e sugestões de melhoria baseadas em dados.
- Aumentar a eficácia dos programas, melhorando o desenvolvimento socioemocional das crianças de forma mensurável.
4. Visão Geral da Solução
O agente de IA para apoio ao ensino de habilidades socioemocionais auxilia na criação de programas educacionais e na avaliação de seu impacto, fornecendo feedback contínuo e sugestões de melhorias. 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 no apoio ao ensino de habilidades socioemocionais em crianças.
A solução consiste em um fluxo de automação composto por vários agentes de IA. O processo inclui a criação de programas, normalização de dados de avaliação, análise de impacto e elaboração de planos de melhoria contínua.
A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo.
| Agentes | Função Principal |
|---|---|
Agente de Desenho de Programa Socioemocional (RF 1)
| Transformar o briefing do educador em um programa estruturado de habilidades socioemocionais pronto para implementação. |
Agente de Preparação e Normalização de Dados de Avaliação (RF 2)
| Padronizar e consolidar dados brutos de avaliação do programa em métricas comparáveis por competência. |
Agente de Análise e Relato de Impacto (RF 3)
| Analisar o impacto do programa por competência e gerar relatório técnico em linguagem acessível. |
Agente de Plano de Melhoria Contínua (RF 4)
| Converter lacunas identificadas em um plano de melhoria implementável de 8–12 semanas. |
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 esperado. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Desenho de Programa Socioemocional
1.1 Tarefa do Agente
Transformar o briefing do educador em um programa estruturado de habilidades socioemocionais pronto para implementação.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um briefing de educador contendo informações essenciais para a criação de um programa de habilidades socioemocionais.
# 2. Objetivo
Transformar o briefing do educador em um programa estruturado de habilidades socioemocionais, pronto para implementação.
# 3. Regras que você deve seguir para gerar sua resposta
- Converter cada objetivo em um objetivo SMART com campos: descricao, indicador_observavel, meta, prazo, responsavel.
- Mapear cada objetivo a pelo menos uma competência socioemocional, priorizando a primária.
- Distribuir a carga horária total em sessões de 30–60 min, garantindo atividades experienciais e reflexivas.
- Incluir instrumentos de avaliação com itens Likert e rubricas de 4 níveis.
- Especificar plano de monitoramento e considerações de inclusão.
- Validar consistência e completar campos pendentes com placeholder TODO_.
# 4. Exemplo de Output que você deve produzir
{
"programa": {
"nome": "Desenvolvimento Socioemocional",
"objetivos": [
{
"descricao": "Melhorar a autogestão",
"indicador_observavel": "Participação ativa em atividades",
"meta": "+15% em 12 semanas",
"prazo": "12 semanas",
"responsavel": "Educador"
}
],
"atividades": [...],
"avaliacoes": [...],
"monitoramento": {...}
}
} 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 briefing do educador 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 é um briefing textual contendo informações sobre o programa desejado.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos:
.txt,.docx. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 10.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um arquivo no formato JSON contendo o blueprint do programa estruturado, incluindo objetivos, atividades e plano de monitoramento.
-
Exemplo de Estrutura de Output:
{ "programa": { "nome": "Desenvolvimento Socioemocional", "objetivos": [...], "atividades": [...], "avaliacoes": [...], "monitoramento": {...} } } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.000 caracteres, podendo variar conforme a complexidade do programa.
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 Preparação e Normalização de Dados de Avaliação (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Preparação e Normalização de Dados de Avaliação (RF 2).
RF 2. Agente de Preparação e Normalização de Dados de Avaliação
2.1 Tarefa do Agente
Padronizar e consolidar dados brutos de avaliação do programa em métricas comparáveis por competência.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados brutos de avaliação em JSON/CSV, contendo respostas Likert, rubricas, frequência de comportamentos e observações textuais.
# 2. Objetivo
Padronizar e consolidar esses dados em métricas comparáveis por competência.
# 3. Regras que você deve seguir para gerar sua resposta
- Normalizar escalas para 0–100: Likert 0–3 → (valor/3)*100; rubrica 1–4 → ((valor-1)/3)*100.
- Definir baseline e pós com base nas coletas temporais.
- Tratar faltantes e outliers conforme regras definidas.
- Calcular variação absoluta e relativa, e tamanho de efeito.
- Garantir alinhamento item→competência e descartar inconsistências.
# 4. Exemplo de Output que você deve produzir
{
"dados_normalizados": {
"competencia": "Autogestão",
"n": 30,
"media": 75,
"desvio_padrao": 10,
"mediana": 76,
"variação_absoluta": 5,
"variação_relativa": 7,
"tamanho_efeito": 0.6
}
} 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 dados brutos de avaliação em formato JSON/CSV.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos:
.json,.csv. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de dados com até 15.000 caracteres.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um arquivo no formato JSON contendo métricas normalizadas por competência.
-
Exemplo de Estrutura de Output:
{ "dados_normalizados": { "competencia": "Autogestão", "n": 30, "media": 75, "desvio_padrao": 10, "mediana": 76, "variação_absoluta": 5, "variação_relativa": 7, "tamanho_efeito": 0.6 } } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 3.000 caracteres, variando conforme a quantidade de dados processados.
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: Utiliza lógica interna para cálculos estatísticos.
- 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 Análise e Relato de Impacto (RF 3).
2.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Análise e Relato de Impacto (RF 3).
RF 3. Agente de Análise e Relato de Impacto
3.1 Tarefa do Agente
Analisar o impacto do programa por competência e gerar relatório técnico em linguagem acessível.
3.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo um dataset normalizado contendo métricas de avaliação por competência. # 2. Objetivo Analisar o impacto do programa por competência e gerar um relatório técnico em linguagem acessível. # 3. Regras que você deve seguir para gerar sua resposta - Classificar impacto por competência usando delta_rel e d. - Incluir visualizações em ASCII para baseline e pós. - Comparar resultados às metas e listar alavancas e gargalos. - Fechar com seção de limitações e recomendações. # 4. Exemplo de Output que você deve produzir **Sumário Executivo:** O programa apresentou um impacto alto em Autogestão com um aumento médio de 15%. **Qualidade dos Dados:** Os dados são consistentes, sem faltantes significativos. **Resultados por Competência:** Autogestão: ██████████████ 75% **Conclusão e Recomendações:** Recomenda-se focar em atividades de autogestão para manter o progresso.
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 um dataset normalizado em formato JSON.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato:
.json. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de dados com até 12.000 caracteres.
3.3.2 Especificação do Output
- Formato de output: O output deve ser um relatório em formato Markdown contendo análise de impacto e recomendações.
-
Exemplo de Estrutura de Output:
**Sumário Executivo:** O programa apresentou um impacto alto em Autogestão com um aumento médio de 15%. **Qualidade dos Dados:** Os dados são consistentes, sem faltantes significativos. **Resultados por Competência:** Autogestão: ██████████████ 75% **Conclusão e Recomendações:** Recomenda-se focar em atividades de autogestão para manter o progresso.
- Número de caracteres esperado: O relatório gerado terá um tamanho aproximado de 4.000 caracteres, variando conforme a quantidade de competências analisadas.
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: Utiliza lógica interna para cálculos de impacto.
- 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 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 Plano de Melhoria Contínua (RF 4).
3.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Plano de Melhoria Contínua (RF 4).
RF 4. Agente de Plano de Melhoria Contínua
4.1 Tarefa do Agente
Converter lacunas identificadas em um plano de melhoria implementável de 8–12 semanas.
4.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um relatório de impacto com lacunas priorizadas e recomendações.
# 2. Objetivo
Converter as lacunas identificadas em um plano de melhoria implementável de 8–12 semanas.
# 3. Regras que você deve seguir para gerar sua resposta
- Selecionar até 3 lacunas prioritárias e definir OKRs.
- Gerar iniciativas com classificação MoSCoW.
- Construir cronograma de 8–12 semanas com checkpoints.
- Incluir adaptações para inclusão e acessibilidade.
# 4. Exemplo de Output que você deve produzir
{
"plano_melhoria": {
"objetivos": [
{
"descricao": "Melhorar a autogestão",
"okr": "+10 pontos em autogestão em 10 semanas",
"iniciativas": [
"Sessões de mindfulness",
"Treinamento de resolução de conflitos"
]
}
],
"cronograma": [...],
"checkpoints": [...]
}
} 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 deve ser apto a receber um relatório de impacto em formato Markdown.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato:
.md. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 8.000 caracteres.
4.3.2 Especificação do Output
- Formato de output: O output deve ser um plano de melhoria em formato JSON, contendo objetivos, iniciativas e cronograma.
-
Exemplo de Estrutura de Output:
{ "plano_melhoria": { "objetivos": [...], "iniciativas": [...], "cronograma": [...] } } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 4.000 caracteres, dependendo do número de lacunas e iniciativas planejadas.
4.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.6
4.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.
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 é o entregável final e não é passada para outros agentes internos.
4.3.6 Regras de Orquestração e Transição
A execução deste agente finaliza o fluxo. O plano de melhoria gerado é o resultado que deve ser disponibilizado ao usuário.