Ingeniería de contexto: diseña lo que ve tu agente de IA

¿Qué es la ingeniería de contexto?

La ingeniería de contexto es la disciplina de diseñar el conjunto completo de información que recibe un modelo en cada paso de la ejecución de un agente. En el tiempo de ejecución de un agente, el contexto es todo lo que el modelo ve en un paso determinado, lo que incluye las instrucciones del sistema, las habilidades disponibles, las definiciones de las herramientas, el historial de la conversación y los resultados devueltos por las herramientas.

Se trata de una superficie mucho mayor que la de un simple prompt. Y es dinámica: cada llamada a una herramienta añade un resultado al contexto en el siguiente paso, por lo que el entorno de información cambia constantemente a medida que el agente trabaja. La ingeniería de contexto es la forma de mantener ese entorno enfocado, relevante y dentro del presupuesto, en lugar de dejar que se llene de ruido.

Qué contiene el contexto de un agente

• Instrucciones del sistema. La guía permanente sobre cómo debe comportarse el agente.
• Habilidades. Procedimientos reutilizables que el agente puede utilizar para tareas específicas, en lugar de incluir todos los manuales en el prompt del sistema.
• Definiciones de herramientas. Las herramientas, a menudo expuestas a través de MCP, que el agente tiene permitido llamar, junto con sus esquemas.
• Historial de la conversación. El diálogo en curso y los propios pasos intermedios del agente.
• Resultados de las herramientas. El resultado de cada llamada, que vuelve a entrar en el contexto y da forma al siguiente paso.

Ingeniería de contexto frente a ingeniería de prompts

Ambas están relacionadas pero operan en ámbitos diferentes, y confundirlas es la razón por la que algunos equipos se estancan. La ingeniería de prompts se pregunta "¿cómo redacto esta solicitud?". La ingeniería de contexto se pregunta "¿qué debe tener el modelo delante, en cada paso, para hacer bien este trabajo?".

Ninguna sustituye a la otra. Sigues redactando las instrucciones con cuidado, pero para un agente eso es solo una pequeña parte de un problema de diseño mucho mayor. A medida que las ventanas de contexto crecen, la tentación es volcarlo todo, y esa es precisamente la trampa que evita la ingeniería de contexto: más contexto no es mejor contexto, y una ventana sobrecargada degrada la capacidad de recuperación y aumenta los costes.

Técnicas que realmente marcan la diferencia

Unas pocas prácticas aportan la mayor parte del valor a la hora de diseñar el contexto para los agentes.

• Traslada los procedimientos a las habilidades, no al prompt del sistema. Todo lo que parezca un flujo de trabajo o un manual de procedimientos debe formar parte de una habilidad que el agente cargue cuando sea necesario; esto mantiene el contexto base optimizado. Carga de forma proactiva las directrices breves y siempre relevantes (guías de estilo, políticas de seguridad) y deja los procedimientos largos o esporádicos para cuando se requieran.
• Limita el alcance de las herramientas. Cuantas más herramientas expongas, más tokens consumirán sus definiciones y más probabilidades habrá de que el agente cometa errores. Proporciona al agente únicamente las herramientas que necesite para su función y nada más.
• Gestiona el historial de forma deliberada. Resume o trunca los turnos antiguos para que la ventana se mantenga centrada en lo que importa ahora, en lugar de arrastrar cada paso anterior palabra por palabra.
• Trata los resultados de las herramientas como contexto no fiable. Los resultados vuelven a entrar en el contexto del modelo en el siguiente paso, por lo que requieren la misma inspección que cualquier entrada, tanto por su relevancia como por su seguridad.

Cómo te ayuda TrueFoundry a diseñar el contexto

La ingeniería de contexto solo es sostenible si las piezas se gestionan de forma centralizada, en lugar de ensamblarse manualmente para cada agente. TrueFoundry te ofrece puntos de control para cada parte del contexto.

En el Agent Harness, configuras el contexto al crear el agente: el prompt del sistema, las habilidades incluidas y qué servidores MCP están disponibles. Esto convierte el contexto en una configuración explícita y revisable, en lugar de algo oculto en el código.

• Habilidades. Las habilidades provienen del Registro de Habilidades central, por lo que los procedimientos en el contexto de un agente están versionados, sujetos a control de acceso y reutilizados en lugar de copiados y pegados. Puedes precargar habilidades breves y siempre relevantes, y dejar las largas para cuando se necesiten; esta es la técnica fundamental de optimización del contexto convertida en una configuración. Consulta Habilidades de Claude para saber cómo funciona el formato de habilidades.
• Herramientas. La pasarela MCP decide a qué herramientas puede acceder un agente y permite restringir el acceso a herramientas individuales, de modo que las definiciones de herramientas en el contexto se limiten a lo que el agente realmente necesita.
• Seguridad en los resultados de las herramientas. Dado que los resultados de las herramientas vuelven a entrar en el contexto, Salvaguardas para agentes de IA inspecciónalos en el hook posterior a la herramienta en busca de inyecciones y datos confidenciales antes de que influyan en el siguiente paso.
• Observabilidad. Cada paso queda registrado, por lo que puedes ver exactamente qué había en el contexto cuando el agente tomó una decisión; esto es lo que convierte la ingeniería de contexto en un proceso iterativo en lugar de una cuestión de azar.

En la base de todo, el puerta de enlace de IA (AI Gateway) enruta cada llamada a través de más de 1000 modelos con un tiempo de procesamiento de apenas 3 a 4 ms, por lo que elegir el modelo más adecuado para cada paso es una cuestión de enrutamiento, no de reescritura. El resultado es que el contexto se convierte en algo que diseñas y controlas desde un único lugar, en lugar de ser un efecto secundario de cómo se haya programado cada agente.

Conclusión

La ingeniería de contexto supone pasar de redactar un prompt a diseñar todo lo que un modelo ve durante toda la ejecución de un agente. Si aciertas con las instrucciones, las habilidades, las herramientas, el historial y los resultados de las herramientas, el agente se mantendrá enfocado y será rentable; si te equivocas, no habrá ajuste de prompts que lo salve. TrueFoundry convierte esos elementos en una configuración gestionada mediante el Agent Harness, el Skills Registry, el MCP Gateway y un seguimiento completo, para que el contexto sea algo que tú diseñas y controlas, y no algo que simplemente te sucede.

Descubre cómo TrueFoundry te permite controlar el contexto de tus agentes desde un único panel de control. Reserve una demostraciónoempezar gratis.