PrototipeAI | Agente de IA para Monitoramento de Progresso em Inclusão Escolar

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 Monitoramento de Progresso em Inclusão Escolar. 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 é criar um agente que acompanhe de forma contínua o progresso das iniciativas de inclusão nas escolas, gerando relatórios detalhados e insights sobre o impacto das ações de inclusão, para que possam ser melhoradas e ajustadas com base nos dados coletados.

2. Contexto e Problema

As iniciativas de inclusão escolar são essenciais para garantir que todos os alunos tenham acesso igualitário à educação. No entanto, muitas vezes falta um monitoramento contínuo do progresso dessas iniciativas, o que dificulta a avaliação de seu impacto real. Além disso, a ausência de relatórios e insights detalhados impede que ajustes sejam feitos de forma eficaz para melhorar as ações de inclusão.

3. Impactos Esperados

A implementação deste agente de IA visa alcançar os seguintes resultados:

Monitoramento contínuo das iniciativas de inclusão nas escolas.
Geração de relatórios detalhados que demonstrem o impacto das ações de inclusão.
Fornecimento de insights para melhorar e ajustar as iniciativas com base nos dados coletados.

4. Visão Geral da Solução

O agente de IA para monitoramento de progresso em inclusão escolar analisa dados sobre as iniciativas de inclusão, gera relatórios detalhados e fornece insights para otimizar as ações. 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 eficaz e autônomo no acompanhamento dessas iniciativas.

A solução consiste em um fluxo de automação composto por 2 agentes de IA. O processo inicia com o monitoramento contínuo das iniciativas de inclusão e culmina na geração de relatórios e insights detalhados.

Agentes	Função Principal
`Agente de Monitoramento Contínuo de Inclusão Escolar` (RF 1)	Acompanhar de forma contínua o progresso das iniciativas de inclusão nas escolas.
`Agente de Geração de Relatórios e Insights` (RF 2)	Gerar relatórios detalhados e fornecer insights sobre o impacto das ações de inclusão escolar.

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.

Ver Agente na Prototipe AI

6. Requisitos Funcionais

RF 1. Agente de Monitoramento Contínuo de Inclusão Escolar

1.1 Tarefa do Agente

Acompanhar de forma contínua o progresso das iniciativas de inclusão nas escolas, gerando dados que alimentam o próximo agente do fluxo.

1.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados de progresso das iniciativas de inclusão escolar em formato CSV. Este arquivo contém informações sobre escolas, iniciativas, progresso e datas.

# 2. Objetivo
Acompanhar e calcular o progresso acumulado para cada escola e iniciativa, identificando tendências e áreas que necessitam de atenção.

# 3. Regras que você deve seguir para gerar sua resposta
- Calcular o progresso acumulado para cada escola e iniciativa com base nos dados recebidos.
- Identificar tendências de progresso ou falta de progresso em iniciativas específicas.
- Sinalizar automaticamente qualquer escola ou iniciativa que não demonstre progresso esperado.
- Registrar a data da última atualização para cada escola e iniciativa.
- Comparar o progresso atual com metas estabelecidas para determinar o nível de sucesso das iniciativas.
- Converter os dados de progresso em insights acionáveis, identificando áreas de melhoria potencial.

# 4. Exemplo de Output que você deve produzir
{
  "escola": "Escola ABC",
  "iniciativa": "Inclusão Digital",
  "progresso_acumulado": 75,
  "tendencias": "Estável",
  "sinalizacao": "Necessita Atenção",
  "ultima_atualizacao": "2025-11-16",
  "insights": "Focar em treinamentos adicionais para professores."
}

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 arquivo CSV via API contendo dados de progresso das iniciativas. Na fase de testes, o fluxo será iniciado pelo envio manual dos dados, que serão enviados para o agente diretamente por upload do CSV na interface da Prototipe AI, para acelerar o processo de validação.
Tipo do input: O input inicial para o fluxo é um arquivo CSV contendo dados estruturados sobre o progresso das iniciativas de inclusão escolar.
Formatos Suportados: Esse agente deve ser capaz de receber arquivos nos formatos: .csv.
Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 50.000 caracteres.

1.3.2 Especificação do Output

Formato de output: O output deve ser um JSON contendo o progresso acumulado por escola e iniciativa, com insights sobre áreas de melhoria.

Exemplo de Estrutura de Output:

 {
  "escola": "Escola ABC",
  "iniciativa": "Inclusão Digital",
  "progresso_acumulado": 75,
  "tendencias": "Estável",
  "sinalizacao": "Necessita Atenção",
  "ultima_atualizacao": "2025-11-16",
  "insights": "Focar em treinamentos adicionais para professores."
}

Número de caracteres esperado: O JSON gerado deve ter aproximadamente 1.500 caracteres por escola e iniciativa.

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 e Insights (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 e Insights (RF 2).

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

2.1 Tarefa do Agente

Gerar relatórios detalhados e fornecer insights sobre o impacto das ações de inclusão escolar com base nos dados recebidos.

2.2 Prompt ou Instruções do Agente

# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um JSON com progresso acumulado por escola e iniciativa. Este JSON foi gerado por um agente anterior e contém insights sobre as iniciativas de inclusão escolar.

# 2. Objetivo
Analisar o JSON de progresso acumulado para criar um panorama geral do impacto das ações de inclusão e fornecer sugestões de ajustes.

# 3. Regras que você deve seguir para gerar sua resposta
- Analisar o JSON de progresso acumulado para criar um panorama geral do impacto das ações de inclusão.
- Destacar iniciativas com maior e menor impacto em termos de progresso escolar.
- Gerar gráficos visuais para representar o progresso das iniciativas ao longo do tempo.
- Oferecer sugestões específicas e baseadas em dados para ajustes nas iniciativas de inclusão.
- Identificar padrões de sucesso e fracasso e correlacioná-los com estratégias de inclusão específicas.
- Assegurar que o relatório seja compreensível para todas as partes interessadas, usando linguagem clara e acessível.

# 4. Exemplo de Output que você deve produzir
### Relatório de Inclusão Escolar

#### Impacto Geral
- **Escola ABC - Inclusão Digital:** Progresso Acumulado: 75%. Necessita Atenção: Focar em treinamentos adicionais para professores.

#### Sugestões de Ajustes
- **Escola XYZ - Acessibilidade Física:** Melhorar infraestrutura para facilitar o acesso de alunos com mobilidade reduzida.

#### Gráficos Visuais
![Gráfico de Progresso](link_para_grafico)

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 JSON contendo o progresso acumulado e insights gerados pelo agente anterior.
Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
Número de caracteres esperado: Este agente deve ter capacidade para processar um JSON de até 20.000 caracteres.

2.3.2 Especificação do Output

Formato de output: O output deve ser um relatório em formato Markdown detalhando o impacto das ações de inclusão e sugestões de ajustes.