Agente de IA para Emissão Automatizada de Históricos Escolares

Construir o payload de consulta para recuperar dados acadêmicos do aluno nos sistemas institucionais.

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 identificadores do aluno 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 de um csv na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um conjunto de identificadores do aluno e escopo da solicitação.
• Formatos Suportados: Esse agente deve ser capaz de receber dados em formato JSON.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 10.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado contendo o payload de consulta para os sistemas institucionais.
• Exemplo de Estrutura de Output:

   {
    "endpoints": [...],
    "parametros": {
      "aluno_id": "...",
      "filtros": {...}
    },
    "headers": {...}
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 2.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 Execução de Chamada à API (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Execução de Chamada à API (RF 2).

Realizar chamada à API do Sistema Acadêmico institucional para obter dados acadêmicos brutos do aluno.

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 estruturado contendo o payload de consulta para os sistemas institucionais.
• 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 input de até 2.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um conjunto de dados brutos recuperados das chamadas à API, estruturados por coleção solicitada.
• Exemplo de Estrutura de Output:

   {
    "dados_pessoais": [...],
    "vinculos_curso": [...],
    "disciplinas_cursadas": [...]
  } 

• Número de caracteres esperado: O conjunto de dados gerado deve ter um tamanho estimado em torno de 10.000 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: O agente executa chamadas à API externa para recuperar dados acadêmicos.

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 deve ser visível para o Agente de Consolidação e Normalização de Dados Acadêmicos (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Consolidação e Normalização de Dados Acadêmicos (RF 3).

Unificar, higienizar e normalizar os dados brutos em um JSON acadêmico padronizado pronto para validação.

3.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 2).
• Tipo do input: Este agente deve ser apto a receber como input um conjunto de dados brutos estruturados por coleção.
• 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 input de até 10.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON acadêmico padronizado pronto para validação, contendo informações normalizadas e higienizadas.
• Exemplo de Estrutura de Output:

   {
    "aluno": {"nome": "...", "cpf": "..."},
    "curso": {"codigo": "...", "nome": "..."},
    "disciplinas": [...],
    "gpa": {...},
    "status_normalizacao": "ok"
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 8.000 caracteres.

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

3.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para normalização e higienização dos dados.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

3.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 Validação de Consistência Acadêmica (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Validação de Consistência Acadêmica (RF 4).

Validar automaticamente consistência, completude e regras acadêmicas no JSON normalizado antes da formatação.

4.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 3).
• Tipo do input: Este agente deve ser apto a receber como input um JSON acadêmico padronizado pronto para validação.
• 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 input de até 8.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON normalizado com bloco de validacao {status: "aprovado"|"reprovado", erros:[], avisos:[], metricas:{...}}.
• Exemplo de Estrutura de Output:

   {
    "status": "aprovado",
    "erros": [],
    "avisos": [...],
    "metricas": {...}
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 3.000 caracteres.

4.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

4.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para validação das regras acadêmicas.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

4.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 5).

4.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 5).

Aplicar formatação padronizada e gerar o histórico escolar em texto estruturado.

5.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 4).
• Tipo do input: Este agente deve ser apto a receber como input um JSON normalizado validado (validacao.status == "aprovado").
• 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 input de até 8.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um histórico escolar formatado em markdown, acompanhado de um sumário técnico de formatação.
• Exemplo de Estrutura de Output:

   # Histórico Escolar
  
  **Instituição:** Nome da Instituição
  **CNPJ:** 12.345.678/0001-90
  **Curso:** Nome do Curso
  **Nível:** Graduação
  **Turno:** Noturno
  **Campus:** Cidade/UF
  
  ## Dados do Aluno
  
  **Nome:** Nome do Aluno
  **Documento:** 123.456.789-00
  **Matrícula:** 20251234
  **Data de Emissão:** 17/12/2025
  
  ## Disciplinas por Período
  
  | Código | Disciplina | CH  | Nota | Frequência | Situação |
  |--------|------------|-----|------|------------|----------|
  | 001    | Disciplina | 60  | 9,5  | 100,0%     | Aprovado |
  
  ## GPA/CR
  
  **GPA por Período:** 9,5
  **GPA Acumulado:** 9,0
  
  ## Totais
  
  **Cursada:** 1200
  **Aprovada:** 1150
  
  ## Observações
  
  - Trancamento no período 2021/1
  
  ## Rodapé
  
  Verificação: abcdef1234567890
  
  *Este documento pode ser verificado junto à instituição para garantir sua autenticidade.* 

• Número de caracteres esperado: O markdown gerado deve ter um tamanho estimado em torno de 4.000 caracteres.

5.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

5.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para formatação dos dados.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

5.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 Validação de Conformidade do Documento para Emissão (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Validação de Conformidade do Documento para Emissão (RF 6).

Inspecionar o documento formatado e atestar conformidade com requisitos institucionais antes da emissão.

6.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 5).
• Tipo do input: Este agente deve ser apto a receber como input um histórico escolar em markdown e o JSON normalizado validado.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .md (Markdown) e .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input combinado de até 12.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um histórico escolar validado e pronto para emissão, com relatório de conformidade {status, checklist, não-conformidades, recomendações}.
• Exemplo de Estrutura de Output:

   {
    "status": "conforme",
    "checklist": [...],
    "nao_conformidades": [],
    "recomendacoes": [...]
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 3.000 caracteres.

6.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

6.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para validação de conformidade do documento.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

6.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 conclui o fluxo de emissão automatizada de históricos escolares.

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

A execução deste agente finaliza o fluxo. O histórico escolar validado é o resultado que deve ser disponibilizado ao usuário.