Agente de IA para Emissão de Diplomas e Certificados

Validar e padronizar os dados que serão usados na emissão de diplomas e certificados, garantindo integridade, coerência, deduplicação e prontidão para geração de layout padronizado.

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 uma planilha ou objeto JSON contendo registros acadêmicos 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: O input inicial para o fluxo é uma planilha .xlsx ou .csv, ou um objeto JSON estruturado.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .xlsx, .csv, .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo a validação dos dados e os registros normalizados, prontos para a geração de documentos.
• Exemplo de Estrutura de Output:

   {"dados_validos": true, "registros_normalizados": [{"id_registro": "123", "nome_completo": "Cheila Portela", "nome_display": "Cheila Portela", "documento_oficial": {"tipo": "CPF", "valor": "000.000.000-00", "pais": "BR"}, "matricula": "2025A0001", "curso": "Engenharia de Software", "curso_codigo": "ENGSW-BAC", "nivel_curso": "Graduação", "tipo_documento": "diploma", "carga_horaria": null, "data_conclusao": "2025-11-20", "data_conclusao_extenso": "20 de novembro de 2025", "local": "São Paulo", "idioma": "pt-BR", "instituicao": "Instituição Exemplo", "campus": "Campus Central", "codigo_verificacao": "DIP-2025-123-ABCD", "signatarios": [{"nome": "Reitora Exemplo", "cargo": "Reitora"}], "placeholders_alinhados": {"ALUNO_NOME": "Cheila Portela", "CURSO_TITULO": "Engenharia de Software", "CURSO_COD": "ENGSW-BAC", "DATA_EXTENSO": "20 de novembro de 2025", "LOCALIDADE": "São Paulo", "INSTITUICAO": "Instituição Exemplo", "CAMPUS": "Campus Central", "CODIGO_VERIFICACAO": "DIP-2025-123-ABCD"}}], "erros": [], "avisos": []} 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 5.000 caracteres, podendo variar conforme a quantidade de registros processados.

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 Relatório de Inconsistências para Correção Humana (RF 2) e o Agente Preparador de Payload para Geração de Diplomas e Certificados (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Relatório de Inconsistências para Correção Humana (RF 2) caso os dados não sejam válidos, ou o Agente Preparador de Payload para Geração de Diplomas e Certificados (RF 3) caso os dados sejam válidos.

Consolidar e apresentar, de forma clara, os erros e avisos detectados na validação para facilitar a correção humana antes de nova tentativa de emissão.

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) caso os dados sejam inválidos.
• Tipo do input: Este agente deve ser apto a receber um objeto JSON contendo dados inválidos e lista de erros/avisos.
• 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é 10.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório textual estruturado, destacando erros e avisos para correção humana.
• Exemplo de Estrutura de Output:

   # Relatório de Inconsistências de Emissão
  
  Resumo geral:
  - Registros totais: 10
  - Registros com erro bloqueante: 3
  - Registros com avisos: 4
  
  Detalhamento por registro:
  - id_registro: 123
    - Erros (bloqueantes): campo=carga_horaria → "Obrigatório para certificados e deve ser > 0"; campo=signatarios → "Mínimo 1 signatário com nome e cargo".
    - Sugestão de correção: Informar carga_horaria em horas (ex.: 40) e adicionar signatário.
  
  - id_registro: 124
    - Avisos: campo=nome_completo → "Ajustado para capitalização padrão".
  
  Modelo de linha corrigida (exemplo):
  | id_registro | nome_completo    | tipo_documento | carga_horaria | data_conclusao | ... |
  | 123         | Cheila Portela   | certificado    | 40            | 2025-11-20     | ... |
  
  Próximos passos: corrigir os itens bloqueantes e reenviar a planilha/JSON. 

• Número de caracteres esperado: O relatório gerado deve ter um tamanho estimado em 3.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: 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 é apenas para uso humano e não é passada para outros agentes internos.

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

Este agente não prepara payload nem aciona renderização. Ele apenas produz relatório para ajuste humano e encerra seu fluxo após a geração do relatório.

Selecionar o modelo padronizado apropriado e montar o payload de renderização conforme layouts aprovados pela instituiçã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 1) caso os dados sejam válidos.
• Tipo do input: Este agente deve ser apto a receber um objeto JSON contendo dados válidos e registros normalizados prontos.
• 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é 15.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON do payload, com campos estritamente no formato esperado pela API de renderização.
• Exemplo de Estrutura de Output:

   {"template_id": "TPL_DIPLOMA_PT_BR_V3", "template_version": "3.0", "output_format": "PDF", "locale": "pt-BR", "layout_constraints": {"margens_mm": {"sup": 15, "inf": 15, "esq": 15, "dir": 15}, "tamanho_pagina": "A4", "fonte_padrao": "Times New Roman", "font_scale_permitida": true}, "records": [{"id_registro": "123", "placeholders": {"ALUNO_NOME": "Cheila Portela", "CURSO_TITULO": "Engenharia de Software", "DATA_EXTENSO": "20 de novembro de 2025", "LOCALIDADE": "São Paulo", "INSTITUICAO": "Instituição Exemplo", "CODIGO_VERIFICACAO": "DIP-2025-123-ABCD"}, "qr_code": {"conteudo_url": "https://verifica.instituicao.exemplo/DIP-2025-123-ABCD", "posicao": "inferior_direita"}, "assinaturas": [{"nome": "Reitora Exemplo", "cargo": "Reitora", "posicao": "inferior_centro"}], "ajustes_tipograficos": {"ALUNO_NOME": {"line_breaks": [], "font_scale": 0.95}}}], "erros_template": []} 

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

3.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 - Renderização de Documentos (RF 4).

Realizar chamada à API do Sistema Gerador de Documentos para obter os PDFs renderizados com base no payload preparado.

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 um payload pronto para execução, exatamente no formato esperado pela API de 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 até 15.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o status da operação e os links dos PDFs renderizados.
• Exemplo de Estrutura de Output:

   {"status": "sucesso", "itens": [{"id_registro": "123", "pdf_url": "https://arquivos.instituicao.exemplo/diplomas/123.pdf", "template_usado": "TPL_DIPLOMA_PT_BR_V3", "template_version": "3.0", "checksum": "sha256:abc..."}], "falhas": []} 

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

4.3.3 Parâmetros de Geração

• Modelo: Não se aplica (uso de ferramenta)
• Temperatura: Não se aplica (uso de ferramenta)

4.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o JSON recebido para a API externa do Sistema Gerador de Documentos e retornar o resultado recebido como resposta.

4.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Verificação Pós-Render e Preparação de Entrega (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Verificação Pós-Render e Preparação de Entrega (RF 5).

Verificar conformidade entre o resultado da renderização e o payload aprovado, consolidar a lista final de documentos e preparar a resposta/entrega.

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 o JSON de retorno do Agente Executor e o payload originalmente enviado.
• 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é 20.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com o status da verificação, lista de documentos aprovados e pendências, se houver.
• Exemplo de Estrutura de Output:

   {"qa_status": "aprovado", "verificacoes": {"quantidade_solicitada": 10, "quantidade_recebida": 10, "quantidade_aprovada": 10, "placeholders_restantes": 0, "templates_divergentes": 0, "checksums_ok": true}, "itens": [{"id_registro": "123", "pdf_url": "https://.../123.pdf", "template_usado": "TPL_DIPLOMA_PT_BR_V3", "template_version": "3.0"}], "pendencias": [], "mensagem_resumo": "Emissão concluída com sucesso para 10/10 documentos."} 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 3.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: 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 não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta gerada por este agente é o entregável final e não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo. A resposta gerada é o resultado que deve ser disponibilizado ao usuário ou sistema institucional.