Agente de IA para Análise de Dados de Participação Familiar

Validar, padronizar e consolidar dados de participação familiar em atividades escolares para análise 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 dados sobre eventos escolares via API. Na fase de testes, os dados serão enviados pelo agente diretamente por upload de um arquivo 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 JSON contendo registros de eventos escolares.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .csv, .json.
• 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 objeto JSON com: (a) dataset_normalizado: lista de eventos com campos padronizados e 'taxa_presenca' calculada; (b) dicionario_campos: mapeamento de colunas originais->padronizadas; (c) qualidade_dados: métricas de completude, consistência e outliers; (d) problemas_detectados: lista de registros com erros e motivo; (e) resumo_periodo: datas mínima/máxima.
• Exemplo de Estrutura de Output:

   {
    "dataset_normalizado": [...],
    "dicionario_campos": {...},
    "qualidade_dados": {...},
    "problemas_detectados": [...],
    "resumo_periodo": {"data_min": "2025-01-01", "data_max": "2025-12-31"}
  } 

• Número de caracteres esperado: O texto final deve ser informativo e estruturado, com um tamanho estimado em torno de 5.000 caracteres, podendo variar conforme a complexidade dos dados analisados.

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 Análise de Padrões e Diagnóstico 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 Análise de Padrões e Diagnóstico de Engajamento (RF 2).

Identificar padrões, tendências e pontos críticos de engajamento familiar a partir do dataset normalizado.

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 objeto JSON contendo 'dataset_normalizado', 'qualidade_dados' e 'resumo_periodo'.
• 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 objeto JSON 'diagnostico_engajamento' com: (a) kpis_gerais (taxa_media, mediana, p25, p75, tendência trimestral), (b) kpis_por_dimensao (tipo_evento, turno, modalidade, dia_semana, canal_convite, antecedencia_convite_faixa), (c) eventos_com_outliers, (d) segmentos_criticos com critérios e justificativas, (e) flags de decisão: 'engajamento_baixo' (boolean), 'dados_insuficientes' (boolean).
• Exemplo de Estrutura de Output:

   {
    "diagnostico_engajamento": {
      "kpis_gerais": {...},
      "kpis_por_dimensao": {...},
      "eventos_com_outliers": [...],
      "segmentos_criticos": [...],
      "flags": {"engajamento_baixo": true, "dados_insuficientes": false}
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e detalhado, com um tamanho estimado em torno de 4.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 KPIs e tendências.
• 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 Estratégias de Engajamento (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 Estratégias de Engajamento (RF 3).

Transformar o diagnóstico em um plano de ações priorizado para aumentar a participação familiar.

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 objeto 'diagnostico_engajamento' e, opcionalmente, parâmetros de contexto.
• 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é 8.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON 'plano_estrategico' contendo: (a) metas SMART com baseline e alvo, (b) iniciativas sugeridas com descrição, público-alvo, pré-requisitos, passos operacionais, métricas de sucesso e estimativa de impacto (p.p.), confiança (0-1) e esforço (baixo/médio/alto), (c) matriz_priorizacao com score ICE, (d) roteiro de 4-12 semanas com marcos quinzenais.
• Exemplo de Estrutura de Output:

   {
    "plano_estrategico": {
      "metas": [...],
      "iniciativas": [...],
      "matriz_priorizacao": [...],
      "roteiro": [...]
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e detalhado, com um tamanho estimado em torno de 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.
• Calculadora: Utiliza lógica interna para calcular impacto e ICE scores.
• 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 Redação de Comunicações Proativas (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Redação de Comunicações Proativas (RF 4).

Gerar mensagens segmentadas e prontas para uso que estimulem a participação familiar conforme o plano estratégico.

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 objeto 'plano_estrategico' e resumo de segmentos críticos.
• 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é 12.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um pacote JSON 'comunicacoes' com: (a) mensagens por canal (email, whatsapp, sms, impresso) contendo assunto/título, corpo, CTA, placeholders; (b) variantes A/B curtas e longas; (c) calendário de envios e lembretes (T-7, T-3, T-1, T0); (d) instruções de personalização e tokens; (e) métricas-alvo por mensagem (taxa de confirmação e presença esperada).
• Exemplo de Estrutura de Output:

   {
    "comunicacoes": {
      "mensagens": [...],
      "variantes": [...],
      "calendario_envios": [...],
      "instrucoes_personalizacao": [...],
      "metricas_alvo": [...]
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e detalhado, com um tamanho estimado em torno de 6.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 é 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. As comunicações geradas são o resultado que deve ser disponibilizado para as escolas.