Agente de IA para Validação de Documentos Escolares

Implementar verificações automáticas de consistência em registros acadêmicos estruturados (CSV/JSON) e produzir um diagnóstico padronizado por registro.

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 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 do arquivo na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um arquivo CSV ou JSON, que contém registros acadêmicos estruturados.
• Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .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 uma lista de objetos JSON por registro, incluindo informações sobre inconsistências, normalizações aplicadas e um resumo agregado.
• Exemplo de Estrutura de Output:

   {
    "registro_id": "12345",
    "consistente": false,
    "inconsistencias": [
      {
        "codigo": "CAMPO_OBRIGATORIO_AUSENTE",
        "campo": "disciplina_id",
        "valor_encontrado": null,
        "descricao": "Campo obrigatório ausente.",
        "severidade": "erro",
        "sugestao_correcao": "Preencher campo disciplina_id."
      }
    ],
    "normalizacoes_aplicadas": [
      {
        "campo": "periodo_letivo",
        "valor_original": "2025/1",
        "valor_normalizado": "2025.1"
      }
    ],
    "resumo": {
      "total": 100,
      "consistentes": 80,
      "inconsistentes": 20,
      "duplicados": 5
    }
  }

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 5.000 caracteres por registro.

1.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

1.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para validação de consistência.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 Consulta a Documento (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 Consulta a Documento (RF 2).

Realizar consulta e extração estruturada de informações de documentos acadêmicos (ex.: histórico, diploma, declaração) a partir de parâmetros de busca/consulta já definidos.

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 parâmetros de busca para consulta de documentos acadêmicos.
• 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é 10.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado contendo as informações extraídas dos documentos.
• Exemplo de Estrutura de Output:

   {
    "documento_id": "67890",
    "tipo_de_documento": "historico_escolar",
    "campos_extraidos": {
      "nome_aluno": "João Silva",
      "curso": "Engenharia",
      "data_emissao": "2025-12-23"
    }
  }

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 2.000 caracteres por documento.

2.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

2.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 Validação de Documentos 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 Validação de Documentos Acadêmicos (RF 3).

Validar documentos acadêmicos com base em regras institucionais, requisitos de completude, conformidade de layout e coerência de conteúdo com registros acadêmicos estruturados.

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 dados estruturados de documentos acadêmicos e resumos de consistência de registros acadêmicos.
• 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é 12.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado validando cada documento e destacando inconsistências.
• Exemplo de Estrutura de Output:

   {
    "documento_id": "67890",
    "valido": true,
    "issues": [
      {
        "codigo": "DATA_EMISSAO_FUTURA",
        "descricao": "Data de emissão do documento está no futuro.",
        "severidade": "erro"
      }
    ]
  }

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 3.000 caracteres por documento.

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

3.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para validação de documentos.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 Automação de Alertas e Notificações (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Automação de Alertas e Notificações (RF 4).

Gerar eventos de alerta e notificações operacionais para responsáveis quando houver inconsistências ou documentos inválidos, classificando prioridade e destinatários.

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 resultados consolidados dos agentes anteriores.
• 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é 15.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado contendo os eventos de alerta e notificações gerados.
• Exemplo de Estrutura de Output:

   {
    "eventos": [
      {
        "tipo_item": "documento",
        "id": "67890",
        "severidade": "alta",
        "motivo_principal": "DATA_EMISSAO_FUTURA",
        "destinatarios": [
          {
            "papel": "secretaria_academica",
            "canal_preferencial": "sistema"
          }
        ],
        "prazo_resposta_horas": 24,
        "mensagem": "[VALIDAÇÃO ACADÊMICA] Documento com data de emissão futura.",
        "deduplicacao_chave": "abc123",
        "enviar": true
      }
    ],
    "resumo": {
      "total_eventos": 10,
      "por_severidade": {
        "alta": 5,
        "media": 3,
        "baixa": 2
      }
    }
  }

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 5.000 caracteres por evento.

4.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

4.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para geração de alertas e notificações.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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

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

A execução deste agente finaliza o fluxo. Os eventos de alerta e notificações gerados são os resultados que devem ser disponibilizados aos responsáveis.