Agente de IA para Notificações Escolares

Realizar consulta ao documento 'calendário_escolar_atualizado' para obter eventos, prazos e feriados relevantes em um intervalo de datas e para públicos específicos.

1.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente ao receber uma solicitação de consulta ao documento 'calendário_escolar_atualizado'.
• Tipo do input: Os parâmetros de entrada devem ser um objeto JSON contendo escola_id, intervalo_datas e filtros.
• 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 até 5.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser uma lista de objetos JSON contendo eventos, prazos e feriados que atendem aos critérios de busca.
• Exemplo de Estrutura de Output:

  [
    {
      "id_evento": "evt_123",
      "titulo": "Reunião de Pais",
      "tipo": "evento",
      "data_inicio": "2025-12-20T18:00:00-03:00",
      "data_fim": "2025-12-20T19:00:00-03:00",
      "publico_alvo": ["pais"],
      "series": ["6º ano"],
      "local": "Auditório",
      "observacoes": "Trazer documento de identidade"
    }
  ]

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.000 caracteres.

1.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

1.3.4 Ferramentas do Agente

• Documentos: Consulta o documento 'calendário_escolar_atualizado'.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 Preparação e Planejamento de Notificações (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Preparação e Planejamento de Notificações (RF 2).

Selecionar eventos pertinentes para cada usuário, definir momento de envio, canal prioritário e construir payload padronizado de notificação com variáveis e políticas aplicadas.

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 uma lista de eventos e um conjunto de dados de usuários.
• 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.

2.3.2 Especificação do Output

• Formato de output: O output deve ser uma lista de objetos JSON detalhando as notificações planejadas para envio, incluindo canais, horários e variáveis personalizadas.
• Exemplo de Estrutura de Output:

  [
    {
      "notification_id": "ntf_abc123",
      "user_id": "usr_1",
      "event_id": "evt_123",
      "channel_plan": ["app","whatsapp","email"],
      "schedule_time_utc": "2025-12-17T21:00:00Z",
      "message_template_id": "tmpl_evento_padrao",
      "vars": {
        "NOME": "Cheila",
        "TITULO_EVENTO": "Reunião de Pais",
        "DATA_LOCAL": "20/12 18:00 – Auditório"
      },
      "priority": "normal",
      "dedupe_key": "usr_1|evt_123|principal",
      "consent_checked": true,
      "quiet_hours_respected": true,
      "urgency": "informativa",
      "fallback_plan": ["email"],
      "metadata": {
        "idioma": "pt-BR",
        "series_alvo": ["6º ano"]
      }
    }
  ]

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 2.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 horários de envio e respeitar horários de silêncio.
• 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 Renderização de Mensagens Multicanal (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Renderização de Mensagens Multicanal (RF 3).

Transformar template e variáveis em mensagens finais por canal, aplicando limites de tamanho, links, assunto e corpo conforme o canal.

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 notificações planejadas com templates e variáveis.
• 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é 8.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser uma lista de objetos JSON contendo as mensagens renderizadas por canal para cada notificação.
• Exemplo de Estrutura de Output:

  [
    {
      "notification_id": "ntf_abc123",
      "rendered_messages": {
        "app": {
          "title": "Reunião de Pais",
          "body": "Olá Cheila, Reunião de Pais em 20/12 18:00 – Auditório."
        },
        "whatsapp": {
          "body": "Olá Cheila! Reunião de Pais em 20/12 18:00 – Auditório."
        },
        "sms": {
          "body": "Reunião de Pais 20/12 18:00 – Auditório."
        },
        "email": {
          "subject": "Reunião de Pais – 20/12 18:00",
          "html": "
  Olá Cheila,
  Reunião de Pais em 20/12 18:00 – Auditório.
  "
        }
      }
    }
  ]

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 2.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.
• 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 Execução de Chamada à API (RF 4).

3.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 4).

Realizar chamada à API do Sistema de Comunicação Escolar para agendar e/ou enviar as mensagens já renderizadas por canal.

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 mensagens renderizadas prontas para envio.
• 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 até 5.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser uma lista de objetos JSON contendo os recibos de agendamento/entrega para cada notificação enviada.
• Exemplo de Estrutura de Output:

  [
    {
      "notification_id": "ntf_abc123",
      "envios": [
        {
          "canal": "app",
          "status": "agendado",
          "id_externo": "sch_001"
        },
        {
          "canal": "whatsapp",
          "status": "agendado",
          "id_externo": "sch_002"
        }
      ],
      "falhas": [],
      "timestamp": "2025-12-15T16:38:00Z"
    }
  ]

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.500 caracteres.

4.3.3 Parâmetros de Geração

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

4.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar as mensagens renderizadas para a API externa do Sistema de Comunicação Escolar e retornar os recibos recebidos como resposta.

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 (recibos de agendamento/entrega) é 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. Os recibos gerados são o resultado que deve ser registrado e analisado conforme necessário.