PrototipeAI | Agente de IA para Criação de Relatórios de Evolução Psicológica

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 "Criação de Relatórios de Evolução Psicológica", uma solução de automação projetada para gerar relatórios de evolução psicológica individual de alunos a partir de dados coletados em sessões de apoio psicológico. 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 é consolidar dados de múltiplas sessões em um formato compreensível e útil para psicólogos e pais, permitindo um acompanhamento contínuo e detalhado da evolução psicológica dos alunos.

2. Contexto e Problema

Cenário Atual

Atualmente, não existe um sistema automatizado eficaz para acompanhar a evolução psicológica dos alunos de forma contínua. Psicólogos enfrentam desafios significativos ao tentar consolidar dados de várias sessões de apoio psicológico em relatórios que sejam compreensíveis e úteis tanto para outros profissionais quanto para os pais dos alunos.

Problemas Identificados

Falta de Automação: Não há um sistema automatizado para o acompanhamento contínuo da evolução psicológica dos alunos, o que resulta em um alto consumo de tempo e recursos humanos.
Dificuldade na Consolidação de Dados: A consolidação manual de dados de múltiplas sessões em um formato compreensível e útil é um processo complexo e propenso a erros.

3. Impactos Esperados

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

Aumentar a eficiência no acompanhamento da evolução psicológica dos alunos.
Fornecer relatórios padronizados que sejam compreensíveis e úteis para psicólogos e pais.
Reduzir o tempo de consolidação de dados, permitindo que psicólogos se concentrem em análises mais aprofundadas.

4. Visão Geral da Solução

O agente de IA para criação de relatórios de evolução psicológica sintetiza informações de múltiplas sessões de apoio psicológico, aplica regras para identificar padrões de evolução e gera relatórios compreensíveis e detalhados. 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 criação de relatórios que seguem as especificidades das necessidades dos psicólogos e pais.

A solução consiste em um fluxo de automação composto por 2 agentes de IA. O processo inicia com a coleta e integração de dados de sessões psicológicas e termina com a geração de um relatório de evolução.

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

Agentes	Função Principal
`Agente de Coleta e Integração de Dados de Sessões` (RF 1)	Coletar e integrar dados de diversas sessões de apoio psicológico para cada aluno.
`Agente de Geração de Relatórios de Evolução` (RF 2)	Gerar relatórios claros e detalhados que mostrem a evolução do aluno ao longo do tempo.

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 usuário 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 Coleta e Integração de Dados de Sessões

1.1 Tarefa do Agente

Coletar e integrar dados de diversas sessões de apoio psicológico para cada aluno.

1.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados de sessões psicológicas em formato JSON, incluindo data, tópicos discutidos e observações.

# 2. Objetivo
Coletar dados de todas as sessões disponíveis para cada aluno e integrá-los em um único registro por aluno, preservando a ordem cronológica das sessões.

# 3. Regras que você deve seguir para gerar sua resposta
- Coletar dados de todas as sessões disponíveis para cada aluno, garantindo que nenhum dado seja omitido.
- Integrar os dados em um único registro por aluno, preservando a ordem cronológica das sessões para manter a sequência correta dos eventos.
- Identificar e eliminar duplicatas nos dados integrados, assegurando que todas as informações sejam consistentes e sem conflitos.

# 4. Exemplo de Output que você deve produzir
{
  "aluno_id": "12345",
  "dados_sessoes": [
    {"data": "2025-01-15", "topicos": "Ansiedade", "observacoes": "Aluno demonstrou melhora significativa."},
    {"data": "2025-02-20", "topicos": "Concentração", "observacoes": "Dificuldade em manter foco durante as atividades."}
  ]
}

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 sessões psicológicas em formato JSON. Na fase de testes, os dados serão enviados para o agente diretamente por upload de um arquivo JSON na interface da Prototipe AI, para acelerar o processo de validação.
Tipo do input: Dados estruturados em formato JSON, incluindo informações de data, tópicos discutidos e observaçõ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 texto com até 50.000 caracteres.

1.3.2 Especificação do Output

Formato de output: O output deve ser um arquivo JSON consolidado, contendo os dados integrados para cada aluno, preservando a ordem cronológica das sessões.

Exemplo de Estrutura de Output:

 {
  "aluno_id": "12345",
  "dados_sessoes": [
    {"data": "2025-01-15", "topicos": "Ansiedade", "observacoes": "Aluno demonstrou melhora significativa."},
    {"data": "2025-02-20", "topicos": "Concentração", "observacoes": "Dificuldade em manter foco durante as atividades."}
  ]
}

Número de caracteres esperado: O JSON consolidado deve ser conciso e informativo, com um tamanho estimado em torno de 10.000 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 Geração de Relatórios de Evolução (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 de Evolução (RF 2).

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

2.1 Tarefa do Agente

Gerar relatórios claros e detalhados que mostrem a evolução do aluno ao longo do tempo.

2.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados integrados de sessões psicológicas por aluno.

# 2. Objetivo
Gerar relatórios claros e detalhados que mostrem a evolução do aluno ao longo do tempo, incluindo gráficos de progresso e espaço para comentários adicionais de psicólogos.

# 3. Regras que você deve seguir para gerar sua resposta
- Analisar os dados integrados para identificar padrões de progresso ou regressão, aplicando critérios específicos para determinar o que constitui progresso ou regressão.
- Criar gráficos que representem visualmente a evolução ao longo do tempo, destacando momentos chave de mudança.
- Incluir seções no relatório para comentários adicionais de psicólogos, permitindo a adição de insights qualitativos que complementem os dados quantitativos.

# 4. Exemplo de Output que você deve produzir
**Relatório de Evolução Psicológica**
Aluno ID: 12345

## Evolução ao Longo do Tempo
- **Janeiro 2025**: Aluno demonstrou melhora significativa em relação à ansiedade.
- **Fevereiro 2025**: Dificuldade em manter foco durante as atividades.

![Gráfico de Progresso](url_do_grafico)

## Comentários Adicionais
Psicólogo: O aluno está mostrando um bom progresso geral, mas ainda precisa trabalhar em sua capacidade de concentração.

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 integrados de sessões psicológicas em formato JSON para cada aluno.
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 texto com até 10.000 caracteres.

2.3.2 Especificação do Output

Formato de output: O output deve ser um relatório de evolução psicológica em formato markdown, incluindo gráficos de progresso e espaço para comentários adicionais de psicólogos.