Agente de IA para Catalogação de Livros em Bibliotecas Escolares

Receber dados brutos de novos livros e organizar em um envelope padronizado para processamento posterior.

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 brutos de novos livros 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 é um conjunto de dados brutos de livros, que pode incluir texto livre, metadados e transcrições de contracapa.
• Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .txt, .json, .csv.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 20.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado contendo o texto base e campos iniciais padronizados.
• Exemplo de Estrutura de Output:

   {"entrada_padronizada": {"texto_base": string, "campos_iniciais": {"titulo": string?, "autores": string[]?, "resumo": string?, "classificacao_etaria": string?}, "idioma_detectado": string, "possiveis_isbn": string[], "sinalizadores_qualidade": {"texto_curto": boolean, "provavel_ruido": boolean}}, "preparacao_status": "ok"|"insuficiente", "motivo_insuficiencia": string?} 

• Número de caracteres esperado: O texto final deve ser conciso e informativo, com um tamanho estimado em torno de 2.500 caracteres, podendo variar conforme a complexidade dos dados brutos recebidos.

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 Extração de Metadados Bibliográficos (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Extração de Metadados Bibliográficos (RF 2).

Extrair de forma estruturada título, autores, resumo, identificadores e demais metadados essenciais a partir da entrada padronizada.

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 estruturado contendo o texto base e campos iniciais padronizados 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 JSON com até 10.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os metadados extraídos, incluindo título, autores, resumo, idioma e identificadores ISBN.
• Exemplo de Estrutura de Output:

   {"metadados": {"titulo": string, "subtitulo": string?, "autores": [{"nome": string}], "editora": string?, "ano_publicacao": number?, "idioma": string, "isbn_10": string?, "isbn_13": string?, "paginas": number?, "resumo": string}, "metadados_extraidos_ok": true|false, "falhas_extracao": string[]?} 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 3.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: Não utiliza.
• 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 (JSON com metadados) deve ser visível para o Agente de Classificação Temática e Etária (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Classificação Temática e Etária (RF 3).

Atribuir categoria temática e classificação etária coerentes para uso em bibliotecas 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 como input um JSON contendo os metadados extraídos e validados 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 JSON com até 5.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo a classificação temática e etária dos livros, juntamente com justificativas e níveis de confiança.
• Exemplo de Estrutura de Output:

   {"classificacao": {"temas": string[], "categoria_principal": string, "classificacao_etaria": "Infantil (0-5)"|"Infantojuvenil (6-10)"|"Juvenil (11-14)"|"Jovem Adulto (15-17)"|"Adulto (18+)"|"Livre", "justificativa_etaria": string, "confianca": {"temas": 0.0-1.0, "etaria": 0.0-1.0}}, "classificacao_ok": true|false} 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 2.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.
• 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 (JSON com classificação) deve ser visível para o Agente de Validação e Normalização de Metadados (RF 4).

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

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

Aplicar regras de consistência e padronização antes do envio ao catálogo.

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 como input um JSON contendo metadados e classificações de livros 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 JSON com até 7.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o registro normalizado dos livros, pronto para envio ao catálogo.
• Exemplo de Estrutura de Output:

   {"registro_normalizado": {"titulo": string, "subtitulo": string?, "autores": [{"nome": string, "formato_bibliografico": string}], "editora": string?, "ano_publicacao": number?, "idioma": string, "isbn": string?, "paginas": number?, "resumo": string, "temas": string[], "categoria_principal": string, "classificacao_etaria": string}, "erros": string[], "normalizacao_ok": true|false} 

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

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 (JSON com registro normalizado) deve ser visível para o Agente de Decisão de Inserção ou Atualização e Geração de Payload (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Decisão de Inserção ou Atualização e Geração de Payload (RF 5).

Decidir entre criar novo registro ou atualizar existente e preparar payload do catálogo.

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 contendo o registro normalizado dos 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 JSON com até 5.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo a decisão de ação (create, update ou abort) e o payload preparado para o catálogo.
• Exemplo de Estrutura de Output:

   {"acao": "create"|"update"|"abort", "criterio_correspondencia": "isbn"|"titulo_autor_ano"|null, "referencia_existente": string|null, "payload_api": {"endpoint": string, "metodo": "POST"|"PUT", "body": {...}}} 

• 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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 (JSON com decisão e payload) deve ser visível para o Agente de Execução de Chamada à API (RF 6).

5.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 6).

Realizar chamada à API do Sistema de Catálogo para inserir ou atualizar o registro do livro.

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 JSON contendo a decisão de ação e o payload preparado para o 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 JSON com até 3.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o resultado da chamada à API, incluindo status HTTP e ID do registro quando aplicável.
• Exemplo de Estrutura de Output:

   {"resultado_api": {"status_http": number, "id_registro": string?, "mensagem": string?}} 

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

6.3.3 Parâmetros de Geração

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

6.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 e retornar o resultado da chamada.

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

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

A execução deste agente finaliza o fluxo. O resultado da API é o resultado que deve ser disponibilizado ao usuário.