Agente de IA para Análise de Desempenho Docente

Planejar a coleta e padronização, definindo o esquema canônico de dados e os parâmetros de consulta por fonte.

1.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente é o ponto de partida do fluxo e deve ser acionado pelo envio do briefing do projeto 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 briefing na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um documento de texto contendo o briefing do projeto.
• Formatos Suportados: Esse agente deve ser capaz de receber briefing nos formatos: .docx, .pdf.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 15.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um plano estruturado em JSON com chaves como data_schema, fontes_plan, api_payloads, doc_queries, search_queries, regras_de_qualidade, normalizacao_escalas, janela_temporal, identificadores.
• Exemplo de Estrutura de Output:

   {
    "data_schema": {...},
    "fontes_plan": [...],
    "api_payloads": [...],
    "doc_queries": [...],
    "search_queries": [...],
    "regras_de_qualidade": {...},
    "normalizacao_escalas": {...},
    "janela_temporal": "YYYY-MM",
    "identificadores": {...}
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e estruturado, com um tamanho estimado em 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: 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 devem ser visíveis para o Agente de Consolidação e Padronização de Dados (RF 5).
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Consolidação e Padronização de Dados (RF 5).

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

Realizar chamadas às APIs dos sistemas fontes para obter dados de desempenho docente.

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 api_payloads gerados pelo agente anterior.
• Formatos Suportados: Esse agente deve ser capaz de processar 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 JSON contendo dados brutos retornados pelas APIs, organizados por fonte.
• Exemplo de Estrutura de Output:

   {
    "dados_api_brutos": [
      {
        "fonte": "LMS",
        "dados": [...]
      },
      {
        "fonte": "CRM Acadêmico",
        "dados": [...]
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ser proporcional ao número de fontes e registros, com um tamanho estimado em 20.000 caracteres.

2.3.3 Parâmetros de Geração

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

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 deverá usar as APIs listadas nos api_payloads para obter os dados necessários.

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 Padronização de Dados (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Execução de Consulta a Documento (RF 3).

Realizar consultas a documentos para extrair informações relevantes.

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 doc_queries gerados pelo agente anterior.
• Formatos Suportados: Esse agente deve ser capaz de processar inputs no formato JSON.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 8.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo dados extraídos dos documentos, organizados por fonte.
• Exemplo de Estrutura de Output:

   {
    "dados_documento_brutos": [
      {
        "fonte": "Relatórios de Observação",
        "dados": [...]
      },
      {
        "fonte": "Planilhas de Avaliação",
        "dados": [...]
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ser proporcional ao número de documentos e registros, com um tamanho estimado em 15.000 caracteres.

3.3.3 Parâmetros de Geração

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

3.3.4 Ferramentas do Agente

• Documentos: O agente deverá acessar e processar documentos conforme especificado nas doc_queries.
• 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 Consolidação e Padronização de Dados (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Busca Online (RF 4).

Executar buscas online quando fontes públicas complementares forem necessárias.

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 search_queries gerados pelo agente anterior.
• Formatos Suportados: Esse agente deve ser capaz de processar inputs no formato JSON.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 5.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo resultados de buscas online, organizados por termo.
• Exemplo de Estrutura de Output:

   {
    "dados_busca_brutos": [
      {
        "termo": "Resultados Avaliações Institucionais",
        "dados": [...]
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ser proporcional ao número de termos e resultados, com um tamanho estimado em 10.000 caracteres.

4.3.3 Parâmetros de Geração

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

4.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: O agente deverá realizar buscas online conforme especificado nas search_queries.
• 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 Consolidação e Padronização de Dados (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Consolidação e Padronização de Dados (RF 5).

Unificar, limpar, deduplicar, anonimizar e padronizar dados das diversas fontes no esquema canônico.

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 múltiplos artefatos como input, incluindo data_schema, regras_de_qualidade, normalizacao_escalas, janela_temporal do plano, dados_api_brutos, dados_documento_brutos e/ou dados_busca_brutos.
• Formatos Suportados: Esse agente deve ser capaz de processar inputs no formato JSON.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input combinado de até 50.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo dataset unificado, relatório de qualidade de dados e dicionário de dados final.
• Exemplo de Estrutura de Output:

   {
    "dataset_unificado": [...],
    "data_quality_report": {...},
    "dicionario_de_dados_final": {...}
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e estruturado, com um tamanho estimado em 50.000 caracteres.

5.3.3 Parâmetros de Geração

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

5.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• 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 deve ser visível para o Agente de Análise de Desempenho Docente (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Análise de Desempenho Docente (RF 6).

Identificar padrões de sucesso e áreas de melhoria a partir do dataset padronizado.

6.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 5).
• Tipo do input: Este agente deve ser apto a receber dataset_unificado e data_quality_report gerados pelo agente anterior.
• Formatos Suportados: Esse agente deve ser capaz de processar inputs no formato JSON.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input combinado de até 60.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo análise de métricas, resultados por professor, comparativos, padrões identificados, alertas e recomendações preliminares.
• Exemplo de Estrutura de Output:

   {
    "analise_metricas": {
      "visao_geral": {...},
      "resultados_por_professor": [...],
      "comparativos": {...},
      "padroes_identificados": [...],
      "alertas": [...],
      "recomendacoes_preliminares": [...]
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e estruturado, com um tamanho estimado em 60.000 caracteres.

6.3.3 Parâmetros de Geração

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

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

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 Geração de Insights e Plano de Ação (RF 7).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Insights e Plano de Ação (RF 7).

Transformar achados analíticos em insights claros e acionáveis para desenvolvimento docente.

7.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 6).
• Tipo do input: Este agente deve ser apto a receber analise_metricas gerados pelo agente anterior.
• Formatos Suportados: Esse agente deve ser capaz de processar inputs no formato JSON.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 40.000 caracteres.

7.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo insights acionáveis por professor e institucionais, com campos como prioridade, tema, evidência resumida, ação recomendada, recurso sugerido, prazo sugerido, indicador de sucesso e follow-up.
• Exemplo de Estrutura de Output:

   {
    "insights_acionaveis": [
      {
        "professor_id_hash": "...",
        "prioridade": "alta",
        "tema": "Engajamento",
        "evidencia_resumida": "Desvio de -8 p.p. em relação ao benchmark",
        "acao_recomendada": "Aplicar técnica X nas 2 primeiras aulas de cada semana e medir presença",
        "recurso_sugerido": "Curso de técnicas de engajamento",
        "prazo_sugerido": "4 semanas",
        "indicador_de_sucesso": "+5 p.p. em engajamento",
        "follow_up": "10 semanas"
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e estruturado, com um tamanho estimado em 40.000 caracteres.

7.3.3 Parâmetros de Geração

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

7.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 representa o entregável final do fluxo de agentes.

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

A execução deste agente finaliza o fluxo. Os insights gerados são o resultado que deve ser disponibilizado ao usuário.