Temario · lección 64 de 74
1Por qué fallan los agentes
2Qué es un harness
3Patrones de agentes
4Herramientas
5Ingeniería de contexto
6El repositorio como memoria
7Tareas largas
8Alcance y “hecho” de verdad
9Observabilidad y estado limpio
10Loops y grafos
11Harness reales
12Proyecto final
- Proyecto 1, solo prompt contra harness mínimo
- Proyecto 2, un workspace legible
- Proyecto 3, continuidad entre sesiones
- Proyecto 4, feedback de runtime e indexado
- Proyecto 5, que el agente verifique su trabajo
- Proyecto 6, el harness completo (capstone)
- Proyecto 7, tu primer loop automático
- Proyecto 8, dibuja tu flujo como un grafo
- Checklist final y plantillas
Elegir un harness en VS Code
En VS Code el harness, el modelo, el rol del agente y el entorno de ejecución son cuatro decisiones distintas. Confundirlas es la causa de casi todos los líos al elegir.
«Elegí Claude y sigo en Copilot»
Un compañero abre VS Code, selecciona un modelo de Claude y se sorprende: «sigo en el harness de Copilot». No es un fallo. Elegir modelo y elegir harness son decisiones diferentes. VS Code admite varios harness (Copilot, Anthropic Claude y OpenAI Codex), y entender qué cambia cada elección ahorra confusión.
Primero, recuerda la definición: el harness es la capa de software que ejecuta la sesión del agente. Conecta el modelo con el contexto y las herramientas, coordina el bucle y mantiene el estado. El modelo decide qué pedir; el harness lo convierte en un flujo con permisos y seguimiento. Si quieres repasar un turno completo: un turno paso a paso.
Cuatro cosas que no son lo mismo
| Concepto | Qué decide | ¿Cambia el harness? |
|---|---|---|
| Acceso al modelo | Qué cuenta, suscripción o clave da acceso y cómo se factura | No |
| Modelo de lenguaje | Cómo razona y responde | No: el mismo modelo puede estar en varios harness |
| Rol del agente | Instrucciones y herramientas de la tarea (Agent, Plan, Ask, personalizados) | No: moldea la tarea dentro del harness |
| Entorno de ejecución | Dónde corren las herramientas y se cambia el código | No: el entorno no es el harness |
Una suscripción de Copilot puede darte acceso a modelos de varios fabricantes, pero iniciar sesión no habilita todos los harness. Cada harness decide qué modelos y vías de acceso admite. Tu organización también puede limitar cosas: con la configuración gestionada de empresa, las integraciones de Claude y Codex quedan desactivadas.
Qué cambia de verdad al elegir un harness
Elegir harness define la implementación del agente, y con ella:
- Herramientas y capacidades: las integradas, las de extensiones, las de MCP y cómo se enrutan las llamadas.
- Opciones de modelo.
- Flujos de trabajo: comandos, personalizaciones y funciones de sesión propias de cada proveedor.
- Permisos: qué modos de aprobación hay.
No decide por sí solo dónde corre el modelo ni si los cambios van a una carpeta o a un worktree.
Session Target: dos nombres traicioneros
El control Session Target mezcla harness y destino de ejecución:
- Local es el nombre de un harness, no la única forma de trabajar en tu máquina. Otros harness también usan archivos locales.
- Cloud es un entorno de ejecución, no un harness. Usa el harness de Copilot en un entorno gestionado, aunque elijas un modelo de otro proveedor.
Entornos y aislamiento
El entorno es donde se ejecutan las herramientas y se modifica el código:
- Tu máquina: carpeta local o worktree, con acceso a resultados de tests y terminal.
- Un host conectado (SSH, Tunnel, WSL): el harness corre junto al código.
- Dev Container: las herramientas corren dentro del contenedor del proyecto, con sus dependencias.
- Nube: un entorno gestionado, no tu workspace local.
Para el aislamiento del código, el aislamiento por carpeta aplica los cambios directamente en tu workspace (con tus cambios sin confirmar); el de worktree da a la sesión una copia separada de Git basada en lo confirmado. Los Dev Containers trabajan en el workspace del contenedor y no admiten worktree nuevo.
Seleccionas un modelo de Claude dentro del harness de Copilot. ¿Qué harness estás usando?
Fuentes: Microsoft/VS Code, Understand agent harnesses (sources/web/vscode.md)