Agente de IA para Feedback Automatizado a Pais e Responsáveis

Validar e padronizar os parâmetros necessários para gerar o relatório, definindo período, aluno(s), idiomas, granularidade e quais fontes de dados coletar (desempenho e/ou comportamento).

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 de parâmetros via API. Na fase de testes, os dados serão enviados por upload direto na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial é um objeto JSON contendo informações sobre alunos e parâmetros de relatório.
• 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é 5.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado e padronizado, contendo os parâmetros validados e normalizados para geração do relatório.
• Exemplo de Estrutura de Output:

   {
    "alunos": [{"aluno_id": "123", "turma_id": "A"}],
    "periodo": {"inicio": "2025-09-01", "fim": "2025-11-30", "label": "trimestre_3"},
    "idioma": "pt-BR",
    "canais": ["email"],
    "coletar_desempenho": true,
    "coletar_comportamento": true,
    "metricas_requeridas": ["notas_por_disciplina", "media_geral", "frequencia", "atrasos", "incidentes", "elogios", "tendencias_90d", "comparativo_turma"]
  } 

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

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 - Sistema Acadêmico (Desempenho) (RF 2).

Realizar chamada à API do Sistema Acadêmico para obter notas, avaliações, trabalhos e frequência no período.

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 como input um payload JSON pronto para a chamada à API.
• 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 até 3.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os dados brutos de desempenho retornados pela API.
• Exemplo de Estrutura de Output:

   {
    "avaliacoes": [{"tipo": "prova", "data": "2025-09-10", "peso": 2, "nota": 8.5}],
    "notas_finais": {"matematica": 8.5, "portugues": 7.0},
    "media": 7.75,
    "carga_horaria": 120,
    "frequencia": {"presencas": 95, "ausencias": 5}
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 1.500 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 documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Conecta-se ao Sistema Acadêmico via API para obter dados de desempenho.

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

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

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

Realizar chamada à API do Sistema de Comportamento para obter incidentes, elogios, ocorrências e registros de conduta no período.

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 1).
• Tipo do input: Este agente deve ser apto a receber como input um payload JSON pronto para a chamada à API.
• 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 até 3.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os dados brutos de comportamento retornados pela API.
• Exemplo de Estrutura de Output:

   {
    "comportamento": [{"data": "2025-09-15", "categoria": "pontualidade", "gravidade": "baixa", "descricao": "Chegou atrasado", "local": "Escola", "resolucao": "Advertência verbal", "pontos_positivos": "Nenhum"}]
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 1.500 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 documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Conecta-se ao Sistema de Comportamento via API para obter dados de comportamento.

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

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

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

Unificar e padronizar dados acadêmicos e de comportamento, calcular métricas derivadas e preparar um JSON estruturado para geração do relatório.

4.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão dos agentes anteriores (RF 2 e RF 3).
• Tipo do input: Este agente deve ser apto a receber como input os dados brutos de desempenho e comportamento, além dos parâmetros de relatório.
• 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 até 10.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON consolidado e padronizado, pronto para a geração do relatório.
• Exemplo de Estrutura de Output:

   {
    "perfil_aluno": {"nome": "João Silva", "turma": "A"},
    "periodo": {"inicio": "2025-09-01", "fim": "2025-11-30"},
    "disciplinas": [{"nome": "Matemática", "nota_final": 8.5, "media_disciplina": 7.5, "tendencia": "subindo"}],
    "frequencia": {"%presenca": 95, "%ausencia": 5},
    "comportamento": {"totais": 5, "por_categoria": {"pontualidade": 2, "respeito": 1}, "eventos_relevantes": "Nenhum"},
    "comparativos": {"turma": 80, "escola": 75},
    "alertas_calculados": "Nenhum"
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 3.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 documentos externos.
• Calculadora: Utiliza lógica interna para harmonização de dados e cálculo de métricas derivadas.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

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 Geração de Relatórios de Progresso (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Relatórios de Progresso (RF 5).

Produzir o relatório estruturado para pais/responsáveis, claro e objetivo, integrando desempenho e comportamento.

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 como input um JSON consolidado com dados acadêmicos e de comportamento.
• 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 até 5.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser dois artefatos: 1) relatório em markdown; 2) sumário JSON com campos-chave para registro e envio.
• Exemplo de Estrutura de Output:

   {
    "relatorio_markdown": "# Relatório de Progresso\n## Aluno: João Silva\n## Período: Trimestre 3\n- Destaques:...",
    "sumario_json": {"resumo_textual": "Aluno com bom desempenho geral...", "nivel_risco": "baixo", "recomendacoes_curto_prazo": ["Revisar matemática 3x/semana"], "proxima_emissao_sugerida": "2026-01-15", "anexos_sugeridos": []}
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 3.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 documentos externos.
• Calculadora: Utiliza lógica interna para cálculo de nível de risco e recomendações.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

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 Verificação de Conteúdo e Conformidade (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Verificação de Conteúdo e Conformidade (RF 6).

Revisar o relatório para tom adequado, privacidade e conformidade com políticas escolares antes do envio.

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 como input um relatório em markdown e um sumário JSON.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .md (Markdown) e .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input combinado de até 6.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo a aprovação do relatório ou ajustes necessários, além de motivos de recusa e campos corrigidos.
• Exemplo de Estrutura de Output:

   {
    "aprovado": true,
    "markdown_final": "# Relatório de Progresso...",
    "motivos_recusa": [],
    "campos_corrigidos": [],
    "requer_intervencao_humana": false
  } 

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

6.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

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 se conecta a sistemas externos.

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 Personalização de Canal e Preparação de Envio (RF 7).

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

Ao concluir sua execução, esse agente aciona o Agente de Personalização de Canal e Preparação de Envio (RF 7).

Adaptar o conteúdo aprovado ao canal de comunicação escolhido (email, SMS, app) e preparar o payload de notificação.

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 como input um relatório aprovado e um sumário JSON.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .md (Markdown) e .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input combinado de até 6.000 caracteres.

7.3.2 Especificação do Output

• Formato de output: O output deve ser payloads prontos para envio por canal, com metadados de rastreio.
• Exemplo de Estrutura de Output:

   {
    "email": {"assunto": "Relatório de Progresso - João Silva - Trimestre 3", "html": "
  Prezado responsável...
  "},
    "sms": {"texto_160": "Relatório de Progresso - João Silva disponível. Veja o link: http://linkcurto.com"},
    "app": {"titulo": "Relatório de Progresso", "conteudo": "Veja o relatório de progresso de João Silva", "link": "http://linkcurto.com"},
    "metadados": {"message_id_candidato": "msg123", "aluno_id": "123", "periodo": "trimestre_3"}
  } 

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

7.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

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 se conecta a sistemas externos.

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 deve ser visível para o Agente de Execução de Chamada à API - Sistema de Notificações (RF 8).

7.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 - Sistema de Notificações (RF 8).

Realizar a chamada à API do sistema de notificações para enviar os relatórios aos responsáveis nos canais preparados.

8.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 7).
• Tipo do input: Este agente deve ser apto a receber como input payloads prontos para envio por canal.
• 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 até 3.000 caracteres.

8.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o resultado do envio por canal, com status, ids_externos e erros eventuais.
• Exemplo de Estrutura de Output:

   {
    "status_por_canal": {"email": "enviado", "sms": "enviado", "app": "enviado"},
    "ids_externos": {"email": "msg123", "sms": "msg124", "app": "msg125"},
    "erros_eventuais": [],
    "timestamp_envio": "2025-12-20T10:40:00"
  } 

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

8.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

8.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Conecta-se ao sistema de notificações via API para enviar os relatórios.

8.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 (resultado do envio) é o entregável final e não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo. O resultado do envio deve ser registrado para auditoria e controle.