PrototipeAI | Agente de IA para Criação de Relatórios de Avaliação Infantil

1. Propósito e Escopo

Este documento define todos os prompts, configurações de memória, transição entre estados, ferramentas como consultas a documentos e demais requisitos funcionais para o Fluxo de Agentes "Criação de Relatórios de Avaliação Infantil", uma solução de automação projetada para gerar relatórios personalizados para pais e educadores a partir de dados de avaliações de crianças. Esta documentação é um modelo de PRD ou Documento de Requisitos de Produto específicos para construção de Agentes de IA.

O objetivo principal é transformar dados de avaliações em relatórios que destacam áreas de progresso e necessidade de atenção, proporcionando insights valiosos para pais e educadores.

2. Contexto e Problema

Problemas Identificados

Falta de relatórios personalizados: Os relatórios atuais não fornecem informações detalhadas e personalizadas sobre o desempenho das crianças.
Dificuldade em identificar áreas de atenção: Educadores e pais enfrentam desafios para identificar claramente as áreas onde as crianças precisam de mais apoio.

3. Impactos Esperados

A implementação deste fluxo de automação visa alcançar os seguintes resultados:

Fornecer relatórios detalhados e personalizados que ajudem pais e educadores a entender melhor o progresso das crianças.
Destacar áreas críticas que necessitam de atenção, facilitando intervenções pedagógicas eficazes.

4. Visão Geral da Solução

O agente de IA para criação de relatórios de avaliação infantil processa dados de avaliações de crianças, aplicando regras que sintetizam informações e geram relatórios personalizados para pais e educadores. 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 geração de relatórios que seguem as especificidades das necessidades educacionais.

A solução consiste em um fluxo de automação com dois agentes de IA. O processo inicia com a síntese dos dados de avaliação e termina com a geração de um relatório personalizado.

Agentes	Função Principal
`Agente de Síntese de Dados de Avaliações Infantis` (RF 1)	Sintetizar dados de avaliações para destacar áreas de progresso e necessidade de atenção.
`Agente de Geração de Relatórios Personalizados` (RF 2)	Gerar relatórios personalizados e detalhados para pais e educadores com base na síntese dos dados.

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 os pais e educadores receberão. Explore os links abaixo para entender melhor a solução em ação.

Ver Agente na Prototipe AI

6. Requisitos Funcionais

RF 1. Agente de Síntese de Dados de Avaliações Infantis

1.1 Tarefa do Agente

Sintetizar dados de avaliações de crianças para destacar áreas de progresso e necessidade de atenção.

1.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados de avaliações de crianças em formato CSV ou JSON. Estes dados contêm informações sobre o desempenho das crianças em várias áreas de desenvolvimento.

# 2. Objetivo
Sintetizar os dados para destacar áreas de progresso e necessidade de atenção, gerando um JSON estruturado com essas informações.

# 3. Regras que você deve seguir para gerar sua resposta
- Analise os dados de avaliações para identificar padrões de comportamento em diferentes áreas de desenvolvimento, como cognitiva, social e motora.
- Priorize a identificação de áreas críticas que necessitam de atenção imediata, utilizando critérios padronizados de avaliação.
- Gere um resumo claro e específico para cada criança, destacando conquistas e pontos de melhoria com base em benchmarks educacionais.

# 4. Exemplo de Output que você deve produzir
{
  "child_id": "12345",
  "progress_areas": ["Leitura", "Matemática"],
  "attention_needed": ["Interação Social", "Motricidade Fina"]
}

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 de avaliações em formato CSV ou JSON 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 são dados de avaliações de crianças em formato CSV ou JSON.
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 texto com até 100.000 caracteres.

1.3.2 Especificação do Output

Formato de output: O output deve ser um arquivo no formato JSON estruturado, contendo áreas de progresso e necessidade de atenção destacadas.

Exemplo de Estrutura de Output:

 {
  "child_id": "12345",
  "progress_areas": ["Leitura", "Matemática"],
  "attention_needed": ["Interação Social", "Motricidade Fina"]
}

Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 1.000 caracteres por criança, podendo variar conforme a complexidade dos dados.

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 Geração de Relatórios Personalizados (RF 2).

1.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Geração de Relatórios Personalizados (RF 2).

RF 2. Agente de Geração de Relatórios Personalizados

2.1 Tarefa do Agente

Gerar relatórios personalizados e detalhados para pais e educadores com base na síntese dos dados.

2.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um JSON estruturado com a síntese dos dados de avaliações de crianças, incluindo áreas de progresso e necessidade de atenção.

# 2. Objetivo
Gerar relatórios personalizados em formato Markdown, detalhando o desempenho da criança e fornecendo recomendações práticas para pais e educadores.

# 3. Regras que você deve seguir para gerar sua resposta
- Customize o conteúdo do relatório para refletir informações específicas e relevantes para cada criança, garantindo que pais e educadores compreendam claramente os resultados.
- Inclua recomendações práticas e ações sugeridas para melhorar as áreas identificadas como necessitando de atenção.
- Estruture o relatório para ser acessível e livre de jargões, utilizando uma linguagem clara e direta.
- Incorpore gráficos ou tabelas, quando necessário, para ilustrar o progresso da criança de forma visualmente compreensível.

# 4. Exemplo de Output que você deve produzir
**Relatório de Avaliação - Criança ID: 12345**

### Áreas de Progresso
- Leitura
- Matemática

### Necessidade de Atenção
- Interação Social
- Motricidade Fina

### Recomendações
- Para melhorar a interação social, considere atividades em grupo que incentivem a colaboração.
- Para motricidade fina, atividades como pintura ou manipulação de objetos pequenos podem ser benéficas.

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 como input um arquivo JSON estruturado com a síntese dos dados de avaliações.
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 até 10.000 caracteres por criança.

2.3.2 Especificação do Output

Formato de output: O output deve ser um relatório em formato Markdown, detalhando o desempenho da criança, incluindo áreas de progresso e necessidade de atenção, bem como recomendações práticas.