Carlos Tapia

Glosario

Las palabras técnicas que aparecen en las notas, en el sentido que tienen aquí.

Agente agent
Un modelo con herramientas, un ciclo y un lugar donde escribir, que avanza hacia una tarea en varios pasos.
Equipo (célula) team (cell)
Un grupo de agentes con sus roles, su backlog y su motor. Es la unidad que comparo por costo. Algunas notas lo llaman célula.
Rol role
Un agente con una función fija dentro de un equipo (planificar, programar, probar, revisar), con su modelo y sus carpetas.
Ronda round
Una pasada completa del equipo: todos los roles que juegan, de principio a fin.
Turno turn
Cada vez que el motor le pasa el trabajo a un rol: lee, hace sus tool calls y entrega. Todo en este sitio se costea por turno.
una rondaplanificarturnoprogramarturnoprobarturnorevisarturnotool calls
Hilo thread
La conversación que un rol arrastra de un turno al siguiente. Si sigue viva, el turno siguiente reusa el prefijo cacheado; si se reinicia, el rol lo reconstruye y paga una escritura de caché.
Tool call
Un uso de una herramienta dentro de un turno: leer un archivo, correr un comando, buscar. Cada uno vuelve a leer el prefijo cacheado, así que el costo de un turno sigue a sus tool calls.
Context window
Todo lo que el modelo puede ver en una llamada. Tiene un límite, y buena parte del diseño de agentes se trata de qué entra ahí.
Prompt caching
El proveedor guarda un prefijo ya procesado para no procesarlo otra vez. Leerlo es barato; escribirlo cuesta más.
Prefijo cacheado cached prefix
El comienzo de cada llamada que no cambia entre una y otra (instrucciones, definición de herramientas, la conversación hasta ahí), servido desde la caché. Cada tool call lo vuelve a leer.
llamada 1prefijo (no cambia)lo nuevollamada 2prefijo (no cambia)lo nuevollamada 3prefijo (no cambia)lo nuevose escribe: 1,25×se relee: 0,1×
Cache read / cache write
Los dos lados de la cuenta. Una escritura guarda el prefijo y cuesta 1,25× un token normal; una lectura lo reusa y cuesta 0,1×.
Autocompact
Resumir una conversación que está llenando su ventana para que el agente pueda seguir. Solo conviene si después quedan suficientes llamadas.
Handoff
Lo que un rol deja escrito para el próximo turno o para otro rol: un objeto corto con el resultado, no la conversación entera.
Territorio territory
Las rutas que un rol puede escribir. Lo que puede leer se define aparte y suele ser más amplio.
Sandboxing
Aislamiento, a nivel de sistema operativo, de lo que un proceso puede leer, escribir y alcanzar en la red. Es anterior a los agentes y no sabe nada de roles.
Compensación compensation
Cuando un agente no puede arreglar un bug donde está, porque ese archivo es de otro rol, y mete el arreglo en sus propios archivos para que los tests pasen. El bug de origen sigue ahí. En ingeniería de software se llama downstream workaround, y lo habitual es avisarle al dueño; una compensación callada es la que no avisa. Es una forma de specification gaming: se cumple la letra de la tarea (tests en verde) y no su propósito.
Trust-handoff
Un archivo que el agente escribe dentro de su carpeta permitida y que después ejecuta otra cosa, fuera del sandbox: un hook de git, la configuración del editor o del agente.
el sandboxagentework/.git/hooks/pre-commitescribeesto se ve normaltú, más tarde:git commitel hook corre afueraahí está la fuga
Contrato contract
En el laboratorio de sandboxes, una prueba con tres partes: un ataque que el agente no debe lograr, un control con trabajo legítimo que tiene que seguir funcionando, y un efecto que se revisa después.
Línea base baseline
Correr el mismo ataque primero sin sandbox. Si ahí también falla, un «bloqueado» con sandbox no prueba nada.
Landlock
El mecanismo del kernel Linux que usan varios sandboxes para limitar el acceso a archivos. Solo sabe conceder: no puede negar una carpeta dentro de otra ya concedida.
Guardrail
Un chequeo con código fijo que corre antes de que el modelo actúe y puede bloquear la llamada. No cuesta contexto.
Gate
Un chequeo que el trabajo tiene que pasar antes de avanzar, como tests o una revisión. El guardrail mira la llamada; el gate mira el resultado.
Human-in-the-loop
Una pausa que detiene la corrida y la retoma con la respuesta de una persona.
Control plane
La capa que decide qué agente trabaja, reintenta lo que falló y aplica los límites. En un sistema de agentes concentra buena parte de la arquitectura.
MCP
Model Context Protocol. Una forma estándar de exponer herramientas a un modelo: un servidor de herramientas escrito una vez funciona desde varios clientes.
Retrieval
Cómo un agente busca y trae el texto que va a usar o citar: búsqueda exacta (grep, texto completo) o semántica (embeddings).
Embeddings
Convertir un texto en un vector de números para que los textos de significado parecido queden cerca. Sirve para encontrar, no para comprobar una cita exacta.
Fan-out
A cuántos destinatarios llega un mismo mensaje. Un mensaje con fan-out de 3 se paga tres veces.
Churn
La parte del código escrito que después se reescribió o se borró. Lo contrario es la supervivencia: lo que sigue ahí.
Eval
Una prueba repetible de cómo se comporta un modelo o un agente. Dos equipos que informan el mismo porcentaje muchas veces miden cosas distintas.
Tarea verificada verified task
Trabajo que revisó y aprobó alguien distinto de quien lo hizo. El costo por tarea verificada es la cifra de costo que comparo.
ADR
Architecture Decision Record. Un documento corto con una decisión de arquitectura, por qué se tomó y cuánto costaría revertirla.