O que você escreveu quando terminou Pride and Prejudice? Neste diário de leitura, a resposta é “I kept noticing who misunderstood whom.” (Eu reparava o tempo todo em quem interpretava mal quem). Ela pertence à edição em capa comum da Penguin, ISBN 9780141439518, concluída em 8 de novembro. A frase continua lá quando você abre uma nova conversa.
Você vai criar Shelf Notes, um diário de leitura privado no Google Sheets. O Open Library fornece os detalhes da edição, você fornece a data e a ideia que quer guardar, e um Agent do Quickchat AI coloca tudo na mesma linha depois da sua confirmação.
Baixe o kit inicial do Shelf Notes. Abra Shelf Notes.xlsx para ver o exemplo pronto. Use os dois arquivos TSV para montar seu próprio diário nas Planilhas Google. Eles começam uma entrada antes, quando a leitora ainda está lendo. O kit também contém as configurações exatas da Action e o Main Prompt.
1. Qual edição está na sua estante?
Teste a busca antes de conectar qualquer coisa. Abra a edição do ISBN 9780141439518. É uma edição em capa comum em inglês, com 435 páginas, publicada pela Penguin Books em 2003. O romance de Jane Austen apareceu pela primeira vez em 1813. As duas datas pertencem a Pride and Prejudice, mas só uma descreve o exemplar que está na sua mesa.
- Crie sua conta em Quickchat AI ou faça login. Use seu Agent vazio ou escolha Add new AI Agent → Set up manually. Dê a ele o nome Shelf Notes. Você vai precisar de uma conta Google para o diário e de créditos de IA disponíveis para testar uma conversa.
- Antes de adicionar notas pessoais, abra Your Website → Install → Availability and access. Desative Widget & Embed access, defina Chat Page Access como Nobody e mantenha os outros canais desconectados. Use AI Preview no painel em que você está conectado.
- Em Identity → Main Prompt, cole
main-prompt.txtdo kit. Ele orienta o Agent a mostrar a entrada proposta e esperar uma confirmação separada. - Em Actions & MCPs → Add Action → API Action → Create manually, crie as duas Actions GET abaixo. Em cada uma, use When to run → AI decides, adicione um parâmetro obrigatório Text chamado
isbnem What to ask the user first e deixe o corpo vazio. Remova espaços e hífens do número, mantendo os zeros à esquerda e umXfinal no ISBN-10.
| Nome da ação | Endpoint da API | O que usar do resultado |
|---|---|---|
lookup_book_isbn | https://openlibrary.org/search.json | Em Query Params, insira isbn={{isbn}}, fields=key,title,author_name,first_publish_year e limit=1. A obra fornece o autor e o ano original do romance. |
lookup_edition | https://openlibrary.org/isbn/{{isbn}}.json | Verifique se o número informado aparece em isbn_13 ou isbn_10. Leia a editora, a data da edição e o idioma quando estiverem presentes. Acrescente a chave retornada, que começa com /books/, a https://openlibrary.org para formar o link da fonte. |
Digite o ISBN na conversa. A Action o insere em uma URL cujo host fica fixo no editor.
Na nossa primeira busca, também pedimos a lista de edições da obra. Para este ISBN, isso trouxe de volta 4.042 IDs de edição. Ao remover esse campo, a resposta ficou curta, com o autor e o ano original. A segunda solicitação ainda retornou a única edição em capa comum que queríamos.
Em Headers, dê a cada requisição um User-Agent com o valor ShelfNotes/1.0 (YOUR_CONTACT_EMAIL), substituindo o contato de exemplo pelo seu. Cole a API Action Description correspondente de action-recipes.md, salve e ative cada Action. Teste “Look up ISBN 978-0-14-143951-8.”. Você deve ver a edição sem criar uma entrada no diário. Esta busca pessoal não exige uma conta no Open Library. Use-a quando alguém perguntar sobre um livro e siga as diretrizes de uso da API do Open Library.
2. O que entra no diário de leitura?
Separe os fatos de catálogo e as suas próprias observações em colunas diferentes. Você pode emprestar esta edição exata para alguém e discordar sobre todos os personagens. O ISBN continua o mesmo. A sua nota pertence à sua leitura, identificada aqui como PAP-01.
- Abra Actions & MCPs → Add Action → Google Sheets → Connect. Autorize a conta Google que será usada como dona do diário e depois escolha Open sheet. A conexão cria uma planilha no Drive com a permissão
drive.file. O guia de conexão com o Google Sheets mostra as telas de autorização. Para um diário pessoal, abra Compartilhar no Planilhas Google e mantenha Acesso geral como Restrito. - Desative a Action inicial ativa,
log_lead_to_google_sheet. Mantenha o nome dela e copie seu API Endpoint com o ID do arquivo já preenchido. Deixe a Action inicial desativada. Você vai criar Actions separadas para este diário.
Abra o arquivo criado para este Agent. A Action inicial já contém o ID da planilha que você precisa.
- Renomeie a aba Leads para Events e substitua o conteúdo por
Events.tsv, começando em A1. Formate as colunas B (ISBN) e F (data) como Plain text antes de colar. Adicione uma segunda aba chamada Status. Em uma nova planilha de exemplo, use File → Settings → Locale → United States para que as fórmulas abaixo aceitem vírgulas.
Comece pela linha 2. PAP-01 ainda está em leitura, com “Started with the Netherfield visit.” em G2. Depois que você confirmar, a entrada finalizada aparecerá na linha 3.
As oito colunas de Events, nesta ordem, são reading_id, isbn, title, edition_url, status, reading_date, note e conversation. A última célula guarda um link de volta para a conversa. O primeiro evento do modelo inicial diz reading em 2 de novembro. A nota é “Started with the Netherfield visit.”
Mantenha um único ID de leitura enquanto um livro passa de reading para finished. Escolha um novo quando você voltar ao livro para uma releitura.
3. Como salvar uma nota de leitura pelo ISBN?
A busca responde “Qual livro?”. Salvar responde outra pergunta: “É isso que eu quero lembrar?”. Configure uma Action para acrescentar a linha confirmada e outra para verificar o que a planilha realmente contém.
- Crie uma API Action chamada
append_reading_event. Copie a URL do Planilhas Google do modelo inicial, mantendo tudo até o ID real do arquivo. Substitua o restante por/values/Events!A:H:append. Defina POST e adicione em Query Params a entradavalueInputOption=RAW. O modo de entrada bruta preserva os ISBNs e trata uma nota que começa com=como texto. - Em Headers, defina
AuthorizationcomoBearer {{google_sheets_access_token}}eContent-Typecomoapplication/json. Quickchat AI preenche o token no momento da requisição. - Adicione seis parâmetros obrigatórios Text chamados
reading_id,isbn,title,edition_url,statusereading_date. Adicione um parâmetro opcional Text chamadonotecom valor padrão em branco. Escolhareading,finished,pausedouabandonedpara o status. Use a data informada pelo leitor comoYYYY-MM-DD. - Em API Endpoint → Body, cole o JSON abaixo. Os dois conjuntos de colchetes significam uma linha com oito células.
conversation_urljá vem embutido. Cole a descrição de acréscimo do kit em API Action Description. - Crie
read_reading_journalcomo um GET para a mesma planilha, terminando em/values/Events!A2:H1000. Dê a ele o mesmo cabeçalho bearer, a descrição de histórico do kit, nenhum parâmetro e um corpo vazio. Salve e habilite as duas Actions.
{
"values": [[
"{{reading_id}}", "{{isbn}}", "{{title}}", "{{edition_url}}",
"{{status}}", "{{reading_date}}", "{{note}}", "{{conversation_url}}"
]]
}
O array corresponde às colunas A até H. Manter a nota na sétima posição coloca as palavras do leitor na coluna G.
Com a linha inicial pronta, envie a mensagem a seguir em AI Preview.
Look up ISBN 978-0-14-143951-8. I finished PAP-01 on 2026-11-08. My note: I kept noticing who misunderstood whom.
Confira a edição proposta, o ID, a data e a pontuação. Neste ponto, Events ainda deve conter apenas a entrada inicial. Depois diga “Yes, that is my edition. Save PAP-01 with that status, date and note.”. Um segundo evento deve aparecer na linha 3.
A proposta dá a você uma última chance de conferir o ISBN e a sua redação. Você pode corrigir qualquer um dos dois antes de o diário mudar.
No nosso teste ao vivo, a proposta manteve a linha inicial intacta. Depois da confirmação, Shelf Notes verificou o diário, conferiu o ISBN novamente, adicionou uma linha e leu essa nova linha para checar. Em Inbox, expanda append_reading_event e compare o updates.updatedRange do Google com as células da sua planilha. Se uma solicitação expirar, procure a linha antes de tentar de novo. Referência de adição de linhas do Google Sheets
O Google informou uma linha e oito células atualizadas em Events!A3:H3. Selecione G3 para comparar o texto com a nota que você aprovou.
4. O que você pode perguntar em uma nova conversa?
Abra uma nova conversa no AI Preview e pergunte “What was the last note I saved for PAP-01?”. No nosso teste, o Agent leu Events novamente e retornou “I kept noticing who misunderstood whom.” A linha 2 ainda guarda a nota anterior de Netherfield. O Google pode omitir células vazias no fim de uma linha retornada, então é normal que o link da conversa fique em branco na sua linha inicial.
Para “Which books am I still reading?”, dois eventos para uma mesma leitura dariam uma resposta enganosa se você contasse cada linha. Use a aba Status para selecionar o último evento acrescentado para cada ID de leitura.
- Cole
Status.tsvem Status!A1. A fórmula em A2 lista cada ID de leitura uma vez. B2 usa uma busca por correspondência exata começando do fim de Events. Preencha B2 para baixo ao lado dos novos IDs conforme a sua estante crescer. D2 conta os IDs cujo status mais recente éfinished. - Crie
read_reading_status, outro GET com o mesmo cabeçalho Bearer, usando o sufixo/values/Status!A1:B1000. Cole a descrição de status do kit, deixe o corpo e os parâmetros vazios, depois salve e habilite. - Pergunte quais livros estão concluídos. No exemplo, Status tem uma leitura concluída,
PAP-01. Para uma segunda leitura do romance, dê a elaPAP-02. Assim você pode distinguir o que percebeu na primeira vez do que percebeu na segunda.
Copie as três fórmulas no Planilhas Google
Status!A2 lista os IDs.
=SORT(UNIQUE(IFERROR(FILTER(Events!A2:A1000,Events!A2:A1000<>""),"")),1,TRUE)
Status!B2 busca o evento mais recente para o ID da coluna A.
=IF(A2="","",XLOOKUP(A2,Events!$A$2:$A$1000,Events!$E$2:$E$1000,"",0,-1))
Status!D2 conta as leituras concluídas.
=COUNTIF(B2:B1000,"finished")
A receita cobre 999 eventos. Antes que uma nova entrada caia abaixo da linha 1000, estenda juntos os intervalos de leitura e os intervalos das fórmulas. Lembre-se de notas longas e coleções grandes ao decidir quanto histórico retornar em uma única conversa. Referência do XLOOKUP no Google Sheets
5. Isso funciona com o livro que está na sua mesa?
Pegue outro livro e teste o ISBN impresso dele. Peça a edição e depois pare. Uma boa primeira verificação é conseguir consultar um livro sem adicioná-lo. Em seguida, dê a ele um ID de leitura e uma frase que só você poderia ter escrito. Confirme, feche o chat e peça essa frase de volta.
Para fazer verificações reproduzíveis, use Testing → Simulation e depois confira Actions & MCPs → View logs e as células de destino. Experimente um ISBN não reconhecido, recuse uma entrada sugerida e salve uma nota de teste começando com =1+1. As duas primeiras ações devem deixar o histórico intacto. A última deve mostrar os caracteres literais na célula da nota.
Também fizemos a planilha local salvar uma linha e depois atingir o tempo limite antes de responder. Shelf Notes leu a linha de volta, informou o timeout e não fez uma segunda inclusão. Você pode conferir esse mesmo detalhe no log da Action se um salvamento deixar você em dúvida sobre enviar de novo.
No teste de edição ausente, o catálogo retornou 404. O Agent pediu outro identificador, e o diário manteve suas duas linhas.
Se você preferir configurar o Agent em outro assistente, o kit inclui uma solicitação de configuração para o conector de conta do Quickchat AI. Anexe action-recipes.md e main-prompt.txt e depois envie setup-request.txt. Revise as cinco Actions, conclua você mesmo a autorização do Google e faça o mesmo teste de leitura. Conector do ChatGPT · Conector do Claude · Guia de configuração da conta
Perguntas frequentes
Como adiciono um livro às Planilhas Google pelo ISBN?
Use o ISBN impresso no seu exemplar para localizar a edição dele no Open Library. Confira o título, a editora e o ano, adicione seu status de leitura e sua nota e depois confirme a linha. O kit inicial inclui os cabeçalhos da planilha, as fórmulas e as cinco receitas de Action do Quickchat AI.
Posso usar um diário de leitura que eu já tenho no Google Sheets?
Copie as entradas que você quiser para a aba Events da planilha criada pela conexão do Quickchat AI. Mantenha as oito colunas correspondentes e os ISBNs como texto. Colar o ID de outro arquivo privado na Action não dá permissão para abrir esse arquivo.
E se o Open Library não encontrar meu ISBN?
Confira o número no código de barras ou na página de copyright, incluindo qualquer zero à esquerda ou X no final. Se ainda não der para verificar a edição, deixe o diário como está. Um ISBN identifica uma edição e não dá acesso ao texto completo do livro.
Como conto os livros concluídos e acompanho releituras?
Dê a cada leitura seu próprio ID. Mantenha esse ID quando você pausar ou concluir o livro e dê um novo ID a uma releitura. Conte as entradas concluídas na aba Status. Assim, duas leituras concluídas da mesma edição contam duas vezes, enquanto duas atualizações de uma mesma leitura contam uma vez.
Posso encontrar uma nota de leitura depois de fechar a conversa?
Sim. Peça o livro ou o ID da leitura em uma nova conversa privada. A Action de histórico lê a aba Events de novo, onde ficam armazenadas as entradas com data e o texto original que você escreveu. A aba Status fornece o estado registrado mais recente de cada leitura.