Agente de IA para Emissão de Declarações de Matrícula

Validar, normalizar e estruturar o pedido de declaração de matrícula, definindo o template e os parâmetros necessários para execução do fluxo.

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 um JSON de solicitação de declaração 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 do JSON na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um JSON com os campos mínimos de solicitação da declaração.
• 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é 2.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON 'solicitacao_normalizada' com os parâmetros normalizados e validados, prontos para os próximos agentes do fluxo.
• Exemplo de Estrutura de Output:

   {
    "aluno_chave": { "tipo": "ra", "valor": "123456" },
    "referencia_data": "2025-12-14",
    "idioma": "pt-BR",
    "template_id": "DECL_MATRICULA_V1",
    "variacao": "regular",
    "campos_requeridos": ["nome_completo","curso","status_matricula","periodo_letivo","campus","data_emissao","aluno_identificador"],
    "faltantes": [],
    "prosseguir": true,
    "mensagens_validacao": [],
    "flags": { "precisa_busca_sis": true, "precisa_pdf": true, "incluir_qr": true, "incluir_assinatura": true }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 1.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 Consultas em Banco de Dados (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 Consultas em Banco de Dados (RF 2) se a propriedade precisa_busca_sis for true. Caso contrário, o fluxo prossegue diretamente para o Agente de Conciliação e Verificação de Matrícula (RF 3).

Realizar consulta ao SIS acadêmico para obter dados cadastrais e status de matrícula 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), desde que a propriedade precisa_busca_sis seja true.
• Tipo do input: Este agente deve ser apto a receber como input um JSON com os parâmetros prontos para consulta no SIS acadêmico.
• 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é 1.500 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON 'dados_aluno_db' com os campos solicitados preenchidos, incluindo status e vínculos ativos na data de referência.
• Exemplo de Estrutura de Output:

   {
    "nome": "João Silva",
    "cpf": "123.456.789-00",
    "ra": "123456",
    "curso": "Engenharia da Computação",
    "campus": "Campus Principal",
    "status_atual": "ATIVO",
    "found": true,
    "fonte": "SIS_Academico",
    "timestamp_coleta": "2025-12-14T11:56:00Z"
  } 

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

2.3.3 Parâmetros de Geração

• Modelo: Não se aplica (execução de consulta).
• Temperatura: Não se aplica.

2.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Executa consulta ao SIS acadêmico para obter dados do aluno.

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 Conciliação e Verificação de Matrícula (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Conciliação e Verificação de Matrícula (RF 3).

Conciliar a solicitação com os dados do SIS e determinar o status de matrícula aplicável à declaração, resolvendo campos para o template.

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 JSON contendo a solicitação normalizada e os dados do SIS acadêmico.
• 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é 2.500 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON 'registro_matricula_validado' com os campos resolvidos e o status de matrícula determinado.
• Exemplo de Estrutura de Output:

   {
    "emissao": { "data": "2025-12-14", "local": "Campus Principal" },
    "aluno": { "nome": "João Silva", "ra": "123456", "cpf_mascarado": "XXX.XXX.XXX-00", "email_institucional": "joao.silva@universidade.edu" },
    "curso": { "nome": "Engenharia da Computação", "turno": "Integral", "campus": "Campus Principal", "carga_horaria": "3600" },
    "periodo_letivo": { "atual": "2025.2", "label": "2025.2" },
    "status": { "codigo": "ATIVO", "elegivel_declaracao": true, "mensagem_explicativa": "Aluno ativo e regular" },
    "variacao_template": "regular",
    "signatario": { "cargo": "Diretor(a) Acadêmico(a)", "nome": "Maria Souza" },
    "hash_verificacao": "abc123def456",
    "url_verificacao": "https://universidade.edu/verificar?hash=abc123def456"
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 1.500 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: Não utiliza.
• 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 Redator da Declaração de Matrícula (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente Redator da Declaração de Matrícula (RF 4).

Gerar o conteúdo textual padronizado da declaração conforme idioma, variação e template definidos.

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 contendo os dados validados da matrícula e o template para a declaração.
• 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é 2.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON 'declaracao_texto_struct' com o conteúdo textual padronizado da declaração.
• Exemplo de Estrutura de Output:

   {
    "titulo": "Declaração de Matrícula",
    "corpo_paragrafos": ["O aluno João Silva, RA 123456, está regularmente matriculado no curso Engenharia da Computação, no período letivo 2025.2, no Campus Principal, com status 'Ativo'."],
    "rodape_linhas": ["Este documento pode ser verificado em https://universidade.edu/verificar?hash=abc123def456"],
    "metadados": { "idioma": "pt-BR", "template_id": "DECL_MATRICULA_V1", "variacao": "regular", "data_emissao": "2025-12-14", "campus": "Campus Principal", "hash_verificacao": "abc123def456", "url_verificacao": "https://universidade.edu/verificar?hash=abc123def456" }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 1.200 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: Não utiliza.
• 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 Preparação de Payload de PDF (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Preparação de Payload de PDF (RF 5).

Transformar o conteúdo textual da declaração em payload estruturado para renderização em PDF, incluindo logos, assinaturas e QR Code.

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), desde que a propriedade precisa_pdf seja true.
• Tipo do input: Este agente deve ser apto a receber como input um JSON contendo o conteúdo textual da declaração e as referências de ativos para PDF.
• 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é 2.500 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON 'pdf_payload' pronto para API de renderização.
• Exemplo de Estrutura de Output:

   {
    "page": { "size": "A4", "margins": { "top": 72, "right": 54, "bottom": 72, "left": 54 } },
    "header": { "logo": "https://universidade.edu/assets/logo.png", "titulo": "Declaração de Matrícula" },
    "body": { "paragrafos": ["O aluno João Silva, RA 123456, está regularmente matriculado no curso Engenharia da Computação, no período letivo 2025.2, no Campus Principal, com status 'Ativo'."] },
    "footer": { "linhas": ["Este documento pode ser verificado em https://universidade.edu/verificar?hash=abc123def456"], "qr": { "url": "https://universidade.edu/verificar?hash=abc123def456", "legenda": "Verifique a autenticidade" } },
    "fontes": { "primarias": "serif", "tamanho": 12 },
    "metadados": { "template_id": "DECL_MATRICULA_V1", "hash": "abc123def456", "idioma": "pt-BR" }
  } 

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

5.3.3 Parâmetros de Geração

• Modelo: Não se aplica (preparação de payload).
• Temperatura: Não se aplica.

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

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 Execução de Chamada à API (RF 6).

5.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 6) se a propriedade precisa_pdf for true. Caso contrário, o fluxo é finalizado.

Realizar chamada ao serviço de renderização de PDF para gerar a declaração final.

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 JSON contendo o payload de PDF pronto para renderização.
• 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é 2.500 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com o arquivo PDF renderizado e seus metadados.
• Exemplo de Estrutura de Output:

   {
    "arquivo_pdf_base64": "JVBERi0xLjQKJcfs...",
    "mime_type": "application/pdf",
    "paginas": 1,
    "tamanho_bytes": 204800,
    "checksum_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
  } 

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

6.3.3 Parâmetros de Geração

• Modelo: Não se aplica (execução de chamada à API).
• Temperatura: Não se aplica.

6.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Executa chamada ao serviço de renderização de PDF para gerar o arquivo final.

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 é o entregável final e não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo. O JSON gerado é o resultado que deve ser disponibilizado ao usuário.