Agente de IA para Atualização de Dados Escolares

Definir escopo e parâmetros de coleta para obter dados de alunos e turmas nas fontes oficiais (SIS e sistemas auxiliares).

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 escopo de coleta 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 contendo informações sobre o período de referência e unidades escolares.
• 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é 5.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo payloads de requisição prontos para execução, por fonte, com parâmetros detalhados.
• Exemplo de Estrutura de Output:

   [{
    "fonte":"SIS",
    "endpoint":"/alunos",
    "metodo":"GET",
    "parametros":{
      "periodo":"2025-1",
      "filtros":{},
      "campos":{
        "id_aluno",
        "matricula",
        "cpf",
        "nome_completo"
      }
    }
  }] 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 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 - Coleta 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 Chamada à API - Coleta de Dados (RF 2).

Executar chamadas às APIs/fonte de dados para coletar registros de alunos e turmas conforme payloads preparados.

2.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 1).
• Tipo do input: Este agente deve ser apto a receber como input uma lista de payloads prontos para execuçã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é 10.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um conjunto de datasets brutos por fonte e por tipo, com metadados de coleta.
• Exemplo de Estrutura de Output:

   {
    "alunos": [
      {"id_aluno": "123", "nome_completo": "João Silva"}
    ],
    "metadados": {"timestamp": "2025-12-14T07:08:00Z", "total_registros": 1}
  } 

• Número de caracteres esperado: O output gerado deve ser claro e direto, com 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: O agente deve executar chamadas às APIs conforme os payloads recebidos.

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 Escolares (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 Escolares (RF 3).

Unificar datasets de múltiplas fontes, padronizar formatos e preparar um dataset único de alunos e turmas.

3.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 2).
• Tipo do input: Este agente deve ser apto a receber dados brutos coletados por fonte, incluindo metadados de coleta.
• 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 dataset normalizado contendo alunos e turmas, com dicionário de campos e relatorio de mapeamento por fonte.
• Exemplo de Estrutura de Output:

   {
    "alunos_normalizados": [
      {"matricula": "2025001", "nome_completo": "Ana Souza"}
    ],
    "relatorio_de_mapeamento": {"fonte": "SIS", "total_registros": 1}
  } 

• Número de caracteres esperado: O output gerado deve ser claro e direto, com um tamanho estimado em 5.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 Validação de Consistência e Qualidade de Dados Escolares (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 e Qualidade de Dados Escolares (RF 4).

Aplicar regras de qualidade, integridade e consistência para decidir se o dataset pode seguir para atualização.

4.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 3).
• Tipo do input: Este agente deve ser apto a receber um dataset normalizado de alunos e turmas, juntamente com um dicionário de campos.
• 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é 8.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório de validação com detalhes sobre a qualidade e consistência dos dados.
• Exemplo de Estrutura de Output:

   {
    "prontopara_atualizacao": true,
    "pendencias_detectadas": false,
    "severidade_maxima": "baixa"
  } 

• Número de caracteres esperado: O output gerado deve ser claro e direto, com um tamanho estimado em 1.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 deve ser visível para o Agente de Execução de Chamada à API - Obter Estado Atual (RF 5).

4.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 - Obter Estado Atual (RF 5).

Resgatar o estado atual de alunos e turmas no SIS para comparação e cálculo de delta.

5.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 4).
• Tipo do input: Este agente deve ser apto a receber parâmetros de consulta 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é 5.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um snapshot atual do SIS contendo alunos e turmas, com metadados de coleta.
• Exemplo de Estrutura de Output:

   {
    "alunos_atual": [
      {"id_aluno": "123", "nome_completo": "João Silva"}
    ],
    "metadados": {"timestamp": "2025-12-14T07:08:00Z", "total_registros": 1}
  } 

• Número de caracteres esperado: O output gerado deve ser claro e direto, com 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: O agente deve executar consultas às APIs do SIS conforme os parâmetros recebidos.

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 Cálculo de Delta e Preparação de Atualizações (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Cálculo de Delta e Preparação de Atualizações (RF 6).

Comparar dataset normalizado com o estado atual do SIS e preparar operações de inserção, atualização e inativação.

6.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 5).
• Tipo do input: Este agente deve ser apto a receber um dataset normalizado validado e um snapshot atual do SIS.
• 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.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um plano de mudanças em JSON, incluindo operações de inserção, atualização e inativação.
• Exemplo de Estrutura de Output:

   {
    "inserts": [
      {"matricula": "2025002", "nome_completo": "Carlos Lima"}
    ],
    "updates": [
      {"antes": {"matricula": "2025001", "nome_completo": "Ana Souza"}, "depois": {"nome_completo": "Ana Maria Souza"}}
    ],
    "inativacoes": [
      {"matricula": "2025003"}
    ]
  } 

• Número de caracteres esperado: O output gerado deve ser claro e direto, com um tamanho estimado em 5.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: Não utiliza.
• 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 deve ser visível para o Agente de Execução de Chamada à API - Atualização de Registros (RF 7).

6.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 - Atualização de Registros (RF 7).

Executar as operações do plano de mudanças no SIS (inserts, updates, inativacoes).

7.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 6).
• Tipo do input: Este agente deve ser apto a receber um plano de mudanças com lotes paginados.
• 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é 8.000 caracteres.

7.3.2 Especificação do Output

• Formato de output: O output deve ser um resultado de execução por lote, incluindo sucessos, falhas e rejeições.
• Exemplo de Estrutura de Output:

   {
    "sucesso": [
      {"matricula": "2025002", "status": "inserido"}
    ],
    "falhas": [
      {"matricula": "2025003", "erro": "dados insuficientes"}
    ]
  } 

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

7.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

7.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deve executar operações de atualização conforme os planos de mudança recebidos.

7.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 Notificações e Resumo Operacional (RF 8).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Notificações e Resumo Operacional (RF 8).

Produzir resumos para administradores sobre o que foi atualizado e sobre pendências/inconsistências.

8.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 7).
• Tipo do input: Este agente deve ser apto a receber relatórios de validação, métricas do plano de mudanças e resultados de execuçã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é 5.000 caracteres.

8.3.2 Especificação do Output

• Formato de output: O output deve ser mensagens estruturadas para administradores, incluindo resumos de execução e pendências.
• Exemplo de Estrutura de Output:

   {
    "resumo_execucao": "Atualizações concluídas com sucesso. Taxa de sucesso: 98%.",
    "pendencias_resumidas": "Nenhuma pendência crítica detectada.",
    "recomendacoes": "Reprocessar dados de contato em unidade X."
  } 

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

8.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

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

8.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 - Envio de Notificações (RF 9).

8.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 - Envio de Notificações (RF 9).

Disparar notificações para os canais configurados (e-mail, webhook, chat corporativo).

9.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 8).
• Tipo do input: Este agente deve ser apto a receber payloads prontos para cada canal com destinatários e conteúdo.
• 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é 3.000 caracteres.

9.3.2 Especificação do Output

• Formato de output: O output deve ser confirmações de envio por canal, incluindo status e ids de mensagem.
• Exemplo de Estrutura de Output:

   {
    "email": {"status": "enviado", "id_mensagem": "abc123"},
    "webhook": {"status": "enviado", "id_mensagem": "def456"}
  } 

• Número de caracteres esperado: O output gerado deve ser claro e direto, com um tamanho estimado em 1.000 caracteres.

9.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

9.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deve executar o envio de notificações conforme os payloads recebidos.

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

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

A execução deste agente finaliza o fluxo. As confirmações de envio são o resultado que deve ser disponibilizado ao usuário.