Agente de IA para Criação de Relatórios de Matrícula

Realizar chamadas às APIs dos sistemas escolares para obter dados de matrículas, rematrículas, transferências e desistências no período solicitado.

1.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente é o ponto de partida do fluxo e deve ser acionado pela necessidade de busca externa de dados. 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: Payloads prontos por fonte (endpoint, método, parâmetros de período, filtros por campus/segmento/série, cabeçalhos, credenciais/token).
• Formatos Suportados: Este agente deve ser capaz de receber payloads em formato JSON.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 10.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os dados brutos retornados pelas APIs e os metadados de coleta.
• Exemplo de Estrutura de Output:

   {
    "fonte": "SIS",
    "endpoint": "/api/matriculas",
    "timestamp_coleta": "2025-12-12T10:39:00Z",
    "periodo_consultado": "2025",
    "total_registros": 1500,
    "dados": [ ... ]
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.000 caracteres.

1.3.3 Parâmetros de Geração

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

1.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 os payloads recebidos para as APIs externas dos sistemas escolares e retornar os dados recebidos como resposta.

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 Compilação e Consolidação de Dados de Matrícula (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Compilação e Consolidação de Dados de Matrícula (RF 2).

Compilar, padronizar e consolidar dados de diferentes fontes em um único dataset estruturado e consistente para análise de matrículas.

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: Conjunto de datasets brutos (de APIs ou arquivos) e parâmetros de normalização.
• Formatos Suportados: Este 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.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON consolidado com dados normalizados e metadados de qualidade.
• Exemplo de Estrutura de Output:

   {
    "tabela_normalizada": [ ... ],
    "metadados_qualidade": {
      "linhas_descartadas": 10,
      "campos_nulos_por_coluna": { ... },
      "duplicidades_resolvidas": 5
    },
    "updated_at": "2025-12-12T10:39:00Z",
    "periodo_referencia": "2025"
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 10.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.
• 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 Geração de Relatórios 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 Geração de Relatórios de Matrícula (RF 3).

Produzir relatórios detalhados e personalizáveis sobre o status de matrículas e rematrículas, incluindo estatísticas de novos alunos, transferências e desistências.

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: JSON consolidado com métricas e eventos normalizados, além de especificação do relatório.
• Formatos Suportados: Este 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 relatório estruturado no formato solicitado, contendo todas as seções e informações detalhadas.
• Exemplo de Estrutura de Output: Relatório em formato solicitado, contendo: sumário executivo, KPIs principais, detalhamento por unidade/segmento/série, séries temporais, variações percentuais, alertas de variação atípica, notas metodológicas, definição dos termos e carimbo de data e período de referência.
• Número de caracteres esperado: O relatório gerado terá um tamanho aproximado de 25.000 caracteres.

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

3.3.4 Ferramentas do Agente

• Documentos: O conteúdo do documento "Tabela de Preços" (planilha) é inserido integralmente na janela de contexto, ao final do prompt principal, para garantir que o agente tenha acesso às informações mais atualizadas sobre planos e valores durante a geração da resposta.
• Calculadora: Não utiliza.
• 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 é o produto final e não precisa ser visível para agentes subsequentes.

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

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