Guides

Aprovechar el cache (y pagar menos cuota)

Cada vez que un agente repite contexto, el modelo reutiliza el prefijo ya procesado. Esos tokens no se descuentan. Para maximizarlo:

• Mantén el system prompt estable al inicio de la conversación.
• No reordenes mensajes anteriores; el cache depende del prefijo exacto.
• Una sesión continua es más barata (en cuota) que muchas cortas.

Elegir bien el contexto

Declara limit.context y limit.output en tu harness. Si tu cliente manda prompts más grandes que tu plan, recibirás 400 context_too_large — es una protección, no un bug.

Tool calling

El modelo devuelve tool_calls estructurados (nombre + argumentos JSON). Tu harness debe ejecutar la herramienta y devolver el resultado como mensaje role: "tool".

Troubleshooting

401	Key inválida/deshabilitada o sin Bearer
403 trial_expired	Activa un plan desde el panel
400 context_too_large	Baja el contexto o inicia sesión nueva
429	Ventana/mes/concurrencia: revisa Retry-After
Respuesta sin tools	Verifica que tu cliente envíe tools y no esté en modo "ask"