PrototipeAI | Agente de IA para Elaboração de Laudos Psicológicos em Escolas

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 "Elaboração de Laudos Psicológicos em Escolas", uma solução de automação projetada para compilar dados de avaliações psicológicas, observações de professores e relatórios de pais, gerando laudos psicológicos detalhados. 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 é transformar inputs de diversas fontes em laudos psicológicos completos, respeitando normas e diretrizes psicológicas, para apoiar o trabalho de psicólogos e educadores nas escolas.

2. Contexto e Problema

Cenário Atual

Nas escolas, é comum a necessidade de se realizar avaliações psicológicas dos alunos para entender melhor suas necessidades e dificuldades. Para tanto, são coletadas informações de múltiplas fontes, como avaliações psicológicas, observações de professores e relatórios de pais. No entanto, o processo de compilação e análise dessas informações é complexo e demorado.

Problemas Identificados

Integração de dados: A dificuldade em integrar informações de diferentes fontes pode levar a laudos incompletos ou imprecisos.
Tempo de processamento: O tempo gasto na compilação manual de dados é elevado, atrasando a geração de laudos.
Qualidade dos laudos: A variabilidade na qualidade dos laudos devido a interpretações subjetivas pode afetar a eficácia das intervenções.

3. Impactos Esperados

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

Reduzir o tempo de elaboração de laudos em pelo menos 70%.
Padronizar a qualidade e o formato de todos os laudos psicológicos.
Aumentar a precisão das informações apresentadas nos laudos.
Facilitar a integração de dados de múltiplas fontes.

4. Visão Geral da Solução

O agente de IA para elaboração de laudos psicológicos em escolas compila dados de avaliações psicológicas, observações de professores e relatórios de pais, integrando essas informações de forma coerente e gerando laudos 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 elaboração de laudos psicológicos que seguem as especificidades da sua escola.

A solução consiste em um fluxo de automação composto por 2 agentes de IA. O processo inicia com a compilação de dados e termina com a geração de laudos psicológicos em formato markdown.

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

Agentes	Função Principal
`Agente de Compilação de Dados Psicológicos` (RF 1)	Coletar e integrar dados de avaliações psicológicas, observações de professores e relatórios de pais.
`Agente de Geração de Laudos Psicológicos` (RF 2)	Gerar laudos psicológicos detalhados e precisos com base nos dados compilados.

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 Compilação de Dados Psicológicos

1.1 Tarefa do Agente

Coletar e integrar dados de avaliações psicológicas, observações de professores e relatórios de pais em um formato estruturado.

1.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados de avaliações psicológicas, observações de professores e relatórios de pais. Estes dados podem estar em formato de texto ou planilhas.

# 2. Objetivo
Coletar e integrar esses dados em um formato estruturado JSON, garantindo que nenhuma informação relevante seja omitida.

# 3. Regras que você deve seguir para gerar sua resposta
- Extraia dados de todas as fontes disponíveis, garantindo que nenhuma informação relevante seja omitida.
- Integre informações de maneira coerente, assegurando a confidencialidade e privacidade dos dados dos alunos, conforme as normas de proteção de dados.
- Filtre e selecione apenas os dados que são relevantes e necessários para a elaboração dos laudos psicológicos, descartando informações redundantes ou irrelevantes.

# 4. Exemplo de Output que você deve produzir
{
  "dados_compilados": [
    {
      "tipo": "avaliação",
      "conteúdo": "Avaliação psicológica realizada em 21/11/2025..."
    },
    {
      "tipo": "observação",
      "conteúdo": "Observações do professor sobre o comportamento em sala..."
    }
  ]
}

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, observações e relatórios 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: Dados estruturados ou texto livre.
Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .txt, .csv, .xlsx.
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 no formato JSON, contendo os dados compilados de forma estruturada.

Exemplo de Estrutura de Output:

 {
  "dados_compilados": [
    {
      "tipo": "avaliação",
      "conteúdo": "Avaliação psicológica realizada em 21/11/2025..."
    }
  ]
}

Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.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 Laudos Psicológicos (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 Laudos Psicológicos (RF 2).

RF 2. Agente de Geração de Laudos Psicológicos

2.1 Tarefa do Agente

Gerar laudos psicológicos detalhados e precisos com base nos dados compilados.

2.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados estruturados em JSON provenientes do Agente de Compilação de Dados Psicológicos.

# 2. Objetivo
Gerar laudos psicológicos completos e detalhados em formato markdown, respeitando as normas e diretrizes psicológicas vigentes.

# 3. Regras que você deve seguir para gerar sua resposta
- Estruture o laudo respeitando as normas e diretrizes psicológicas vigentes, incluindo seções obrigatórias como histórico, avaliação e recomendações.
- Inclua todas as informações relevantes e necessárias para um entendimento completo do estado psicológico do aluno, garantindo que o conteúdo aborde todos os aspectos identificados nas avaliações.
- Assegure que a linguagem utilizada seja clara e precisa, facilitando o entendimento para todos os stakeholders envolvidos, como professores, pais e outros profissionais de saúde.

# 4. Exemplo de Output que você deve produzir
**Laudo Psicológico**

**Histórico:**
- Descrição do histórico do aluno.

**Avaliação:**
- Resultados da avaliação psicológica.

**Recomendações:**
- Recomendações para pais, professores e profissionais de saúde.

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: Dados estruturados em formato JSON.
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é 5.000 caracteres.

2.3.2 Especificação do Output

Formato de output: O output deve ser um arquivo em formato markdown, detalhando o laudo psicológico completo.