$ glosario de capsul
Glosario
Las palabras que deciden el coste de un agente de código, definidas en una frase cada una y luego explicadas.
- Token
- Un token es la unidad que un modelo de lenguaje lee y factura: una palabra común, un fragmento de palabra o un signo de puntuación, unos tres o cuatro caracteres de media.
- Ventana de contexto
- La ventana de contexto es el número máximo de tokens que un modelo puede considerar a la vez, incluidas las instrucciones, la conversación y todo lo que acompaña a la pregunta.
- Tokens de entrada y de salida
- Los tokens de entrada son todo lo que se envía al modelo en una petición; los de salida son lo que escribe de vuelta, y en el trabajo con agentes la entrada domina la factura por un orden de magnitud o más.
- Presupuesto de tokens
- Un presupuesto de tokens es un techo duro sobre cuánto contexto puede entrar en una petición, aplicado antes de enviarla en vez de negociado con el modelo.
- Caché de prompts
- La caché de prompts permite a un proveedor reutilizar la forma ya procesada de un prefijo repetido entre peticiones, facturando esos tokens a una fracción de la tarifa nueva.
- Tasa de acierto de caché
- La tasa de acierto de caché es la proporción de tokens de entrada de una petición servidos desde una caché de prompts en lugar de procesados de nuevo.
- Degradación del contexto
- La degradación del contexto es el empeoramiento de las respuestas de un modelo a medida que su contexto crece, por dilución del material relevante, contradicciones entre lo viejo y lo nuevo, y callejones sin salida acumulados.
- Bucle de agente
- Un bucle de agente es el ciclo en el que un modelo llama a una herramienta, lee el resultado y decide qué hacer después, repitiendo hasta producir una respuesta.
- Llamada a herramienta
- Una llamada a herramienta es una petición estructurada de un modelo para ejecutar algo fuera de sí mismo, como leer un archivo o correr un comando, cuyo resultado vuelve al contexto.
- Mapa del repositorio
- Un mapa del repositorio es un esquema comprimido de una base de código que lista sus archivos y los símbolos que definen, para que un modelo localice cosas sin leerlo todo.
- Límite de uso
- Un límite de uso pone tope a cuánto puedes enviar en una ventana de tiempo, medido sobre tokens procesados y no sobre el número de mensajes enviados.
- Agente de código de línea de comandos
- Un agente de código de línea de comandos es un programa de terminal que permite a un modelo leer, ejecutar y modificar cosas en un directorio de trabajo, bajo las reglas de aprobación que tú fijes.
- CLAUDE.md
- CLAUDE.md es un archivo Markdown de instrucciones permanentes que Claude Code carga al iniciar cada sesión y cuyo contenido forma parte de todas sus peticiones.
- AGENTS.md
- AGENTS.md es un archivo Markdown de instrucciones permanentes para agentes de código que estos cargan en su contexto antes de empezar a trabajar.
- Compactación del contexto
- La compactación del contexto sustituye el historial de conversación de un agente por un resumen escrito por el modelo para que una sesión larga vuelva a caber en su ventana de contexto.
- Subagente
- Un subagente es una instancia independiente, con ventana de contexto, prompt de sistema y herramientas propios, a la que un agente de código encarga una tarea y de la que recibe un resultado resumido.
- Model Context Protocol (MCP)
- Model Context Protocol (MCP) es un estándar abierto para conectar aplicaciones de IA con herramientas y datos externos mediante servidores que exponen herramientas, recursos o prompts a clientes compatibles.
- Definición de herramienta
- Una definición de herramienta es el nombre, la descripción y el esquema de entrada con los que se presenta una herramienta al modelo, contabilizados como entrada cuando el cliente los incluye en una petición.
- Escritura en caché
- Una escritura en caché procesa y guarda el prefijo de un prompt para reutilizarlo después, con un coste inicial superior al de la entrada normal a cambio de lecturas posteriores más baratas.
- Duración de la caché (TTL)
- El TTL de una caché es el tiempo que un prefijo de prompt permanece guardado sin usarse antes de que la siguiente petición tenga que procesarlo y escribirlo otra vez.
- Tokens de entrada ponderados por caché
- Los tokens de entrada ponderados por caché cuentan cada token según su coste respecto a la entrada nueva: esta cuenta completa, las lecturas de caché a precio reducido y las escrituras con recargo.
- Coste equivalente de API
- El coste equivalente de API es lo que valdrían los tokens de una sesión a las tarifas públicas de API del proveedor, incluso cuando el trabajo se hizo con una suscripción sin cobro por token.
- Coste por tarea
- El coste por tarea es el gasto total para completar un trabajo, incluidas todas las peticiones, reintentos y llamadas delegadas, en lugar del precio de un token o una sola petición.
- Prompt de sistema
- Un prompt de sistema es el bloque de instrucciones que precede a la conversación en cada petición al modelo y establece su función y las reglas que debe seguir.
- Tokenizador
- Un tokenizador divide el texto en los tokens que lee y factura un modelo; por eso un mismo texto puede producir recuentos distintos en dos modelos.
- Razonamiento ampliado
- El razonamiento ampliado son los tokens que un modelo genera para razonar antes de responder y que se facturan como salida aunque no se muestren al usuario.