PrototipeAI | Agente de IA para Planejamento de Atividades Recreativas

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 "Planejamento de Atividades Recreativas", uma solução projetada para ajudar monitores a planejar o recreio de forma mais eficiente, considerando variáveis como idade dos alunos, condições climáticas e recursos disponíveis. 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 é otimizar o planejamento de atividades recreativas, garantindo diversão e segurança, enquanto adapta as sugestões às condições ambientais e interesses dos alunos.

2. Contexto e Problema

Cenário Atual

O planejamento de atividades recreativas em escolas é frequentemente ineficiente, pois não considera adequadamente variáveis como a idade dos alunos e as condições climáticas. Esta falta de consideração resulta em atividades que podem não ser apropriadas ou seguras para as condições do momento.

Além disso, há dificuldade em adaptar as atividades às condições ambientais e aos recursos disponíveis, o que pode limitar a diversão e a segurança das atividades propostas.

Problemas Identificados

Planejamento Ineficiente: As atividades recreativas não são planejadas de forma eficaz, muitas vezes ignorando variáveis importantes como condições climáticas e idade dos alunos.
Dificuldade de Adaptação: A falta de adaptação das atividades às condições ambientais e recursos disponíveis pode resultar em atividades inadequadas.

3. Impactos Esperados

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

Otimizar o planejamento de atividades recreativas considerando variáveis críticas como clima e faixa etária dos alunos.
Aumentar a diversão e a segurança das atividades recreativas através de sugestões adaptadas às condições ambientais e interesses dos alunos.

4. Visão Geral da Solução

O agente de IA para planejamento de atividades recreativas analisa dados meteorológicos, faixa etária dos alunos e recursos disponíveis para sugerir atividades adequadas, garantindo diversão e segurança. 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 planejamento de atividades recreativas.

A solução consiste em um fluxo de automação composto por dois agentes de IA. O processo inicia com a análise das condições climáticas e termina com a sugestão de atividades recreativas adaptadas.

A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo.

Agentes	Função Principal
`Agente de Análise Meteorológica` (RF 1)	Analisar dados meteorológicos para adaptar atividades recreativas.
`Agente de Planejamento de Atividades` (RF 2)	Sugerir atividades recreativas baseadas na faixa etária e recursos disponíveis.

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 Análise Meteorológica

1.1 Tarefa do Agente

Analisar dados meteorológicos para adaptar atividades recreativas, classificando o clima como ideal ou não ideal para atividades ao ar livre.

1.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados meteorológicos atuais e previsão do tempo. Esses dados são essenciais para adaptar as atividades recreativas às condições climáticas.

# 2. Objetivo
Analisar os dados meteorológicos para classificar o clima como ideal ou não ideal e adaptar atividades recreativas de acordo.

# 3. Regras que você deve seguir para gerar sua resposta
- Verifique a previsão climática para o dia atual e próximos dias, identificando condições adversas como chuva ou calor extremo.
- Classifique o clima como ideal ou não ideal para atividades ao ar livre, considerando temperatura, precipitação e vento.
- Atualize as informações meteorológicas a cada hora para garantir a precisão das sugestões de atividades, priorizando fontes confiáveis.

# 4. Exemplo de Output que você deve produzir
{
  "clima": "ensolarado",
  "temperatura": 25,
  "condicao_ideal": true
}

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 meteorológicos atuais via API. Na fase de testes, os dados serão enviados diretamente por upload de um csv na interface da Prototipe AI, para acelerar o processo de validação.
Tipo do input: Dados meteorológicos atuais e previsão do tempo.
Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .json, .csv.
Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 5.000 caracteres.

1.3.2 Especificação do Output

Formato de output: O output deve ser um arquivo no formato JSON contendo a classificação do clima e as condições meteorológicas.

Exemplo de Estrutura de Output:

 {
  "clima": "ensolarado",
  "temperatura": 25,
  "condicao_ideal": true
}

Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 200 caracteres.

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 Planejamento de Atividades (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Planejamento de Atividades (RF 2).

RF 2. Agente de Planejamento de Atividades

2.1 Tarefa do Agente

Sugerir atividades recreativas baseadas na faixa etária e recursos disponíveis, garantindo diversão e segurança.

2.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo a faixa etária dos alunos e os recursos disponíveis. Essas informações são essenciais para sugerir atividades recreativas adequadas.

# 2. Objetivo
Sugerir atividades recreativas baseadas na faixa etária dos alunos e nos recursos disponíveis, ajustando as sugestões de acordo com as condições climáticas fornecidas pelo Agente de Análise Meteorológica.

# 3. Regras que você deve seguir para gerar sua resposta
- Analise a faixa etária dos alunos para adequar as atividades propostas ao desenvolvimento e interesses típicos de cada grupo etário.
- Avalie os recursos disponíveis, como materiais e espaço, para otimizar o planejamento das atividades, garantindo uso eficiente e seguro.
- Ajuste as atividades propostas de acordo com as condições climáticas fornecidas pelo Agente de Análise Meteorológica, garantindo segurança e diversão.

# 4. Exemplo de Output que você deve produzir
**Atividades Sugeridas:**
1. Piquenique no pátio (se o clima for ensolarado)
2. Jogos de tabuleiro na sala de aula (se o clima for chuvoso)
3. Corrida de sacos no campo (se o clima for ameno)

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 a faixa etária dos alunos, recursos disponíveis e as condições climáticas já analisadas.
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é 3.000 caracteres.

2.3.2 Especificação do Output

Formato de output: O output deve ser uma lista de atividades sugeridas em formato markdown, considerando as condições climáticas, faixa etária e recursos disponíveis.