hiddenrows

Guías prácticas para trabajar con agentes de IA, con un laboratorio al final de cada una

última edición=16 de octubre · 24 piezas · 14 breves
regla=solo lo verificado como hecho
llamadas a un modelo por visita=0

Glosario vivo29 términos

Cada término, explicado sin usar otro término que haya que buscar. Si algo aquí se queda corto, es que merece una guía: así nacen la mitad de las que publicamos.

Agente
Un programa que le da a un modelo de lenguaje la capacidad de hacer cosas por su cuenta —leer ficheros, ejecutar órdenes, buscar en internet— y le deja repetir el ciclo «piensa, actúa, mira el resultado» hasta terminar el encargo. Lo que lo separa de un chat es que actúa, no solo responde.
Modelo de lenguaje (LLM)
El programa que escribe el texto: recibe todo lo que se le ha dado a leer y produce la continuación más probable. Por sí solo no puede hacer nada más; necesita que alguien le ponga herramientas delante.
Contexto
Todo el texto que el modelo tiene delante cuando le toca escribir: tu encargo, las instrucciones del proyecto, los ficheros que ha abierto y lo que ha ido pasando en la conversación. Es su única memoria: lo que no esté ahí, para él no existe.
Harness (arnés)
Todo lo que rodea al modelo y lo convierte en algo útil: el bucle que lo llama una y otra vez, las herramientas a las que le deja acceder, los permisos, lo que le enseña y lo que le oculta, y la forma de comprobar si el trabajo está bien. Claude Code, Codex o Cursor son arneses distintos montados sobre modelos parecidos.
Ingeniería de contexto
Decidir qué entra en esa memoria en cada paso y qué se queda fuera. No consiste en escribir órdenes más ingeniosas, sino en administrar un espacio limitado.
Token
La unidad en la que se mide y se cobra el texto: un trozo de palabra. Unas 750 palabras son 1.000 tokens. Importa por dos razones: se paga por token y no caben infinitos a la vez.
Ventana de contexto
El tope de texto que el modelo puede tener delante de una vez. Cuando se llena hay que tirar algo, y alguien tiene que decidir qué.
Degradación por contexto largo (context rot)
Que el modelo acierte menos cuanto más largo es lo que le has dado a leer, aunque quepa de sobra. Darle de más no sale gratis.
Compactar
Cuando el contexto se llena, resumir lo ocurrido y seguir trabajando con el resumen. Libera sitio, pero lo que no entre en el resumen se ha perdido para siempre, normas incluidas.
Subagente
Encargarle un trozo del trabajo a un segundo agente que empieza con la memoria en blanco y solo devuelve la conclusión. Así los veinte ficheros que tuvo que leer para resolverlo no ocupan la memoria del primero.
Skill
Una carpeta con instrucciones que el agente solo abre cuando el trabajo las pide, en lugar de llevarlas siempre encima ocupando sitio.
MCP
Un enchufe común para que cualquier agente se conecte a herramientas y datos de terceros sin programar la conexión cada vez. Las siglas son de Model Context Protocol.
Hook
Código tuyo que el programa ejecuta siempre en un momento fijo —por ejemplo, justo antes de dejar que el agente toque un fichero— y que puede cortar la acción. A diferencia de una instrucción escrita, no depende de que el modelo quiera hacerte caso.
AGENTS.md
Un fichero en la raíz del proyecto donde se escriben las normas de la casa para que las lea cualquier agente que trabaje ahí. Funciona mejor como índice breve que como manual.
Evaluación propia (eval)
Un examen tuyo: un puñado de encargos reales, con la respuesta que consideras correcta, que le pasas al agente cada vez que cambias algo. Sin esto, «ahora va mejor» es una impresión, no un dato.
pass@k y pass^k
Dos formas de contar aciertos. pass@k es acertar alguna vez en k intentos, que es lo que luce en los rankings. pass^k es acertar las k veces seguidas, que es lo que necesita un proceso que va a repetirse todos los días.
Trifecta letal
Las tres condiciones que, juntas, permiten que alguien de fuera se lleve tus datos: el agente ve información privada, lee contenido escrito por terceros y tiene alguna forma de mandar algo al exterior. Con dos de las tres no hay robo posible; con las tres, sí.
Inyección de instrucciones (prompt injection)
Colar órdenes dentro de algo que el agente va a leer —una página, un correo, un ticket— para que las obedezca como si vinieran de ti. Funciona porque el modelo no distingue con fiabilidad quién escribió cada frase.
Traza
El registro de lo que hizo el agente paso a paso: qué leyó, qué herramienta usó y qué obtuvo. Es lo primero que se mira cuando algo sale mal.
Entorno aislado (sandbox)
Una copia cerrada del sistema donde el agente puede equivocarse sin romper nada de verdad.
Flujo fijo (workflow)
Pasos que escribes tú en un programa normal, que llaman al modelo solo donde hace falta. Más barato y más predecible que un agente; se queda corto cuando el camino no se puede prever de antemano.
Prompt
El encargo que le escribes al modelo.
Examen estándar (benchmark)
Una prueba común que usa todo el sector para comparar modelos y agentes entre sí. Sirve para comparar unos con otros, no para saber si algo funcionará en tu caso.
Horizonte temporal
Una forma de medir hasta dónde llega un agente: cuánto tardaría una persona en las tareas que él completa acertando la mitad de las veces.
Regla de permisos
Una línea de configuración que decide, antes de ejecutar nada, si el agente puede usar una herramienta o lanzar un comando sin preguntarte. Se comprueba sobre el texto del comando, no sobre lo que ese comando acabará haciendo.
Sustitución de comandos
El trozo de una orden de terminal escrito como $(...) o entre acentos graves. No es texto: es otra orden que la terminal ejecuta primero y cuyo resultado pega en su lugar. Por eso, al mirar la orden escrita, nadie sabe todavía sobre qué va a actuar.
Commit
Cada uno de los puntos de guardado de un repositorio. Un commit deja escrito qué cambió, quién lo cambió y cuándo, y se puede volver a él. Hasta que no se sube, vive solo en tu máquina.
Pull request
La propuesta de meter unos cambios en la rama principal de un repositorio para que alguien los revise antes de aceptarlos. Lleva un cuerpo escrito que explica qué se propone y por qué.
Mod
Un añadido que instalas en Claude Code y que puede intervenir en lo que hace la sesión: dibujar en pantalla, reaccionar a lo que ocurre y, si atiende la comprobación de permisos, decidir sobre una llamada a una herramienta. Se instala como un complemento, y por eso quién lo escribió importa tanto como lo que hace.
hiddenrows · proyecto personal de divulgación de Miguel Yepes Contenido divulgativo, puede contener errores · sin garantías · Aviso legal · Privacidad · llms.txt