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 "Emissão de Históricos Escolares", uma solução projetada para automatizar a compilação de dados acadêmicos e emissão de históricos escolares padronizados e precisos. 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 dados acadêmicos dos alunos em históricos escolares formatados e consistentes, eliminando erros e padronizando a apresentação dos dados.
2. Contexto e Problema
Cenário Atual
Atualmente, a compilação de dados acadêmicos para a emissão de históricos escolares é realizada de forma manual, o que gera diversos problemas:
- Processo manual suscetível a erros na compilação dos dados.
- Formatação inconsistente dos históricos escolares.
Esses problemas resultam em históricos escolares com informações imprecisas e formatos variados, causando dificuldades tanto para os alunos quanto para as instituições.
Problemas Identificados
- Erros de Compilação: A coleta manual de dados está sujeita a erros de digitação e omissões, comprometendo a precisão dos históricos.
- Inconsistência de Formatação: A falta de um padrão rigoroso de formatação resulta em históricos que variam em estrutura e conteúdo.
3. Impactos Esperados
A implementação deste agente de IA visa alcançar os seguintes resultados:
- Automatizar a compilação de dados acadêmicos eliminando a intervenção manual.
- Padronizar a formatação dos históricos escolares garantindo consistência e clareza.
- Reduzir erros e aumentar a precisão dos dados apresentados nos históricos.
4. Visão Geral da Solução
O agente de IA para emissão de históricos escolares compila dados acadêmicos dos alunos e emite históricos escolares detalhados e precisos. 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 emissão de históricos escolares padronizados e precisos.
A solução é composta por dois agentes principais que automatizam o processo de compilação de dados e formatação dos históricos.
A execução dos agentes é sequencial, seguindo a ordem definida na tabela abaixo.
| Agentes | Função Principal |
|---|---|
Agente de Compilação de Dados Acadêmicos (RF 1)
| Automatizar a compilação de dados acadêmicos dos alunos para emissão de históricos escolares. |
Agente de Formatação de Histórico Escolar (RF 2)
| Garantir a formatação padronizada e detalhada dos históricos escolares. |
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 aluno ou instituição receberá. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Compilação de Dados Acadêmicos
1.1 Tarefa do Agente
Automatizar a compilação de dados acadêmicos dos alunos para emissão de históricos escolares.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados acadêmicos dos alunos em formato CSV ou planilha com colunas 'nome', 'matrícula', 'disciplinas', 'notas', 'carga_horária'.
# 2. Objetivo
Automatizar a compilação desses dados em um formato estruturado para posterior formatação e emissão dos históricos escolares.
# 3. Regras que você deve seguir para gerar sua resposta
- Converta os dados acadêmicos recebidos em formato CSV ou planilha para JSON.
- Verifique se todas as colunas 'nome', 'matrícula', 'disciplinas', 'notas', 'carga_horária' estão preenchidas.
- Valide a precisão dos dados comparando com registros anteriores quando disponíveis.
- Corrija inconsistências nos dados, como formatação inadequada de nomes ou matrículas, usando padrões predefinidos.
# 4. Exemplo de Output que você deve produzir
{
"nome": "João Silva",
"matrícula": "123456",
"disciplinas": [
{
"nome": "Matemática",
"nota": "9.0",
"carga_horária": "60h"
},
{
"nome": "História",
"nota": "8.5",
"carga_horária": "60h"
}
]
} 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 acadêmicos dos alunos em formato CSV ou planilha 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 acadêmicos dos alunos em formato CSV ou planilha.
-
Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos:
.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 acadêmicos compilados e validados.
-
Exemplo de Estrutura de Output:
{ "nome": "João Silva", "matrícula": "123456", "disciplinas": [ { "nome": "Matemática", "nota": "9.0", "carga_horária": "60h" }, { "nome": "História", "nota": "8.5", "carga_horária": "60h" } ] } - Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 3.000 caracteres, podendo variar conforme a quantidade de disciplinas por aluno.
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 Formatação de Histórico Escolar (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Formatação de Histórico Escolar (RF 2).
RF 2. Agente de Formatação de Histórico Escolar
2.1 Tarefa do Agente
Garantir a formatação padronizada e detalhada dos históricos escolares.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo dados acadêmicos compilados e validados em formato JSON. # 2. Objetivo Formatar esses dados em um histórico escolar padronizado e detalhado, pronto para emissão. # 3. Regras que você deve seguir para gerar sua resposta - Aplique um template padronizado para formatação do histórico escolar. - Inclua informações detalhadas de disciplinas, notas e carga horária conforme padrões estabelecidos. - Assegure que o layout do histórico escolar seja consistente e de fácil leitura, seguindo diretrizes de formatação. - Confirme a presença e correta formatação de todas as informações obrigatórias antes da emissão. # 4. Exemplo de Output que você deve produzir **Histórico Escolar** - **Nome:** João Silva - **Matrícula:** 123456 **Disciplinas:** 1. **Matemática** - Nota: 9.0 - Carga Horária: 60h 2. **História** - Nota: 8.5 - Carga Horária: 60h
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 acadêmicos compilados e validados 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 texto com até 3.000 caracteres.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um histórico escolar formatado em **Markdown**.
-
Exemplo de Estrutura de Output:
**Histórico Escolar** - **Nome:** João Silva - **Matrícula:** 123456 **Disciplinas:** 1. **Matemática** - Nota: 9.0 - Carga Horária: 60h 2. **História** - Nota: 8.5 - Carga Horária: 60h
- Número de caracteres esperado: O histórico escolar formatado deve ter um tamanho estimado em torno de 1.500 caracteres.
2.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.6
2.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.
2.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 é o entregável final do fluxo e não precisa ser visível para outros agentes.
2.3.6 Regras de Orquestração e Transição
A execução deste agente finaliza o fluxo. O histórico escolar formatado é o resultado que deve ser disponibilizado ao usuário.