Glosario
85 términos de «Memoria y estado del agente». Pasa el cursor sobre la primera aparición en la lección para ver la definición.
| Término | Definición | Fuente |
|---|---|---|
| sin estado | La propiedad de que el servidor no guarda ningún estado privado por sesión entre una llamada a la API y la siguiente, así que cada solicitud tiene que transportar por sí misma el historial completo de la conversación. | Using the Messages API |
| ventana de contexto | El contenedor que guarda todo lo que el modelo puede ver realmente en una solicitud: el prompt del sistema, cada mensaje del arreglo messages, las definiciones de herramientas y la propia salida del modelo para el turno. | Context windows |
| prompt del sistema | Texto que se envía con la solicitud para fijar el rol y el comportamiento del modelo; la documentación oficial lo enumera como uno de los componentes que cuentan para la ventana de contexto. | Context windows |
| definiciones de herramientas | El nombre, la descripción y el input_schema que le pasas al modelo para describir cada herramienta disponible; la documentación afirma que cuentan para la ventana de contexto de esa misma solicitud. | Context windows |
| razonamiento extendido | El contenido de razonamiento que produce el modelo mientras genera la respuesta de este turno; la documentación afirma que cuenta para el uso de la ventana de contexto de este mismo turno. | Context windows |
| campo usage | El campo de la respuesta de la API que informa cuántos tokens de entrada y de salida consumió realmente la solicitud. | Context windows |
| degradación de contexto | El fenómeno que nombra la documentación oficial, según el cual la precisión y la recuperación se degradan a medida que crece el número de tokens en la ventana. | Context windows |
| acumulación | El comportamiento por defecto en el que el historial de conversación se amontona en la ventana de contexto turno tras turno, creciendo y sin encogerse nunca a menos que algo lo borre activamente. | Context windows |
| reenvío | El mecanismo real detrás de la palabra «memoria»: cada solicitud reenvía al modelo los mensajes del historial anterior tal cual, en lugar de que el modelo almacene o recupere nada por sí mismo. | Using the Messages API |
| varias sesiones | El alcance de la información que tiene que sobrevivir más allá de una sola conversación y perdurar entre sesiones independientes, algo que no se logra embutiéndola en el arreglo messages actual. | Context windows |
| Messages API | La API sobre la que se construye este curso; su documentación oficial afirma sin rodeos que no tiene estado y que siempre envías el historial completo de la conversación en cada solicitud. | Using the Messages API |
| añadir | La forma más simple de gestionar el historial de conversación: cuando termina un turno, pegas los mensajes nuevos al final del arreglo messages existente y vuelves a enviar el arreglo completo en el siguiente turno. | Context windows |
| truncado | Cortar de raíz el lote más antiguo de mensajes cuando la ventana está casi llena y conservar solo los N más recientes: simple de implementar, pero lo que descarta se pierde de forma irreversible. | Context windows |
| compactación | El mecanismo oficial que destila el contenido de una ventana de contexto en un resumen de alta fidelidad, dejando que el agente continúe con una degradación mínima de rendimiento cuando la conversación se alarga. | Context engineering: memory, compaction, and tool clearing |
| resumen de alta fidelidad | Lo que produce la compactación: una versión destilada que reemplaza la larga tirada de historial crudo y se queda al frente de la ventana, conservando qué pasó y qué se concluyó mientras descarta el detalle palabra por palabra. | Context engineering: memory, compaction, and tool clearing |
| umbral de disparo | El nivel de uso de la ventana en el que un mecanismo oficial empieza automáticamente a compactar o a borrar resultados de herramientas. | Context engineering: memory, compaction, and tool clearing |
| borrado de resultados de herramientas | El mecanismo oficial apuntado al inflado que produce el propio uso de herramientas: descarta resultados antiguos y recuperables mientras conserva el registro de que la llamada ocurrió. | Context engineering: memory, compaction, and tool clearing |
| recuperable | El calificativo que decide qué puede descartar el borrado: contenido devuelto por una herramienta que se quedó obsoleto y que se puede obtener de nuevo llamando a la misma herramienta con los mismos argumentos. | Context engineering: memory, compaction, and tool clearing |
| 150K tokens | El umbral de disparo por defecto de la compactación: se dispara automáticamente en cuanto el uso de la ventana llega a este nivel. | Context engineering: memory, compaction, and tool clearing |
| 100K tokens | El umbral de disparo por defecto del borrado de resultados de herramientas, más bajo que los 150K de la compactación, lo que refleja su papel de intervenir antes contra la única fuente de inflado que es la salida de herramientas. | Context engineering: memory, compaction, and tool clearing |
| 50K tokens | El piso impuesto por el servidor para el umbral de disparo de la compactación: el valor configurado tiene que ser al menos así de grande, así que el umbral no se puede bajar arbitrariamente. | Compaction |
| las 3 llamadas a herramientas más recientes | La política de retención por defecto del borrado de resultados de herramientas: los resultados completos de las últimas tres llamadas quedan intactos, y los resultados de herramientas más antiguos se borran. | Context engineering: memory, compaction, and tool clearing |
| modelo mental | El reparto de tareas en tres partes que da el Cookbook para manejar el inflado del contexto: compactación para una ventana que creció demasiado, borrado para los datos obsoletos y recuperables que hay dentro, memoria para sobrevivir a través de las sesiones. | Context engineering: memory, compaction, and tool clearing |
| uso de la ventana | La medida de cuánta capacidad de la ventana de contexto ocupa el historial de conversación actual; es lo que consultas para decidir si truncar, compactar o borrar. | Context engineering: memory, compaction, and tool clearing |
| toda la transcripción | El alcance de la compactación: los mensajes del usuario, los mensajes del asistente, las llamadas a herramientas, los resultados de herramientas e incluso los bloques de compactación previos se aplanan todos dentro del nuevo resumen. | Context engineering: memory, compaction, and tool clearing |
| ida y vuelta | Un intercambio completo de llamada a herramienta —el mensaje del asistente que lleva el tool_use más el mensaje del usuario que lleva el tool_result correspondiente—, la unidad más pequeña que el recorte del historial puede tratar como atómica. | Handle tool calls |
| tool_use_id | El identificador que ata un bloque tool_result de vuelta al bloque tool_use que lo produjo; el borrado reemplaza el contenido del resultado pero deja este id en su sitio. | Handle tool calls |
| memoria externa | Almacenamiento que no está atado al ciclo de vida de una sola conversación —normalmente un archivo en disco—, así que la información escrita ahí se puede seguir leyendo después de que la sesión termine. | Context engineering: memory, compaction, and tool clearing |
| archivo de memoria | Un archivo guardado en disco para llevar información a través de las sesiones —CLAUDE.md es el caso representativo—, que puede cargarse en el contexto completo o en parte cuando arranca una sesión. | How Claude remembers your project |
| carga en la ventana de contexto | El proceso por el cual el contenido de un archivo de memoria se lee desde disco y se inyecta en una solicitud concreta, volviéndolo visible para el modelo en ese turno. | How Claude remembers your project |
| comentarios HTML a nivel de bloque | Contenido envuelto en <!-- --> dentro de un archivo CLAUDE.md; la documentación afirma que se elimina antes de que el contenido se inyecte en el contexto del agente. | How Claude remembers your project |
| Auto memory | Memoria que escribe el propio modelo a medida que avanza la conversación, estructurada como un archivo índice más archivos de tema bajo demanda, complementando el CLAUDE.md escrito por humanos. | How Claude remembers your project |
| archivo índice | La primera capa de la estructura de dos capas de Auto memory —MEMORY.md, por ejemplo—, que guarda resúmenes de las entradas por tema en lugar del contenido completo de cada tema. | How Claude remembers your project |
| recuperación bajo demanda | Cargar solo los resúmenes de las entradas del índice al inicio de la sesión, y leer un archivo de memoria de tema concreto solo cuando la tarea actual de verdad lo necesita. | How Claude remembers your project |
| MEMORY.md | El archivo índice de Auto memory; la regla oficial es que al inicio de cada conversación solo se cargan sus primeras 200 líneas o sus primeros 25KB, lo que ocurra primero. | How Claude remembers your project |
| CLAUDE.md | Un archivo de memoria de proyecto escrito por humanos que se carga completo en el contexto al inicio de cada sesión; el objetivo de tamaño oficial es por debajo de 200 líneas, con un límite duro de 4 MiB. | How Claude remembers your project |
| 200 líneas | El objetivo de tamaño oficial recomendado para un archivo CLAUDE.md; pasarse consume más contexto y baja la adherencia del agente a las instrucciones. | How Claude remembers your project |
| 4 MiB | El límite duro genuino de CLAUDE.md: un archivo de hasta este tamaño se carga completo, y cualquier cosa más grande se omite por completo. | How Claude remembers your project |
| /compact | El comando de compactación en Claude Code; la documentación señala que un CLAUDE.md en la raíz del proyecto lo sobrevive, ya que se relee desde disco y se reinyecta en la sesión después. | How Claude remembers your project |
| comprobación de límites | Lógica de comprobación de rutas añadida a la herramienta de lectura/escritura de archivos de memoria para que no se la pueda convencer de leer o escribir archivos fuera del directorio de memoria. | How Claude remembers your project |
| directorio hermano del mismo prefijo | El directorio que derrota una comprobación de ruta por simple prefijo de cadena: /project/memory-evil comparte el prefijo /project/memory y por eso pasa el startsWith, aunque esté enteramente fuera de la raíz de memoria. | How Claude remembers your project |
| path.sep | La constante de Node para el separador de rutas de la plataforma, usada en la condición segura de límites abs.startsWith(ROOT + path.sep) para que solo coincidan las rutas que empiezan con «la raíz más el separador». | How Claude remembers your project |
| estado estructurado | El progreso de una tarea expresado mediante campos fijos —una lista de tareas pendientes con marcadores de estado explícitos— que el código anfitrión puede analizar de forma fiable, a diferencia del progreso descrito en prosa. | Track todos |
| lista de tareas pendientes | Una tarea de varios pasos desglosada en un conjunto de elementos, cada uno con un campo de estado explícito, para que el agente y el código anfitrión puedan seguir el progreso juntos. | Track todos |
| ciclo de vida | Las cuatro etapas que recorre una tarea pendiente desde el momento en que se identifica hasta que ya no se necesita: creada, activada, completada, eliminada. | Track todos |
| pending | El primer estado del ciclo de vida de una tarea pendiente: el elemento se identificó y se añadió a la lista, pero el trabajo sobre él no ha empezado. | Track todos |
| in_progress | El segundo estado del ciclo de vida de una tarea pendiente: cuando el trabajo empieza de verdad, el estado pasa de pending a este valor. | Track todos |
| completed | El tercer estado del ciclo de vida de una tarea pendiente: el estado que se fija cuando la tarea termina con éxito. | Track todos |
| deleted | El cuarto estado del ciclo de vida de una tarea pendiente: una tarea que ya no se necesita se elimina fijando su estado en este valor mediante una llamada TaskUpdate. | Track todos |
| herramienta de seguimiento de tareas | La herramienta que le permite a un agente crear y actualizar los estados de las tareas pendientes, de modo que el progreso de la tarea aparece en el flujo de mensajes como llamadas a herramienta estructuradas. | Track todos |
| llamada a herramienta estructurada | La forma en que un cambio de estado de seguimiento de tareas aparece en el flujo de mensajes: una llamada identificable y analizable por sí sola, no una línea de prosa. | Track todos |
| punto de control | El estado de una tarea en un momento dado, escrito como datos y persistido en algún sitio fuera del tiempo de vida de la sesión, para que la ejecución pueda reanudarse tras una interrupción. | Track todos |
| recuperabilidad | La capacidad, tras un reinicio del proceso, de leer el punto de control más reciente y continuar desde donde el trabajo se detuvo en lugar de empezar de cero. | Track todos |
| idempotente | La propiedad de una operación que produce el mismo resultado sin importar cuántas veces se ejecute, así que volver a ejecutarla no provoca efectos secundarios extra. | Track todos |
| TaskUpdate | La llamada a herramienta que se usa para cambiar el estado de una tarea pendiente; cada paso del ciclo de vida, la eliminación incluida, pasa por ella. | Track todos |
| MemoryTrap | Una vulnerabilidad real divulgada por investigadores de Cisco que describe cómo una rutina de apariencia inofensiva —clonar un repo, aprobar la instalación de una dependencia— se convierte en una inyección de prompt persistente. | Memory Is a Feature. It Is Also an Attack Surface |
| ASI06 | El identificador de categoría de riesgo de OWASP para la seguridad de agentes que cubre el envenenamiento de memoria y de contexto, la clase a la que corresponde MemoryTrap. | Memory Is a Feature. It Is Also an Attack Surface |
| memoria persistente | Almacenamiento que un agente lee y en el que confía a través de las sesiones; como se carga de forma automática y repetida, lo que se escriba ahí moldea el comportamiento futuro, no solo una respuesta. | Memory Is a Feature. It Is Also an Attack Surface |
| inyección de prompt persistente | En lo que se convirtió un flujo de trabajo rutinario de desarrollo en MemoryTrap: contenido inyectado que no queda confinado a un turno, sino que se escribe donde se recargará y se volverá a confiar en él en sesiones futuras. | Memory Is a Feature. It Is Also an Attack Surface |
| memoria obsoleta | Contenido en la memoria persistente que antes era correcto pero que ya no aplica, y que aun así se ejecuta como una regla vigente simplemente porque sigue en la memoria. | Memory Is a Feature. It Is Also an Attack Surface |
| superficies de confianza | Lugares como la memoria, los hooks y la configuración que el sistema carga repetidamente como fuente de confianza, así que el contenido malicioso que llegue ahí puede explotarse una y otra vez. | Memory Is a Feature. It Is Also an Attack Surface |
| razonamiento futuro | Lo que un atacante influye realmente una vez que el contenido malicioso llega a una superficie de confianza: no esta única respuesta, sino el razonamiento del modelo a lo largo de muchas sesiones futuras. | Memory Is a Feature. It Is Also an Attack Surface |
| configuración global de hooks | La configuración global a la que, junto a la memoria persistente, también llegó el contenido malicioso en el caso MemoryTrap: otro almacén que el sistema carga y en el que confía repetidamente. | Memory Is a Feature. It Is Also an Attack Surface |
| capa de instrucciones de alta confianza | La capa en la que el contenido malicioso de MemoryTrap influyó a través del system prompt: una fuente de instrucciones a la que el sistema concede un alto grado de confianza. | Memory Is a Feature. It Is Also an Attack Surface |
| envenenamiento de memoria | Contenido malicioso escrito activamente en la memoria persistente o en otra superficie de confianza, de modo que un almacenamiento que debería ser fiable lleva en cambio la carga útil de un atacante. | Memory Is a Feature. It Is Also an Attack Surface |
| credenciales | Claves, contraseñas y tokens de acceso: contenido que, una vez escrito en un archivo de memoria de carga automática, queda reexpuesto en la ventana en cada sesión sin ningún beneficio equivalente. | Memory Is a Feature. It Is Also an Attack Surface |
| texto crudo no confiable | Contenidos de archivos, texto web y salida de dependencias que un agente lee mientras hace una tarea: datos de entrada para esa única tarea, no algo que copiar literalmente en la memoria persistente. | Memory Is a Feature. It Is Also an Attack Surface |
| las reglas y los hechos estables y confirmados | Contenido de una fuente claramente fiable que una persona ha confirmado —convenciones de estilo de código, una causa raíz establecida tras una investigación real—, la clase que vale la pena escribir en la memoria persistente. | Memory Is a Feature. It Is Also an Attack Surface |
| herramientas de lectura/escritura de memoria | El par de herramientas (read_memory / write_memory) que le permiten a un agente escribir contenido que vale la pena conservar más allá de la ventana y recuperar lo que guardó antes. | How Claude remembers your project |
| raíz de memoria | El directorio dedicado a los archivos de memoria (MEMORY_ROOT en el código); toda operación que hacen las herramientas de lectura/escritura de memoria queda confinada a él. | How Claude remembers your project |
| write_memory | La herramienta que escribe texto en un archivo bajo la raíz de memoria; su description detalla el límite de «qué guardar» que estableció la Lección 5. | How Claude remembers your project |
| orientación a nivel de prompt | Una regla expresada solo en la description de una herramienta, que orienta la tendencia de comportamiento del modelo pero que no impone el código como sí lo hace una comprobación de ruta. | Memory Is a Feature. It Is Also an Attack Surface |
| backfill de memoria entre sesiones | Lógica que lee activamente los archivos de memoria cuando arranca una sesión nueva e inyecta su contenido como mensaje inicial, para que la memoria esté en la ventana desde el primerísimo turno. | How Claude remembers your project |
| compactación escrita a mano | La implementación didáctica simplificada de la compactación en este curso: disparar por un presupuesto de caracteres, partir el historial en fronteras de ida y vuelta completas y hacer una llamada al modelo para generar el resumen. | Context engineering: memory, compaction, and tool clearing |
| compact_20260112 | El identificador de la funcionalidad nativa de compactación de Anthropic, que se dispara a los 150K tokens por defecto: el mecanismo que la versión escrita a mano de la lección se limita a imitar. | Context engineering: memory, compaction, and tool clearing |
| clear_tool_uses_20250919 | El identificador de la funcionalidad nativa de borrado de resultados de herramientas de Anthropic, que se dispara a los 100K tokens por defecto y conserva los resultados de las últimas 3 llamadas. | Context engineering: memory, compaction, and tool clearing |
| presupuesto de caracteres | Una aproximación didáctica tosca que mide el uso de tokens por cantidad de caracteres para decidir si el historial necesita compactarse; no es un conteo preciso de tokens. | Context engineering: memory, compaction, and tool clearing |
| splitKeepingToolPairs | La función auxiliar que decide dónde cortar el historial para compactar, retrocediendo el punto de corte hasta que un par tool_use / tool_result deje de quedar partido entre el resumen y la parte conservada. | Handle tool calls |
| mensaje de resumen | El único mensaje que produce una compactación escrita a mano para reemplazar el historial anterior, insertado al frente del arreglo messages. | Context engineering: memory, compaction, and tool clearing |
| llamada de resumen | La llamada extra al modelo que hace una compactación escrita a mano para generar el resumen: uno de los costos concretos de compactar. | Context engineering: memory, compaction, and tool clearing |
| contenido de marcador de posición | El texto sustituto que una función de borrado escrita a mano intercambia por el contenido antiguo de tool_result que supera el número a conservar, dejando intacto el tool_use_id. | Context engineering: memory, compaction, and tool clearing |
| número a conservar | La cantidad de llamadas a herramientas más recientes cuyos resultados completos preserva el borrado; los resultados que la superan se reemplazan por contenido de marcador de posición, haciendo eco del valor nativo por defecto de 3. | Context engineering: memory, compaction, and tool clearing |
| recorte del historial | La capacidad que esta lección añade al bucle de ejecución para que una conversación larga no se hinche sin parar, cubriendo tanto la compactación escrita a mano como el borrado de resultados de herramientas. | Context engineering: memory, compaction, and tool clearing |
| TOOLS | La única tabla que registra el esquema de cada herramienta junto a su función de implementación; el bucle deriva de ella toolSchemas y toolHandlers. | How tool use works |
| bucle aumentado con memoria | El bucle terminado que construye esta lección: el bucle de ejecución del curso de llamada a herramientas con la lectura/escritura de memoria, el backfill de memoria, la compactación escrita a mano y el borrado de resultados de herramientas encajados dentro. | How tool use works |