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 "Monitoramento de Interações Sociais em Ambientes Escolares", uma solução de automação projetada para analisar interações sociais entre crianças e promover um ambiente inclusivo. 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 é compreender as dinâmicas de grupo em ambientes escolares, identificar exclusões ou conflitos, e promover atividades que incentivem a inclusão, reduzindo a necessidade de intervenção direta dos educadores.
2. Contexto e Problema
Cenário Atual
Em ambientes escolares, a compreensão das dinâmicas de grupo é fundamental para promover um ambiente inclusivo onde todas as crianças se sintam acolhidas e seguras. Atualmente, os educadores enfrentam desafios como:
- Falta de compreensão das dinâmicas de grupo em ambientes escolares.
- Dificuldade em promover um ambiente inclusivo para todas as crianças.
O processo de monitoramento das interações sociais é manual e depende da observação direta dos educadores, o que pode ser subjetivo e limitado pela capacidade humana de vigilância contínua.
Problemas Identificados
- Subjetividade nas observações: A análise das interações sociais depende da interpretação individual de cada educador.
- Falta de dados contínuos: As observações são pontuais e não oferecem uma visão contínua das dinâmicas de grupo.
- Recursos limitados: Os educadores têm tempo e recursos limitados para monitorar todas as interações sociais.
3. Impactos Esperados
A implementação deste agente de IA visa alcançar os seguintes resultados:
- Aumentar a compreensão das dinâmicas de grupo em ambientes escolares.
- Promover um ambiente mais inclusivo para todas as crianças.
- Reduzir a carga de trabalho dos educadores ao automatizar a análise das interações sociais.
- Fornecer dados contínuos e objetivos sobre as interações sociais para apoiar decisões pedagógicas.
4. Visão Geral da Solução
O agente de IA para monitoramento de interações sociais em ambientes escolares analisa continuamente as interações entre crianças, identifica dinâmicas de grupo e sugere intervenções para promover inclusão. 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 ambiente escolar.
A solução consiste em um fluxo de automação composto por múltiplos agentes de IA, cada um com funções específicas para analisar, relatar e sugerir intervenções em dinâmicas sociais.
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, conforme detalhado após a tabela.
| Agentes | Função Principal |
|---|---|
Agente de Análise de Interações (RF 1)
| Analisar interações sociais entre crianças para identificar dinâmicas de grupo. |
Agente de Identificação de Exclusões (RF 2)
| Detectar situações de exclusão ou isolamento social entre crianças. |
Agente de Sugestão de Intervenções (RF 3)
| Sugerir atividades ou intervenções para promover a inclusão. |
Agente de Relatório Semanal (RF 4)
| Gerar relatórios semanais sobre dinâmicas de grupo observadas. |
Regras de Execução Condicional ou Edges
- Ativação do Agente de Sugestão de Intervenções (RF 3): Este agente só será executado se a propriedade
"exclusao_detectada"do objeto JSON gerado pelo Agente de Identificação de Exclusões (RF 2) for"sim". Caso contrário, o fluxo pulará esta etapa e prosseguirá diretamente para o Agente de Relatório Semanal (RF 4).
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 Análise de Interações
1.1 Tarefa do Agente
Analisar interações sociais entre crianças para identificar dinâmicas de grupo e padrões de comportamento.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo dados contínuos sobre interações sociais entre crianças em um ambiente escolar. Este fluxo de dados é utilizado para identificar dinâmicas de grupo e padrões de comportamento. # 2. Objetivo Analisar os dados de interação social para identificar dinâmicas de grupo e padrões de comportamento. # 3. Regras que você deve seguir para gerar sua resposta - Concentre-se em identificar padrões de interação, como grupos coesos, exclusões frequentes ou isolamento de indivíduos. - Registre padrões de comportamento que possam indicar conflitos ou problemas de inclusão. - Mantenha um registro contínuo das interações relevantes para análise posterior. # 4. Exemplo de Output que você deve produzir **Padrões de Interação:** Grupo A é coeso e frequentemente exclui o indivíduo X. **Padrões de Comportamento:** Indivíduo Y frequentemente isolado durante atividades em grupo.
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 contínuos sobre interações sociais 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 um arquivo csv na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo é um conjunto de dados estruturados que representam interações sociais entre crianças.
-
Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos:
.csv,.json. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de dados com até 100.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um texto formatado em **Markdown**. A estrutura deve iniciar com um cabeçalho contendo os campos `Padrões de Interação` e `Padrões de Comportamento` em negrito. Logo após, a descrição detalhada dos padrões deve ser apresentada com exemplos específicos.
-
Exemplo de Estrutura de Output:
**Padrões de Interação:** Grupo A é coeso e frequentemente exclui o indivíduo X. **Padrões de Comportamento:** Indivíduo Y frequentemente isolado durante atividades em grupo.
- Número de caracteres esperado: O texto final deve ser informativo e conciso, com um tamanho estimado em torno de 5.000 caracteres, podendo variar conforme a complexidade dos padrões identificados.
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 Identificação de Exclusões (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Identificação de Exclusões (RF 2).
RF 2. Agente de Identificação de Exclusões
2.1 Tarefa do Agente
Detectar situações de exclusão ou isolamento social entre crianças com base nos padrões de interação identificados.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo dados sobre padrões de interação social entre crianças, identificados por um agente anterior. Este fluxo de dados é utilizado para detectar situações de exclusão ou isolamento social. # 2. Objetivo Detectar situações de exclusão ou isolamento social com base nos padrões de interação identificados. # 3. Regras que você deve seguir para gerar sua resposta - Analise os padrões de interação para identificar casos de exclusão ou isolamento social. - Registre situações de exclusão ou isolamento para análise posterior e possível intervenção. - Mantenha um registro contínuo das situações detectadas para gerar relatórios e sugerir intervenções. # 4. Exemplo de Output que você deve produzir **Exclusão Detectada:** Indivíduo X frequentemente excluído do Grupo A. **Isolamento Social:** Indivíduo Y raramente interage durante atividades em grupo.
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 bem-sucedida do agente anterior (RF 1).
- Tipo do input: Este agente deve ser apto a receber como input um texto formatado em Markdown, que corresponde aos padrões de interação identificados pelo agente anterior.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato:
.md(Markdown). - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 5.000 caracteres.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um texto formatado em **Markdown**. A estrutura deve iniciar com um cabeçalho contendo os campos `Exclusão Detectada` e `Isolamento Social` em negrito. Logo após, a descrição detalhada das situações deve ser apresentada com exemplos específicos.
-
Exemplo de Estrutura de Output:
**Exclusão Detectada:** Indivíduo X frequentemente excluído do Grupo A. **Isolamento Social:** Indivíduo Y raramente interage durante atividades em grupo.
- Número de caracteres esperado: O texto final deve ser informativo e conciso, com um tamanho estimado em torno de 3.000 caracteres, podendo variar conforme a complexidade das situações detectadas.
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: Não utiliza.
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 Sugestão de Intervenções (RF 3).
2.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Sugestão de Intervenções (RF 3).
RF 3. Agente de Sugestão de Intervenções
3.1 Tarefa do Agente
Sugerir atividades ou intervenções para promover a inclusão com base nas situações de exclusão ou isolamento detectadas.
3.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo dados sobre situações de exclusão ou isolamento social entre crianças, detectadas por um agente anterior. Este fluxo de dados é utilizado para sugerir atividades ou intervenções que promovam a inclusão. # 2. Objetivo Sugerir atividades ou intervenções para promover a inclusão com base nas situações de exclusão ou isolamento detectadas. # 3. Regras que você deve seguir para gerar sua resposta - Analise as situações de exclusão ou isolamento para sugerir atividades que promovam a inclusão. - Proponha intervenções que possam ser realizadas por educadores ou mediadores. - Mantenha um registro das sugestões feitas para análise posterior e acompanhamento dos resultados. # 4. Exemplo de Output que você deve produzir **Sugestão de Atividade:** Organizar um jogo de equipe que inclua o indivíduo X no Grupo A. **Intervenção Proposta:** Realizar uma roda de conversa para discutir a importância da inclusão com o indivíduo Y.
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 bem-sucedida do agente anterior (RF 2).
- Tipo do input: Este agente deve ser apto a receber como input um texto formatado em Markdown, que corresponde às situações de exclusão ou isolamento detectadas pelo agente anterior.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato:
.md(Markdown). - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 3.000 caracteres.
3.3.2 Especificação do Output
- Formato de output: O output deve ser um texto formatado em **Markdown**. A estrutura deve iniciar com um cabeçalho contendo os campos `Sugestão de Atividade` e `Intervenção Proposta` em negrito. Logo após, a descrição detalhada das sugestões deve ser apresentada com exemplos específicos.
-
Exemplo de Estrutura de Output:
**Sugestão de Atividade:** Organizar um jogo de equipe que inclua o indivíduo X no Grupo A. **Intervenção Proposta:** Realizar uma roda de conversa para discutir a importância da inclusão com o indivíduo Y.
- Número de caracteres esperado: O texto final deve ser informativo e conciso, com um tamanho estimado em torno de 2.000 caracteres, podendo variar conforme a complexidade das sugestões feitas.
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: Não utiliza.
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 Relatório Semanal (RF 4).
3.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Relatório Semanal (RF 4).
RF 4. Agente de Relatório Semanal
4.1 Tarefa do Agente
Gerar relatórios semanais sobre dinâmicas de grupo observadas e as intervenções sugeridas.
4.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo dados sobre dinâmicas de grupo e intervenções sugeridas em um ambiente escolar. Este fluxo de dados é utilizado para gerar relatórios semanais. # 2. Objetivo Gerar relatórios semanais sobre dinâmicas de grupo observadas e as intervenções sugeridas. # 3. Regras que você deve seguir para gerar sua resposta - Compile os dados sobre dinâmicas de grupo e intervenções sugeridas ao longo da semana. - Estruture o relatório de forma clara, destacando situações de exclusão e as intervenções propostas. - Inclua recomendações para educadores com base nos dados compilados. # 4. Exemplo de Output que você deve produzir **Relatório Semanal:** - **Dinâmicas de Grupo:** Grupo A mostra coesão, mas exclui o indivíduo X. - **Intervenções Sugeridas:** Jogo de equipe para incluir indivíduo X. - **Recomendações:** Realizar atividades que promovam a inclusão de indivíduos isolados.
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 como input um texto formatado em Markdown, que corresponde às dinâmicas de grupo e intervenções sugeridas ao longo da semana.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato:
.md(Markdown). - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 10.000 caracteres.
4.3.2 Especificação do Output
- Formato de output: O output deve ser um texto formatado em **Markdown**. A estrutura deve iniciar com um cabeçalho `Relatório Semanal`, seguido por seções detalhadas sobre dinâmicas de grupo, intervenções sugeridas e recomendações.
-
Exemplo de Estrutura de Output:
**Relatório Semanal:** - **Dinâmicas de Grupo:** Grupo A mostra coesão, mas exclui o indivíduo X. - **Intervenções Sugeridas:** Jogo de equipe para incluir indivíduo X. - **Recomendações:** Realizar atividades que promovam a inclusão de indivíduos isolados.
- Número de caracteres esperado: O texto final deve ser detalhado e abrangente, com um tamanho estimado em torno de 7.000 caracteres, podendo variar conforme a quantidade de dados compilados.
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: Não utiliza.
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 deve ser disponibilizada ao educador responsável.
4.3.6 Regras de Orquestração e Transição
A execução deste agente finaliza o fluxo. O relatório gerado é o resultado que deve ser enviado ao educador responsável.