Agente de IA para Análise de Dados de Envolvimento Familiar

Validar, higienizar e padronizar o dataset de comunicações escola–família, preparando-o 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 um arquivo CSV de dados de comunicaçã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 do arquivo na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um arquivo CSV contendo dados de comunicação.
• Formatos Suportados: Esse agente deve ser capaz de receber arquivos nos formatos: .csv.
• 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 contendo o status da validação, motivos de reprovação se houver, e o dataset padronizado.
• Exemplo de Estrutura de Output:

   {
    "status_validacao": "aprovado",
    "motivos_reprovacao": [],
    "dataset_padronizado": [ {...} ],
    "metadados_qualidade": { "registros_validos": 95, "registros_invalidos": 5 }
  } 

• Número de caracteres esperado: O JSON final deve ser claro e direto, com um tamanho estimado em 2.000 caracteres.

1.3.3 Parâmetros de Geração

• Modelo: GPT-4
• Temperatura: 0.5

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 Engajamento e Padrões de Comunicação (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 Engajamento e Padrões de Comunicação (RF 2).

Calcular KPIs de engajamento, identificar padrões eficazes e localizar lacunas de comunicação por canal, tipo, horário e segmento.

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 metadados de qualidade.
• 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é 6.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo KPIs gerais, por corte, distribuições temporais, padrões eficazes e lacunas priorizadas.
• Exemplo de Estrutura de Output:

   {
    "kpis_gerais": { "taxa_resposta": 0.75, "tempo_medio_resposta_h": 12, "engajamento_ativo": 0.6 },
    "kpis_por_corte": { ... },
    "distribuicoes_temporais": { ... },
    "padroes_eficazes": [ ... ],
    "lacunas_priorizadas": [ ... ]
  } 

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

2.3.3 Parâmetros de Geração

• Modelo: GPT-4
• Temperatura: 0.5

2.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para calcular KPIs e padrões.
• 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 Estratégias e Plano de Ação para Envolvimento Familiar (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Estratégias e Plano de Ação para Envolvimento Familiar (RF 3).

Transformar achados analíticos em estratégias táticas com plano de comunicação testável para aumentar o envolvimento dos pais.

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 KPIs, padrões eficazes e lacunas priorizadas.
• 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.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo objetivos, alvos de KPI, alavancas estratégicas, plano A/B de experimentos, roteiros de mensagens, cadência recomendada, quadro de mensuração, riscos e mitigações.
• Exemplo de Estrutura de Output:

   {
    "objetivos": [ ... ],
    "alvos_kpi": { "taxa_resposta": 0.85, "engajamento_ativo": 0.7 },
    "alavancas_estrategicas": [ ... ],
    "plano_ab_experimentos": [ ... ],
    "roteiros_mensagens": [ ... ],
    "cadencia_recomendada": { ... },
    "quadro_mensuracao": { ... },
    "riscos_e_mitigacoes": { ... }
  } 

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

3.3.3 Parâmetros de Geração

• Modelo: GPT-4
• Temperatura: 0.5

3.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para definir metas e estratégias.
• 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 Geração de Relatório Consolidado (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Relatório Consolidado (RF 4).

Consolidar validação, análise e plano em um relatório final em Markdown para stakeholders escolares.

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 como input as saídas dos três agentes anteriores em formato JSON.
• 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é 10.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório em formato Markdown, contendo sumário executivo, metodologia, KPIs, padrões eficazes, lacunas priorizadas e plano de ação.
• Exemplo de Estrutura de Output:

   # Relatório Consolidado
  
  ## Sumário Executivo
  - Achado 1
  - Achado 2
  
  ## Metodologia
  ...
  
  ## KPIs e Análise
  ...
  
  ## Padrões Eficazes e Lacunas
  ...
  
  ## Plano de Ação
  ...

• Número de caracteres esperado: O relatório em Markdown deve ter um tamanho estimado em 5.000 caracteres.

4.3.3 Parâmetros de Geração

• Modelo: GPT-4
• Temperatura: 0.5

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 (relatório em Markdown) é 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. O relatório gerado é o resultado que deve ser disponibilizado aos stakeholders escolares.