Agentes avanzados · Capítulo 9 de 10
Un harness de deep agent
Un deep agent planifica con una lista de pendientes, guarda notas en archivos virtuales, pasa partes de un trabajo a subagentes con un contexto nuevo y se detiene antes de las herramientas que nombres.
Objetivos
- Inicia el trabajo y mira cómo el agente escribe y actualiza su lista de pendientes.Pendiente
- Aprueba la escritura de las notas y mira cómo crece el árbol de archivos.Pendiente
- Ejecuta tres subagentes en paralelo y compara sus tamaños de contexto.Pendiente
- Aprueba la verificación.Pendiente
Paso 1 de 4: La lectura
Un harness para trabajos largos
Un harness es el código alrededor del bucle del modelo: el prompt, las herramientas y lo que ve cada llamada. El paquete de código abierto deepagents de LangChain es uno, construido sobre LangGraph. Su anuncio de 2025 nombró cuatro partes: un prompt detallado, una herramienta de planificación, subagentes y un sistema de archivos.
Pendientes y archivos
write_todos({ todos }) recibe la lista completa cada vez, cada elemento pending, in_progress o completed, y la guarda en state.todos. No hace nada más: la ventaja es que el modelo vuelve a leer su plan en cada llamada. Dos llamadas en un mismo turno se rechazan. Se activa al agregar todoListMiddleware() de LangChain a middleware.
Las herramientas de archivos (ls, read_file, write_file, edit_file, glob, grep) trabajan sobre state.files, un sistema de archivos virtual en el estado del grafo. Los subagentes pueden leer las notas que hay ahí, y estas sobreviven a un resumen de los mensajes antiguos.
Subagentes
task({ description, subagent_type }) inicia un subagente con un contexto nuevo: su propio system prompt y la descripción, ninguno de los mensajes de quien lo llama. Empieza con los archivos de quien lo llama, los archivos que escribe se fusionan de vuelta y solo su último mensaje regresa, como resultado de la herramienta. Las llamadas de un mismo turno se ejecutan en paralelo. Por defecto hay un subagente de uso general con las herramientas de quien lo llama.
Skills, memoria y aprobaciones
Un skill es una carpeta con un archivo SKILL.md. Con skills: ['/skills/'], el prompt lista el nombre y la descripción de cada skill, y el agente lee el archivo solo cuando una tarea lo necesita. La opción memory carga archivos AGENTS.md en el prompt. interruptOn, con un checkpointer, nombra herramientas que pausan la ejecución hasta que una persona aprueba, edita o rechaza cada llamada. Esta página se pausa en un punto de interrupción (interruptBefore), porque interrupt() necesita AsyncLocalStorage.
Menos andamiaje
Cada parte cuesta tokens en cada llamada. deepagents 1.12 (2026-07-29) hizo opcional la lista de pendientes y dejó vacío su system prompt genérico: los modelos actuales necesitan menos guía. La publicación de Anthropic sobre el diseño de harness (2026-03-24) coincide: con cada modelo nuevo, quita las partes que ya no necesita.
En este laboratorio
Un harness recreado escribe un informe sobre las quejas por reembolsos en Halden, una tienda ficticia. A diferencia de deepagents 1.16, activa la lista con todos: true, muestra los skills al investigador sin una lista de skills propia, conserva la antigua línea genérica del prompt y no tiene memoria AGENTS.md. El agente principal se pausa antes de write_file y task para que puedas seguirlo; en tu propio agente, pausa antes de las herramientas que cambian cosas fuera de él.
Paso 2 de 4: Pruébalo: Un trabajo de investigación, una parte a la vez
Un trabajo de investigación, una parte a la vez
Inicia el trabajo y mira la lista de pendientes, deja que el agente principal escriba sus notas, luego aprueba tres subagentes y compara sus tamaños de contexto.
Modo:RealRecreadoSimuladoReal: LangGraph.js 1.5.1 ejecuta el bucle en esta página, con su MemorySaver y el punto de interrupción interruptBefore. Recreado: el harness deepagents 1.16 reconstruido sobre LangGraph.js 1.5.1, con sus nombres de herramientas, valores por defecto y mensajes, porque el paquete real no se instala junto al LangSmith 0.11 de este sitio; la memoria AGENTS.md no está recreada, y los tokens se estiman como caracteres / 4. Simulado: las decisiones del modelo siguen un guion, y los tickets de Halden son ficticios.
Paso 3 de 4: Comprobación
Comprobación
const lead = createDeepAgent({
systemPrompt: 'You write briefs.',
subagents: [{
name: 'researcher',
description: 'Researches a cause.',
systemPrompt: 'Edit the note, then report.',
}],
});
// The lead's model asks for:
task({
subagent_type: 'researcher',
description:
'Late refunds: /notes/late-refund.md',
})Paso 4 de 4: Lo que ya puedes hacer
Lo que ya puedes hacer
- Activar la lista de pendientes de un deep agent agregando todoListMiddleware() a su middleware, y leer el plan en state.todos.
- Guardar notas y borradores en state.files con ls, read_file, write_file, edit_file, glob y grep.
- Pasar trabajo autónomo a subagentes con task, y usar los informes y archivos que vuelven.
- Pausar un deep agent antes de las herramientas elegidas con interruptOn y un checkpointer, y quitar el andamiaje que un modelo más nuevo ya no necesita.