Agente de IA para Suporte a Decisões de Matrícula

Validar a estrutura e a qualidade dos dados históricos de matrículas e normalizá-los para uso analítico consistente.

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 arquivo ou payload tabular 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 é um arquivo ou payload tabular (CSV/JSON).
• 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 até 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o status de validação, motivos de reprovação (se houver), dataset padronizado, dicionário de dimensões, métricas de qualidade e flags.
• Exemplo de Estrutura de Output:

   {
    "status_validacao": "aprovado",
    "motivos_reprovacao": [],
    "dataset_padronizado": [{"ano": 2025, "curso_id": "123", "curso_nome": "Administração", "numero_matriculas": 200, "taxa_retencao": 0.85}],
    "dicionario_dimensoes": {"curso_mapeamento": {"original": "padrao"}},
    "metricas_qualidade": {"linhas_totais": 1000, "linhas_invalidas": 50, "linhas_deduplicadas": 5, "%faltantes_por_campo": {"numero_matriculas": 0.02}},
    "flags": {"dados_prontos_para_analise": true}
  } 

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 5.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: Utiliza lógica interna para calcular métricas de qualidade.
• 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 Análise Descritiva e Tendências de Matrículas (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Análise Descritiva e Tendências de Matrículas (RF 2).

Gerar insights descritivos e de tendência a partir do dataset padronizado.

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 um JSON contendo o dataset padronizado e a flag de dados prontos para análise.
• 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 com insights descritivos, tendências e alertas identificados.
• Exemplo de Estrutura de Output:

   {
    "insights_descritivos": {
      "resumo_geral": {"anos_cobertos": [2020, 2021, 2022], "cursos_totais": 10, "media_matriculas_anual": 200, "crescimento_total_%": 0.15},
      "top_cursos_por_matriculas": [{"curso_id": "123", "curso_nome": "Administração", "matriculas_ultimo_ano": 200}],
      "evolucao_por_curso": [{"curso_id": "123", "serie": {"2020": 150, "2021": 180, "2022": 200}, "cagr_5a": 0.10}],
      "analise_retencao": {"mediana": 0.85, "cursos_acima_da_mediana": ["Administração"]},
      "alertas": {"queda_relevante": [{"curso": "Engenharia", "queda_%_3anos": 0.20}], "capacidade_saturada_suspeita": [{"curso": "Medicina", "crescimento_%_2anos": 0.25}]},
      "carimbo_tempo": "2025-04-12T10:22:00Z",
      "analise_concluida": true
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 5.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: Utiliza lógica interna para calcular insights e tendências.
• 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 Projeção Simplificada de Matrículas (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Projeção Simplificada de Matrículas (RF 3).

Produzir projeções de curto prazo por curso com base em tendências históricas simples.

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 como input um JSON contendo insights descritivos e tendências por curso.
• 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.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo projeções de curto prazo por curso.
• Exemplo de Estrutura de Output:

   {
    "projecoes": {
      "horizonte_anos": 3,
      "por_curso": [{"curso_id": "123", "curso_nome": "Administração", "base_ano": 2022, "base_valor": 200, "metodologia": "CAGR", "projecoes": {"2023": 210, "2024": 220, "2025": 230}, "intervalo_confianca_simplificado": {"2023": {"min": 189, "max": 231}, "2024": {"min": 198, "max": 242}, "2025": {"min": 207, "max": 253}}}],
      "projecao_concluida": true,
      "carimbo_tempo": "2025-04-12T10:22:00Z"
    }
  } 

• Número de caracteres esperado: O JSON 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: Utiliza lógica interna para calcular projeções e intervalos de confiança.
• 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 Recomendações para Administrações Escolares (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Recomendações para Administrações Escolares (RF 4).

Gerar recomendações práticas e priorizadas com base em insights e projeções.

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 como input um JSON combinando insights descritivos e projeções concluídas.
• 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.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo recomendações práticas e priorizadas para a administração escolar.
• Exemplo de Estrutura de Output:

   {
    "recomendacoes": {
      "itens": [{"id": 1, "curso_id": "123", "titulo": "Aumento de Capacidade para Administração", "acao_recomendada": "Expandir turmas e reforçar infraestrutura", "prioridade": "alta", "racional_dados": "CAGR 5a=0.12; último ano=320 matrículas; IC superior indica 360", "impacto_estimado": "alto", "horizonte": "próximo_semestre", "prerequisitos": [], "kpis_monitorar": ["taxa_matricula", "taxa_retencao", "taxa_ocupacao_vagas"]}],
      "versao_regras": "1.0",
      "atualizado_em": "2025-04-12T10:22:00Z",
      "recomendacao_concluida": true
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 5.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: Utiliza lógica interna para calcular prioridades e impactos.
• 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 é 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, gerando recomendações práticas e priorizadas para a administração escolar.