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

Analisar o histórico de leitura dos alunos para identificar, em uma única execução, preferências por gêneros e autores, idioma predominante, nível de leitura e sinais de engajamento/recência.

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 dados do 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 para o fluxo é um JSON com 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 contendo o perfil detalhado do leitor, incluindo preferências por gêneros, autores, nível de leitura e diretrizes de conteúdo.
• Exemplo de Estrutura de Output:

   {
    "perfil_leitor": {
      "aluno_id": "123456",
      "cold_start": false,
      "idiomas_preferidos": [{"idioma": "pt", "proporcao": 0.8}],
      "generos_preferidos": [{"genero": "Aventura", "score_normalizado_0a1": 0.9}],
      "autores_preferidos": [{"autor": "J.K. Rowling", "score_normalizado_0a1": 0.85}],
      "nivel_leitura_inferido": {"nivel_base": "medio", "metodo": "catalogo", "faixa_sugerida": ["medio", "medio"]},
      "tolerancia_desafio": "moderada",
      "recencia": {"ultimo_genero": "Fantasia", "dias_desde_ultima_leitura": 30},
      "livros_lidos_para_excluir": [{"titulo": "Harry Potter", "autor": "J.K. Rowling"}],
      "diretrizes_conteudo": {"faixa_etaria_aluno": "Juvenil", "restricoes": []}
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 2.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.
• Calculadora: Utiliza lógica interna para cálculo de escores e níveis de leitura.
• 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 de Parâmetros de Busca de 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 Preparação de Parâmetros de Busca de Catálogo (RF 2).

Transformar o perfil do leitor em parâmetros prontos de busca para a API de catálogo de livros.

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 perfil do leitor gerado pelo agente anterior.
• 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é 6.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os parâmetros de busca otimizados para a API de catálogo de livros.
• Exemplo de Estrutura de Output:

   {
    "payload_busca_catalogo": {
      "consultas": [
        {
          "camada": "essencial",
          "termos_generos": ["Aventura", "Fantasia"],
          "termos_autores": ["J.K. Rowling"],
          "faixa_nivel": ["medio", "medio"],
          "idiomas": ["pt"],
          "ordenacao": "relevancia",
          "limite": 60
        }
      ],
      "exclusoes": {
        "titulos_autores": [{"titulo": "Harry Potter", "autor": "J.K. Rowling"}]
      },
      "proporcao_camadas": {"essencial":0.6, "expandido":0.3, "exploracao":0.1},
      "page_size": 50,
      "pagina_inicial": 1
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e otimizado, 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.
• Calculadora: Utiliza lógica interna para ajustar os parâmetros de busca.
• 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 Execução de Chamada à API (RF 3).

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

Realizar chamada à API do Sistema de Catálogo de Livros para obter a lista de candidatos a recomendação conforme o payload recebido.

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 como input um JSON com os parâmetros de busca otimizados para a API de catálogo de livros.
• 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é 6.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo a lista de livros candidatos a recomendação, com informações essenciais para cada livro.
• Exemplo de Estrutura de Output:

   {
    "dados_catalogo": [
      {
        "titulo": "O Senhor dos Anéis",
        "autor": "J.R.R. Tolkien",
        "genero": "Fantasia",
        "idioma": "pt",
        "nivel_catalogo": "medio",
        "data_publicacao": "1954-07-29",
        "sinopse": "Uma aventura épica na Terra Média.",
        "disponibilidade": true,
        "id_externo": "123abc"
      }
    ]
  } 

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

3.3.3 Parâmetros de Geração

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

3.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o JSON recebido para a API externa do Sistema de Catálogo de Livros e retornar a lista de livros recebida como resposta.

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

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

Gerar a lista final de recomendações personalizadas combinando o perfil do leitor com os candidatos do catálogo, aplicando critérios de adequação, diversidade e engajamento.

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 dois JSONs como input: o perfil do leitor e a lista de livros candidatos a recomendação.
• 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 combinado de até 9.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo a lista final de recomendações personalizadas, com detalhes sobre cada livro e metadados sobre o processo de recomendação.
• Exemplo de Estrutura de Output:

   {
    "recomendacoes": [
      {
        "titulo": "O Hobbit",
        "autor": "J.R.R. Tolkien",
        "genero": "Fantasia",
        "idioma": "pt",
        "nivel_recomendado": "medio",
        "tipo": "continuidade",
        "motivo_curto": "Se você gostou de 'O Senhor dos Anéis', este título aprofunda o universo Tolkien.",
        "justificativa": "Uma leitura envolvente e clássica que complementa sua jornada na Terra Média.",
        "adequacao_faixa_etaria": true,
        "motivo_adequacao": "Adequado para leitores juvenis.",
        "novidade": false,
        "data_publicacao": "1937-09-21",
        "prob_aceitacao_0a1": 0.85,
        "rank": 1,
        "resumo_seguro": "A história de Bilbo Bolseiro em sua aventura épica.",
        "cta_personalizado": "Explore mais sobre a Terra Média!"
      }
    ],
    "metadados": {
      "cobertura_generos": {"Fantasia": 0.5},
      "diversidade_autores": 0.8,
      "regras_aplicadas": ["Alinhamento de gênero", "Diversidade de autores"]
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e detalhado, com um tamanho estimado em 4.500 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.
• Calculadora: Utiliza lógica interna para cálculo de pontuações e probabilidades de aceitação.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

4.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta gerada por este agente é 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, gerando a lista de recomendações que deve ser disponibilizada ao usuário.