Agente de IA para Gestão de Documentação Escolar

Receber arquivos de documentos escolares, identificar tipo, extrair metadados essenciais e padronizar nomenclatura e estrutura de dados para cadastro do aluno.

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 documentos escolares 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 dos documentos na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo são documentos escolares em formato digital.
• Formatos Suportados: Esse agente deve ser capaz de receber documentos nos formatos: .pdf, .jpg, .png.
• 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 JSON contendo informações detalhadas sobre cada documento processado, incluindo tipo_documento, metadados, padrao_nome_arquivo e status_documento.
• Exemplo de Estrutura de Output:

   {
    "ingestao_concluida": true,
    "documentos_processados": [
      {
        "arquivo_id": "12345",
        "tipo_documento": "certidao_nascimento",
        "metadados": {
          "nome_aluno": "Joao Silva",
          "data_nascimento": "2010-05-12",
          "emissor": "Cartorio Central",
          "data_emissao": "2010-05-15",
          "pais": "BR"
        },
        "padrao_nome_arquivo": "certidao_nascimento__123__joao_silva__cartorio_central__2010-05-15__v1.pdf",
        "normalizacoes_aplicadas": ["minusculo","sem_acentos","espacos_para_underscore"],
        "qualidade_legibilidade": "alta",
        "status_documento": "legivel"
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 3.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 Validação de Conformidade Documental (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Validação de Conformidade Documental (RF 2).

Validar completude, consistência e atualidade do conjunto de documentos do aluno frente às regras escolares.

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 contendo informações detalhadas dos documentos processados pelo agente anterior.
• 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 texto com até 10.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o resumo de conformidade dos documentos escolares, incluindo status_geral_dossie, itens_avaliados e resumo_conformidade.
• Exemplo de Estrutura de Output:

   {
    "validacao_concluida": true,
    "resumo_conformidade": {
      "faltantes": [],
      "duplicados": [],
      "vencidos": [],
      "ilegiveis": [],
      "metadados_incompletos": []
    },
    "status_geral_dossie": "completo",
    "itens_avaliados": [
      {
        "tipo_documento": "certidao_nascimento",
        "conforme": true,
        "motivos_nao_conformidade": [],
        "referencia_arquivo": "certidao_nascimento__123__joao_silva__cartorio_central__2010-05-15__v1.pdf"
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 2.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 deve ser visível para o Agente de Atualização de Status dos Documentos do Aluno (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Atualização de Status dos Documentos do Aluno (RF 3).

Atualizar o status consolidado do dossiê do aluno e preparar registro padronizado para persistência.

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 o resumo de conformidade gerado pelo agente anterior.
• 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 texto com até 5.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o registro padronizado do dossiê do aluno, incluindo status_geral_dossie e documentos.
• Exemplo de Estrutura de Output:

   {
    "registro_padronizado": {
      "aluno_id": "123",
      "aluno_nome": "Joao Silva",
      "status_geral_dossie": "completo",
      "documentos": [
        {
          "tipo_documento": "certidao_nascimento",
          "status": "conforme",
          "motivos": [],
          "arquivo": "certidao_nascimento__123__joao_silva__cartorio_central__2010-05-15__v1.pdf",
          "data_referencia": "2010-05-15"
        }
      ]
    },
    "atualizacao_status_concluida": true
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 2.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 Geração de Alertas a Responsáveis (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Alertas a Responsáveis (RF 4).

Gerar conteúdo padronizado de alerta sobre documentos faltantes ou inconsistentes para comunicação aos responsáveis.

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 o registro padronizado do dossiê do aluno gerado pelo agente anterior.
• 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 texto com até 5.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo informações sobre alertas pendentes e detalhes dos documentos faltantes ou inconsistentes.
• Exemplo de Estrutura de Output:

   {
    "ha_alertas_pendentes": true,
    "alertas": [
      {
        "aluno_id": "123",
        "canal_sugerido": "email",
        "assunto": "Documentos escolares pendentes para Joao Silva",
        "mensagem": "Prezado responsável, seguem as pendências de documentos escolares do aluno Joao Silva: ...",
        "itens_pendentes": [
          {
            "tipo_documento": "comprovante_residencia",
            "motivos": ["nao_enviado"],
            "instrucoes_envio": "Favor enviar o documento em formato pdf, jpg ou png, com tamanho máximo de 2MB, em até 7 dias."
          }
        ]
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 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: 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 finaliza o fluxo 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 alertas gerados são o resultado que deve ser disponibilizado aos responsáveis.