Agente de IA para Análise de Participação em Reuniões

Padronizar e validar os dados de participação em reuniões e eventos, preparando um dataset confiável para análise.

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 uma tabela de dados de participação 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 da tabela na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é uma tabela de dados estruturados que contém informações de participação em eventos escolares.
• Formatos Suportados: Esse agente deve ser capaz de receber tabelas nos formatos: .csv, .xlsx.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 200.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON com: dataset_padronizado (linhas validadas e normalizadas), relatorio_qualidade_dados (contagens, percentuais de faltantes, duplicidade, campos críticos ausentes) e dicionario_campos (tipos finais e domínios).
• Exemplo de Estrutura de Output:

   {
   "dataset_padronizado": [...],
   "relatorio_qualidade_dados": {
   "total_linhas_entrada": 1000,
   "total_validas": 950,
   "total_descartadas": 50,
   "pct_campos_criticos_faltantes": {"event_id": 0, "parent_id": 0.5, "event_start_datetime": 0.2},
   "total_duplicatas_removidas": 5,
   "distribuicao_dominios": {...},
   "flags_suspeita": {...}
   },
   "dicionario_campos": {...} 
  } 

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em 10.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 Cálculo de Métricas de Engajamento (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Cálculo de Métricas de Engajamento (RF 2).

Calcular indicadores-chave de participação e engajamento em nível geral e por segmentos relevantes.

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 o relatório de qualidade de dados gerados 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é 50.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com blocos: kpis_gerais, kpis_por_segmento, tendencias_temporais, coortes_participacao, e parametros_de_classificacao.
• Exemplo de Estrutura de Output:

   {
   "kpis_gerais": {...},
   "kpis_por_segmento": {...},
   "tendencias_temporais": {...},
   "coortes_participacao": {...},
   "parametros_de_classificacao": {...} 
  } 

• Número de caracteres esperado: O JSON final deve ser claro e direto, com um tamanho estimado em 15.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: Utiliza lógica interna para calcular indicadores-chave de participação.
• 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 Detecção de Padrões e Insights (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Detecção de Padrões e Insights (RF 3).

Identificar padrões significativos de engajamento e gerar insights com evidências e hipóteses de causa.

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 múltiplos artefatos como input, incluindo kpis gerais, kpis por segmento, tendências temporais, coortes de participação e o dataset padronizado.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input combinado de até 60.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser uma lista priorizada de insights em JSON com campos: insight_id, tipo, descricao, evidencia_quantitativa, segmento_afetado, materialidade, confianca, hipotese_causa, recomendacao_preliminar.
• Exemplo de Estrutura de Output:

   [
   {
   "insight_id": "1",
   "tipo": "Sazonalidade",
   "descricao": "Participação aumenta significativamente nos meses de março e setembro.",
   "evidencia_quantitativa": "Aumento de 15 pp em março e 10 pp em setembro comparado à média anual.",
   "segmento_afetado": "Todos",
   "materialidade": "Alta",
   "confianca": "Alta",
   "hipotese_causa": "Eventos importantes no início e meio do ano letivo.",
   "recomendacao_preliminar": "Focar comunicações nesses períodos para maximizar engajamento."
   }
  ] 

• Número de caracteres esperado: O JSON de output deve ser claro e direto, com um tamanho estimado em 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: Utiliza lógica interna para identificar padrões e gerar insights.
• 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 Estratégias e Ações Recomendadas (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Estratégias e Ações Recomendadas (RF 4).

Transformar insights em um plano de ações priorizado para elevar o engajamento dos pais.

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 múltiplos artefatos como input, incluindo a lista de insights priorizados, kpis gerais e kpis por segmento.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input combinado de até 50.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um backlog de ações em JSON com campos: acao_id, insight_id, descricao_acao, alavanca, impacto_estimado_pp, esforço_estimado, prioridade, indicadores, desenho_piloto, riscos_e_mitigacoes.
• Exemplo de Estrutura de Output:

   [
   {
   "acao_id": "1",
   "insight_id": "1",
   "descricao_acao": "Ajustar horário de reuniões para períodos de maior engajamento.",
   "alavanca": "horário",
   "impacto_estimado_pp": 5,
   "esforço_estimado": "baixo",
   "prioridade": 8,
   "indicadores": {"KPI": "participation_rate", "fórmula": "presencas/convites", "baseline": 50, "meta": 55, "janela_mensuracao": "3 meses"},
   "desenho_piloto": {"público-alvo": "Pais de alunos do ensino fundamental", "amostra mínima": 30, "duração": "1 ciclo", "critério_sucesso": "Melhora >= 3 pp"},
   "riscos_e_mitigacoes": "Conflito com horários de trabalho; oferecer opções de horários alternativos."
   }
  ] 

• Número de caracteres esperado: O JSON de output deve ser claro e direto, com um tamanho estimado em 10.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: Utiliza lógica interna para priorizar ações e calcular impacto estimado.
• 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 Composição do Relatório Executivo (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Composição do Relatório Executivo (RF 5).

Gerar relatório executivo em markdown com métricas, padrões detectados e plano de ação recomendado.

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 kpis gerais, kpis por segmento, tendências temporais, coortes de participação, lista de insights e backlog de ações.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input combinado de até 70.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório em markdown com: Sumário Executivo, Indicadores-Chave, Tendências e Sazonalidade, Desempenho por Segmento, Insights Prioritários, Plano de Ação (90 dias), Qualidade e Limitações dos Dados, Metodologia e Glossário.
• Exemplo de Estrutura de Output:

   # Relatório Executivo
  
  ## Sumário Executivo
  - Principais achados: Aumento de participação em março e setembro, Canal de convite SMS mais eficaz.
  - Ações prioritárias: Ajuste de horário, Reforço de lembretes por SMS, Introdução de incentivos.
  
  ## Indicadores-Chave
  - Participation Rate: 65.4%
  - Confirmation Rate: 70.2%
  - No Show Rate: 15.3%
  - Average Events per Parent: 3.5
  
  ## Tendências e Sazonalidade
  | Mês | Participation Rate | Confirmation Rate | No Show Rate |
  |-----|--------------------|-------------------|--------------|
  | Jan | 60.0%              | 65.0%             | 12.0%        |
  | Feb | 62.5% ↑            | 66.0% ↑           | 14.0% ↓      |
  
  ## Desempenho por Segmento
  - Top 5 Segmentos Positivos: Ensino Médio (70%), Ensino Fundamental (68%)
  - Top 5 Segmentos Críticos: Pré-Escola (50%), Educação Infantil (55%)
  
  ## Insights Prioritários
  - Sazonalidade: Participação aumenta em março e setembro, foco em comunicações nesses períodos.
  - Canal de Convite: SMS lidera em eficácia, explorar mais esse canal.
  
  ## Plano de Ação (90 dias)
  | Ação ID | Insight ID | Alavanca | Impacto Estimado (pp) | Esforço | Prioridade | KPI | Meta | Desenho Piloto |
  |---------|------------|----------|----------------------|---------|------------|-----|------|---------------|
  | 1       | 1          | Horário  | 5                    | Baixo   | Alta       | 55  | 60   | 30 convites   |
  
  ## Qualidade e Limitações dos Dados
  - Descartes: 50 linhas
  - Duplicatas: 5 removidas
  - Campos Ausentes: event_id (0.5%), parent_id (0.2%)
  
  ## Metodologia e Glossário
  - Formulas: Participation Rate = presencas/convites
  - Classificação: Alta (>=60%), Média (30%-60%), Baixa (<30%)
  

• Número de caracteres esperado: O relatório em markdown deve ser conciso e informativo, com um tamanho estimado em 20.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: Utiliza lógica interna para compor o relatório executivo.
• 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 (relatório em markdown) é 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 relatório gerado é o resultado que deve ser disponibilizado à escola.