Agente de IA para Análise de Participação em Atividades Extracurriculares

Ingerir e estruturar dados brutos de participação dos estudantes em atividades extracurriculares a partir de arquivos (ex.: CSV) ou texto tabular.

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 CSV ou texto 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 do csv 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 texto tabular que contém dados de participação dos estudantes.
• Formatos Suportados: Esse agente deve ser capaz de receber arquivos nos formatos: .csv, .txt.
• 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 um JSON estruturado com a lista padronizada de registros de participação.
• Exemplo de Estrutura de Output:

   {
    "registros": [
      {
        "estudante_id": "string",
        "atividade_nome": "string",
        "atividade_categoria": null,
        "data_participacao": "YYYY-MM-DD",
        "presenca": 0,
        "carga_horaria_minutos": null,
        "origem_registro": "csv",
        "chave_dedup": "string"
      }
    ],
    "metadados": {
      "periodo_min": "YYYY-MM-DD",
      "periodo_max": "YYYY-MM-DD",
      "total_registros_entrada": 100,
      "total_registros_saida": 90
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser conciso e informativo, com um tamanho estimado em torno de 5.000 caracteres, podendo variar conforme a complexidade dos dados descritos.

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 e Normalização 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 Validação e Normalização de Dados (RF 2).

Validar a qualidade dos dados coletados e normalizar nomes de atividades para uma taxonomia canônica.

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 de participação produzido 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.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON de participação validado e normalizado.
• Exemplo de Estrutura de Output:

   {
    "registros": [
      {
        "estudante_id": "string",
        "atividade_nome": "string",
        "atividade_categoria": "string",
        "data_participacao": "YYYY-MM-DD",
        "presenca": 1,
        "carga_horaria_minutos": null,
        "origem_registro": "csv",
        "chave_dedup": "string"
      }
    ],
    "qualidade_dados": {
      "taxa_registros_descartados": 0.05,
      "motivos_descartes": [
        { "campo": "data_participacao", "quantidade": 5 }
      ],
      "campos_nulos_porcentagem": [
        { "campo": "carga_horaria_minutos", "porcentagem": 0.2 }
      ],
      "alertas": ["taxa_registros_descartados > 5%"]
    },
    "taxonomia_utilizada": {
      "versao": "v1.0",
      "categorias": ["Esportes", "Artes", "Tecnologia", "Ciências", "Voluntariado", "Liderança", "Idiomas", "Clubes Acadêmicos", "Outros"]
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 6.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 Consolidação de Desempenho Acadêmico (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 de Desempenho Acadêmico (RF 3).

Consolidar dados de participação com dados de desempenho acadêmico em um dataset analítico único.

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 dois JSONs: (a) participação validada do agente anterior; (b) desempenho acadêmico no formato especificado.
• 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 combinado de até 12.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um dataset analítico unificado.
• Exemplo de Estrutura de Output:

   {
    "registros_participacao": [...],
    "desempenho_por_estudante": [...],
    "uniao": [
      {
        "estudante_id": "string",
        "serie_ano": "string",
        "turma": "string",
        "genero": "string",
        "idade": null,
        "gpa_atual_padronizado": 85,
        "gpa_base": 80,
        "frequencia_escolar": 95,
        "intensidade_participacao": {
          "dias_participados": 15,
          "horas_estimadas": 25,
          "categorias": {
            "Esportes": {
              "dias": 5
            }
          }
        },
        "janela_analise": {
          "inicio": "YYYY-MM-DD",
          "fim": "YYYY-MM-DD"
        }
      }
    ],
    "metadados": {
      "escala_origem": "0-10",
      "reescalonado_para": "0-100",
      "proporcao_com_dados_completos": 0.8
    }
  } 

• Número de caracteres esperado: O dataset gerado deve ser denso, com um tamanho mínimo esperado de 10.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.
• 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 deve ser visível para o Agente de Análise de Impacto Acadêmico (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Análise de Impacto Acadêmico (RF 4).

Estimar o impacto da participação em atividades extracurriculares sobre métricas acadêmicas.

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 o dataset analítico unificado do 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 até 10.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um resumo analítico em JSON.
• Exemplo de Estrutura de Output:

   {
    "resumo_markdown": "string",
    "metricas_gerais": {
      "n_estudantes": 100,
      "media_gpa_atual": 85.5,
      "media_gpa_base": 82.0,
      "delta_gpa_medio": 3.5,
      "frequencia_escolar_media": 95
    },
    "efeitos_por_categoria": [
      {
        "categoria": "Esportes",
        "n": 50,
        "delta_gpa_medio": 1.5,
        "delta_freq_escolar_p.p.": 2.0,
        "efeito_tamanho": "moderado",
        "confianca": "media",
        "criterio_confianca": "n entre 30–99"
      }
    ],
    "cortes_por_segmento": [
      {
        "segmento": "serie_ano",
        "chave": "2025",
        "n": 30,
        "delta_gpa_medio": 2.0
      }
    ],
    "limitacoes": ["ausência de gpa_base para >40% dos estudantes"],
    "flags": {
      "amostra_insuficiente": false,
      "viés_potencial": true
    }
  } 

• Número de caracteres esperado: O resumo gerado deve ter um tamanho aproximado de 8.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.
• Calculadora: Não utiliza.
• 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 deve ser visível para o Agente de Proposição de Ações (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Proposição de Ações (RF 5).

Gerar um plano de ações priorizadas para maximizar benefícios acadêmicos das atividades extracurriculares.

5.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 4).
• Tipo do input: Este agente deve ser apto a receber o output do Agente de Análise de Impacto Acadêmico.
• 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 até 8.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um plano de ações em JSON.
• Exemplo de Estrutura de Output:

   {
    "acoes": [
      {
        "acao_id": "string",
        "titulo": "string",
        "tipo": "programa",
        "publico_alvo": {
          "criterio": "string",
          "filtro": {
            "categoria": "string",
            "serie_ano": "string"
          }
        },
        "medidas": ["string"],
        "recursos_necessarios": {
          "horas_professor": 10,
          "custo_estimado": 500,
          "espaços": ["Sala Multiuso"]
        },
        "expectativa_impacto": {
          "metrica": "gpa",
          "ganho_esperado": 3,
          "horizonte_meses": 6
        },
        "riscos_mitigacoes": ["risco de sobrecarga do estudante"],
        "indicadores_sucesso": [
          {
            "nome": "aumento_delta_gpa_categoria_Tecnologia",
            "definicao": "string",
            "meta": 2,
            "periodicidade": "trimestral"
          }
        ],
        "prioridade": {
          "score": 85,
          "justificativa": "string"
        }
      }
    ],
    "diretrizes_implementacao": ["comunicação com responsáveis"]
  } 

• Número de caracteres esperado: O plano de ações gerado deve ter um tamanho aproximado de 12.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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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

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

A execução deste agente finaliza o fluxo. O plano de ações gerado é o resultado que deve ser disponibilizado ao usuário.