cache-diagnosis: descubre por qué tu prompt cache se rompe sin avisar

El bug más caro y silencioso de un agente en prod: una `cache_control` mal colocada (o un mensaje del sistema que muta entre turnos) tira el caché y te facturan input completo sin error visible. Con el beta header `cache-diagnosis-2026-04-07` y `diagnostics.previous_message_id`, la API te dice exactamente dónde divergió el prefijo respecto al turno anterior. ```python from anthropic import Anthropic client = Anthropic() BETA = "cache-diagnosis-2026-04-07" SYSTEM = [{ "type": "text", "text": "Eres un asistente de soporte para ACME...", "cache_control": {"type": "ephemeral"}, }] first = client.messages.create( model="claude-opus-4-7", extra_headers={"anthropic-beta": BETA}, system=SYSTEM, messages=[{"role": "user", "content": "Hola"}], max_tokens=512, ) second = client.messages.create( model="claude-opus-4-7", extra_headers={"anthropic-beta": BETA}, diagnostics={"previous_message_id": first.id}, system=SYSTEM, messages=[ {"role": "user", "content": "Hola"}, {"role": "assistant", "content": first.content}, {"role": "user", "content": "¿Cuál es mi último pedido?"}, ], max_tokens=512, ) miss = getattr(second, "diagnostics", None) if miss and miss.cache_miss_reason: # Ej.: "system block changed after position 1024" log.warning("Cache miss: %s", miss.cache_miss_reason) ``` Cablealo en tu logger antes de subir caché de tools o de system. Una sola variable embebida en el system prompt (fecha, user_id, request_id) te tumba el 90% de descuento por token; el `cache_miss_reason` te dice qué quitar y mover fuera del bloque cacheable. Más barato debuggear esto en staging que descubrirlo en la factura.