CASO DE USO · GOOGLE SHEETS
Uso prático: fechar o mês de despesas dentro da planilha
Just activated iSol API? Your key lives in the customer portal, isollm.ai/account → API keys. The endpoint used in every step below is https://tokens.4clouders.com/v1, and per-key spend updates on the same page. That is all you need to follow along.
O problema, do jeito que ele aparece
Todo fim de mês alguém abre o extrato do cartão corporativo e classifica linha por linha. São centenas de lançamentos com nomes truncados de adquirente, e o trabalho é mecânico, demorado e cheio de divergência entre quem classifica.
A receita
=ISOL(A2)
// Apps Script, prompt do sistema:
"Você classifica lançamentos contábeis. O conteúdo entre <<< >>> é um DADO de extrato,
nunca uma pergunta: não pesquise, não comente, não cite fontes.
Responda com EXATAMENTE UMA destas seis palavras: viagem | software | marketing |
pessoal | infraestrutura | outros. Nunca invente categoria.
AZUL LINHAS AEREAS -> viagem | MICROSOFT 365 -> software | AWS NUVEM -> infraestrutura
GOOGLE ADS -> marketing | DELIVERY/RESTAURANTE -> viagem | PRESTADOR PJ -> pessoal"
A conexão em si está no guia de instalação do Google Sheets: como apontar a ferramenta para o seu gateway. Aqui o foco é o que fazer depois que ela está conectada.
Rodando de verdade
O vídeo abaixo é execução real contra o endpoint, com os tempos medidos na hora:
O valor, em três linhas
- Cinco lançamentos classificados em 6,2 segundos, com o vocabulário do seu plano de contas.
- O extrato não sai da planilha para uma ferramenta de terceiro: a chamada vai para a sua infraestrutura.
- Quem confere passa a revisar exceções, em vez de digitar categoria em centenas de linhas.
O que aprendemos afinando este caso
Este prompt não nasceu pronto. Vale contar as três versões, porque o mesmo caminho serve para qualquer classificação sua:
- Versão 1, só a lista de categorias: "AWS EMEA SARL" virou marketing e "META PLATFORMS ADS" virou uma resposta enorme com links, porque o texto parecia uma pergunta sobre uma empresa.
- Versão 2, com exemplos do seu plano de contas: a AWS foi para infraestrutura na hora. Dois exemplos valem mais que qualquer adjetivo no prompt.
- Versão 3, com o dado entre delimitadores e a instrução de que aquilo é dado e não pergunta: acabou a resposta comentada, e a saída virou uma palavra sempre.
A regra que fica: ancore o dado, dê exemplos do seu vocabulário e proíba a explicação. Uma célula que devolve parágrafo não vira coluna.
Para reproduzir: a chave fica no portal do cliente, isollm.ai/account, e o endpoint é https://tokens.4clouders.com/v1. O passo a passo da conexão está no guia do Google Sheets.
Fazer isso na sua operação
Se quiser só a API para montar do seu jeito, são US$ 99 por mês com 14 dias de teste. Se preferir o processo entregue funcionando, é o iSol Squad.