Agente de IA para Recomendações de Leitura Personalizadas para Alunos

Transformar o histórico bruto de leitura do aluno em um perfil legível por máquina, com preferências, nível de leitura e filtros prontos para consulta ao catálogo.

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 JSON com o histórico de leitura dos alunos 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 JSON na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial é um JSON estruturado contendo o histórico de leitura dos alunos.
• 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é 50.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com o perfil de leitura detalhado para cada aluno.
• Exemplo de Estrutura de Output:

   {
    "alunos": [
      {
        "aluno_id": "12345",
        "perfil": {
          "generos_preferidos": ["Fantasia", "Ciência Ficcional"],
          "autores_preferidos": ["J.K. Rowling", "Isaac Asimov"],
          "idioma_alvo": "pt-BR",
          "faixa_etaria_alvo": "12-14",
          "nivel_leitura": { "escala": "lexile", "faixa": [850, 1050] },
          "tamanho_preferido": { "paginas_min": 200, "paginas_max": 400 },
          "tolerancia_dificuldade": "moderada",
          "penalizar_ja_lidos": true,
          "diversidade_minima": { "genero": 0.2, "autor": 0.2 },
          "incluir_novidades": true,
          "limiar_avaliacao_min": 3.5
        }
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 5.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 do Catálogo (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 do Catálogo (RF 2).

Realizar a chamada à API do sistema de catálogo de livros para recuperar candidatos de recomendação conforme os parâmetros prontos do aluno.

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 JSON contendo os perfis dos alunos com os parâmetros prontos para consulta ao catálogo.
• 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 JSON com os resultados do catálogo por aluno.
• Exemplo de Estrutura de Output:

   {
    "alunos": [
      {
        "aluno_id": "12345",
        "catalogo": {
          "itens": [
            {
              "livro_id": "67890",
              "titulo": "O Guia do Mochileiro das Galáxias",
              "autor": "Douglas Adams",
              "genero": "Ficção Científica"
            }
          ]
        }
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 5.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: Conecta-se ao sistema de catálogo de livros via API.

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 Recomendação de Livros (RF 3).

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

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

Gerar lista ordenada de recomendações por aluno combinando o perfil calculado com os itens retornados do catálogo, aplicando critérios de relevância, adequação pedagógica e diversidade.

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 um JSON mesclado contendo perfis de alunos e resultados do catálogo.
• 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é 15.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com a lista de recomendações por aluno.
• Exemplo de Estrutura de Output:

   {
    "alunos": [
      {
        "aluno_id": "12345",
        "recomendacoes": [
          {
            "rank": 1,
            "livro_id": "67890",
            "titulo": "O Guia do Mochileiro das Galáxias",
            "autor": "Douglas Adams",
            "genero": "Ficção Científica"
          }
        ]
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ter 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 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 subsequente.
• Visibilidade da Resposta: A resposta (JSON de recomendações) é 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. O JSON de recomendações gerado é o resultado que deve ser disponibilizado ao usuário.