Codified Context: Infrastructure for AI Agents in a Complex Codebase
Este artículo presenta una infraestructura de contexto codificado compuesta por una constitución de memoria activa, 19 agentes especializados y una base de conocimientos en memoria fría, diseñada para resolver el problema de la falta de memoria persistente en asistentes de codificación basados en LLM dentro de un sistema distribuido de C# de gran escala.
Artículo original bajo licencia CC BY 4.0 (http://creativecommons.org/licenses/by/4.0/). Esta es una explicación generada por IA del artículo a continuación. No ha sido escrita ni avalada por los autores. Para mayor precisión técnica, consulte el artículo original. Leer descargo de responsabilidad completo
Imagina que estás construyendo un rascacielos gigante (un programa de computadora muy complejo) y tienes un equipo de ayudantes muy inteligentes, pero con un problema grave: tienen amnesia.
Cada vez que los despiertas para trabajar, olvidan todo lo que hiciste ayer. No recuerdan las reglas de construcción, no saben qué materiales usaste antes y, lo peor de todo, cometen los mismos errores una y otra vez porque nadie les dijo "¡Oye, en este edificio no usamos cemento azul!".
Este paper describe cómo el autor resolvió este problema creando una "Infraestructura de Contexto Codificado". En lugar de intentar que la memoria de la IA sea perfecta (algo que aún no sabemos hacer), el autor construyó un sistema de bibliotecas y manuales que la IA consulta obligatoriamente antes de hacer cualquier cosa.
Aquí te explico cómo funciona, usando una analogía de una Gran Obra de Construcción:
1. El Problema: El Ayudante con Amnesia
Los asistentes de IA actuales (como los que escriben código) son como obreros geniales que saben de todo en el mundo, pero no conocen tu obra específica. Si les dices "construye una pared", lo harán, pero quizás la pinten de un color que no encaja con el resto, o usen un tipo de ladrillo que no soporta el peso.
Antes, los desarrolladores intentaban solucionar esto con un solo "papel de instrucciones" (un archivo de texto) que leían al empezar. Pero imagina que tu edificio tiene 100.000 líneas de código (como un rascacielos de 100 pisos). ¡Ese único papel de instrucciones se vuelve tan largo que el ayudante se abruma, se olvida de la mitad y empieza a alucinar!
2. La Solución: Un Sistema de Tres Niveles
El autor creó un sistema de tres capas, como si fuera una empresa de construcción muy organizada:
Nivel 1: La Constitución (La Memoria Caliente)
- Qué es: Un documento corto y esencial que siempre está en la mente del ayudante.
- Analogía: Es como el código de vestimenta y las reglas básicas de seguridad que todos los obreros deben llevar pegadas en su casco.
- Función: Dice cosas como: "Siempre usamos este tipo de tornillo", "Nunca pintamos de rojo" o "Si tocas este cable, avisa al jefe". Es lo que el ayudante siempre sabe, sin tener que buscarlo.
Nivel 2: Los Especialistas (Los Jefes de Obra)
- Qué es: 19 "agentes" o perfiles diferentes, cada uno experto en una cosa.
- Analogía: Imagina que en lugar de tener un solo obrero general, tienes un experto en electricidad, un experto en fontanería y un experto en diseño de interiores.
- Función: Cuando necesitas arreglar un enchufe, el sistema no le pregunta al fontanero. Automáticamente llama al "Agente Electricista". Este agente ya trae en su maleta (su memoria) todos los manuales específicos de electricidad de tu edificio, para no cometer errores tontos.
Nivel 3: La Base de Conocimiento (La Memoria Fría)
- Qué es: Una biblioteca de 34 documentos detallados sobre cada parte del edificio.
- Analogía: Es la biblioteca técnica de la obra. Nadie la lee todo el tiempo porque es demasiado grande, pero si el fontanero necesita saber cómo funciona la tubería principal, va a la biblioteca, busca el plano exacto y lo lee.
- Función: Contiene los detalles profundos: "Cómo funciona el sistema de riego", "La fórmula exacta para el hormigón", etc. Solo se consulta cuando es necesario.
3. ¿Cómo funciona en la práctica?
El sistema funciona como un buzón de sugerencias inteligente:
- Tú (el arquitecto humano) le das una orden: "Quiero cambiar la iluminación del salón".
- El sistema mira sus reglas (Nivel 1) y ve que tocar la luz requiere al "Agente Eléctrico" (Nivel 2).
- Llama al Agente Eléctrico. Este agente, antes de empezar, va a la biblioteca (Nivel 3) y busca los planos de iluminación de tu edificio.
- Ahora el agente tiene todo el contexto: las reglas generales, su experiencia específica y los planos detallados.
- ¡Hace el trabajo perfecto sin cometer errores!
4. Los Resultados (La Historia de Éxito)
El autor usó este sistema para construir un videojuego multijugador gigante (108.000 líneas de código) en solo 70 días, trabajando a tiempo parcial.
- Sin este sistema: El ayudante habría olvidado las reglas, creado inconsistencias y el proyecto habría fallado.
- Con este sistema: El ayudante mantuvo la coherencia. Por ejemplo, cuando hubo un error en cómo se guardaban los datos del juego, el sistema consultó el manual y evitó que se corrompieran los archivos de los jugadores.
En Resumen
La idea principal es: No intentes que la IA tenga una memoria perfecta; dale una biblioteca perfecta.
Trata la documentación no como un aburrido manual que nadie lee, sino como la infraestructura vital del proyecto. Si la IA tiene acceso fácil a las reglas, los expertos y los planos, puede construir cosas increíbles, incluso si el arquitecto humano no es un experto en programación (el autor es químico, ¡no programador!).
Es como pasar de darle instrucciones a un perro suelto, a darle un collar con un GPS y un mapa detallado: el perro (la IA) sigue siendo el mismo, pero ahora llega al destino sin perderse.
¿Ahogado en artículos de tu campo?
Recibe resúmenes diarios de los artículos más novedosos que coincidan con tus palabras clave de investigación — con resúmenes técnicos, en tu idioma.