Agente de IA para Emissão Automática de Boletins Escolares

Automatizar a coleta de dados de desempenho dos alunos a partir de sistemas de gestão escolar.

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 requisição de coleta de dados 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 na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é uma requisição de coleta de dados de desempenho dos alunos.
• Formatos Suportados: Esse agente deve ser capaz de receber requisições no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 10.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON estruturado contendo os dados de desempenho dos alunos, conforme o exemplo fornecido no prompt.
• Exemplo de Estrutura de Output:

   {
    "aluno_id": "12345",
    "nome": "João Silva",
    "turma": "3A",
    "disciplinas": [
      {
        "nome": "Matemática",
        "nota": 8.5,
        "presencas": 90
      },
      {
        "nome": "Português",
        "nota": 7.8,
        "presencas": 85
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 1.500 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: Conecta-se ao sistema de gestão escolar para coleta de dados.

1.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Validação de Dados (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Validação de Dados (RF 2).

Validar a precisão dos dados de desempenho antes da geração dos boletins escolares.

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 dados de desempenho dos alunos em formato JSON estruturado.
• 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é 15.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON contendo os dados validados com indicação de precisão e erros encontrados.
• Exemplo de Estrutura de Output:

   {
    "aluno_id": "12345",
    "nome": "João Silva",
    "turma": "3A",
    "disciplinas": [
      {
        "nome": "Matemática",
        "nota": 8.5,
        "presencas": 90,
        "status": "validado"
      },
      {
        "nome": "Português",
        "nota": 7.8,
        "presencas": 85,
        "status": "erro"
      }
    ],
    "relatorio_erros": "Disciplina Português: nota inconsistente com histórico."
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 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 documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

2.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Formatação de Boletins (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Formatação de Boletins (RF 3).

Garantir a formatação padronizada dos boletins escolares.

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 dados de desempenho dos alunos validados.
• 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é 15.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um texto formatado em **Markdown** contendo os boletins escolares padronizados.
• Exemplo de Estrutura de Output:

   **Boletim Escolar**
  
  **Nome:** João Silva
  **Turma:** 3A
  **Período Letivo:** 2025
  
  ### Disciplinas
  - **Matemática:** Nota: 8.5, Presenças: 90
  - **Português:** Nota: 7.8, Presenças: 85, Comentários: Nota inconsistente com histórico. 

• Número de caracteres esperado: O texto final deve ser claro e direto, com um tamanho estimado em 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 documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

3.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente.
• Visibilidade da Resposta: A resposta gerada por este agente é o entregável final e não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo. Os boletins escolares gerados são o resultado que deve ser disponibilizado ao usuário.