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.
- 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.
- 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.
- 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.