O cache reaproveita prefixos estáveis de prompts para reduzir latência e custo. Entenda TTL, breakpoints, invalidação e métricas para produção.
Resposta direta
O prompt caching da Anthropic reutiliza prefixos idênticos de ferramentas, instruções de sistema e mensagens, evitando reprocessar o mesmo contexto em chamadas próximas. O TTL padrão é de cinco minutos, com opção de uma hora, e a eficácia aparece nos campos cache_creation_input_tokens e cache_read_input_tokens. O ganho só ocorre quando o prefixo permanece idêntico e atende ao mínimo do modelo; timestamps, ferramentas reordenadas ou instruções alteradas podem invalidar o cache.
Cachear exige separar o estável do variável
Políticas, exemplos e definições de ferramentas devem aparecer antes de dados que mudam a cada requisição. Um timestamp inserido no prefixo pode impedir todos os hits.
TTL acompanha o ritmo do fluxo
Cinco minutos atendem conversas ativas; uma hora pode servir análises espaçadas, com custo de escrita maior. A escolha precisa considerar cadência e repetição reais.
Métricas confirmam o ganho
Cache read e cache creation devem ser acompanhados junto de latência e custo. Sem leitura de cache, a otimização existe apenas no código, não no resultado.
Ferramentas também alteram o prefixo
Mudar definições ou sua ordem invalida camadas seguintes. Catálogos dinâmicos devem usar mecanismos que preservem o conjunto estável quando a plataforma oferecer suporte.
Leitura Nexus
Cache de prompt é engenharia de contexto: estabilizar contratos, medir hits e manter privacidade. A economia sustentável depende de arquitetura previsível, não de ativar um campo isolado.
Perguntas frequentes
Qual é a duração do cache?
O padrão é cinco minutos e existe opção de uma hora, conforme a documentação atual.
Como saber se houve cache hit?
Verifique cache_read_input_tokens; cache_creation_input_tokens mostra conteúdo escrito no cache.
O cache armazena o texto do prompt?
A Anthropic informa que representações KV e hashes ficam em memória durante o TTL, sem armazenar o texto bruto em repouso.
Guias essenciais para aprofundar a decisão
Esta análise editorial foi produzida pela Nexus a partir das fontes oficiais abaixo, consultadas em 20 de setembro de 2026. O texto é original e interpreta implicações práticas para empresas.
- Anthropic — Prompt caching: TTL, breakpoints, preços relativos, mínimos, invalidação, privacidade e campos de uso.
- Anthropic — Tool use with prompt caching: regras específicas para ferramentas, server tools, tool search e preservação do prefixo.
Data informada pela fonte principal: documentação oficial consultada em 20 de setembro de 2026; análise técnica.