NOTAS DE CAMPO / LDM ZARAGOZA / CALATAYUD · 2026
RESEARCH IA/PAPER 10

AGENTES · CODING · HARNESS

The Devil Is in the Interface: Evaluating How Tool Architecture Shapes Coding Agent Behavior

ImprescindibleLectura primaria completa

Con las mismas capacidades de fondo, cambiar la forma de exponer las herramientas cambia el comportamiento, el coste y la consistencia del agente.

AUTHORS / LABXiangzhe Xu, Hamidreza Saghir, Qianhui Wu y colaboradores; Purdue, Microsoft Research y University of Chicago
FECHA11 AGO 2026
LECTURALectura primaria completa
LECTURA DE 60 SEGUNDOS

Lo esencial antes de invertir más tiempo.

HALLAZGO

El estudio compara seis arquitecturas de herramientas sobre 11.700 trayectorias. Las interfaces estructuradas mejoran la consistencia hasta 4,7×; algunas configuraciones reducen pasos y tokens sin perder rendimiento.

EVIDENCIA DISPONIBLE

Sobre 11.700 trayectorias, las interfaces low-level estructuradas mejoran la consistencia hasta 4,7×; la búsqueda en lenguaje natural aumenta más de 11% el acceso a archivos relevantes y la interfaz Python mantiene un rendimiento similar con 41,6% menos pasos y 56,3% menos tokens.

Resultado con localizador exacto · 6 localizadores disponibles.
LÍMITE

La arquitectura óptima depende del entorno, de las herramientas disponibles y de cómo se define una tarea completada. No hay una interfaz universal.

SIGUIENTE PRUEBA

Pass@1, pass^5, pasos, tokens, precisión de archivos explorados y tasa de recuperación tras un error.

EN UNA FRASE

El estudio compara seis arquitecturas de herramientas sobre 11.700 trayectorias. Las interfaces estructuradas mejoran la consistencia hasta 4,7×; algunas configuraciones reducen pasos y tokens sin perder rendimiento.

SEÑALAgentes · Harness
EVIDENCIAResultado con localizador exacto
CONFIANZA EDITORIALAlta
RESULTADOS / PROCEDENCIA

Qué está reportado y qué conviene comprobar.

Hay localizadores exactos registrados.
RESULTADO REPORTADO

Sobre 11.700 trayectorias, las interfaces low-level estructuradas mejoran la consistencia hasta 4,7×; la búsqueda en lenguaje natural aumenta más de 11% el acceso a archivos relevantes y la interfaz Python mantiene un rendimiento similar con 41,6% menos pasos y 56,3% menos tokens.

hasta 4,7× consistencia; >11% acceso; -41,6% pasos; -56,3% tokens · baseline: arquitectura básica con solo Bash · contexto: Seis arquitecturas de herramientas, tres actores y tareas de reparación a nivel de repositorio

LECTURA DEL PAPER / SÍNTESIS EDITORIAL

Qué estudiaron y qué cambia.

La síntesis está separada de los resultados reportados y de las inferencias.

The Devil Is in the Interface parte de una pregunta sencilla pero importante: cuando un agente falla, ¿estamos culpando demasiado al modelo? Los autores separan dos cosas que normalmente aparecen mezcladas. Una es la capacidad de la herramienta —qué información y acciones puede ofrecer— y otra es su arquitectura: cómo se organiza, cómo se presenta y qué pasos obliga a dar al agente. Su tesis es que dos sistemas con capacidades parecidas pueden producir conductas distintas simplemente porque el camino de acceso es diferente.

Para estudiarlo construyen seis configuraciones de herramientas para resolver incidencias reales de repositorios: BashOnly como referencia; Atomic, con operaciones más estructuradas; NLSearch, con búsqueda en lenguaje natural; Python, donde el agente agrupa operaciones en código ejecutable; y dos formas ligeras de andamiaje cognitivo, HypoTrack y Scratchpad. Las prueban sobre 65 instancias de SWE-bench Live, con tres modelos actores —Qwen3Coder-30B, Kimi K2.5 y Claude Sonnet 4.5— y diez intentos independientes por combinación. En total analizan 11.700 trayectorias.

El resultado más interesante es que la arquitectura no cambia demasiado la tasa básica de tareas resueltas cuando las capacidades se mantienen similares, pero sí cambia propiedades que importan mucho en producción. Atomic mejora la consistencia entre intentos repetidos y es la única configuración con una mejora uniforme de pass^k para los tres actores; en Qwen3Coder-30B, por ejemplo, pass^5 pasa de 0,046 con BashOnly a 0,106 con Atomic. NLSearch hace que el agente explore más archivos y encuentre más contexto potencialmente relevante, aunque con menor precisión. Python mantiene un rendimiento parecido con menos pasos y tokens: el resumen del paper reporta un 41,6 % menos de pasos y un 56,3 % menos de tokens.

El paper también matiza la tentación de llamar ‘memoria’ o ‘razonamiento’ a cualquier caja adicional. En las formas ligeras que estudian, Scratchpad y HypoTrack apenas cambian el comportamiento del actor. Eso no demuestra que todo andamiaje sea inútil: demuestra que escribir texto intermedio, por sí solo y sin recuperación, nueva información ni una política de ejecución, puede no ser suficiente para modificar una trayectoria. La mejora aparece cuando la interfaz cambia de verdad la forma de buscar, editar, agrupar acciones o controlar errores.

Mi lectura es que el harness forma parte del producto y debe medirse como tal. No hay una interfaz universalmente ganadora: el efecto depende del actor, la tarea y de si priorizamos consistencia, exploración, coste o resolución. Además, el estudio se concentra en coding agents y en un entorno controlado; no prueba automáticamente que la misma configuración funcione igual en un agente financiero, industrial o doméstico. Lo que sí deja es una regla práctica: antes de cambiar de modelo, instrumentar la superficie que le permite observar, elegir herramientas y recuperarse.

DECISIÓN RÁPIDATratar el harness como una superficie medible: registrar llamadas, errores, decisiones de herramienta y coste por tarea antes de cambiar de modelo.
NO LO SOBREINTERPRETES

La arquitectura óptima depende del entorno, de las herramientas disponibles y de cómo se define una tarea completada. No hay una interfaz universal.

PROBLEMA
Solemos atribuir el resultado al modelo y olvidar que la API, la búsqueda, el formato de salida y el orden de las herramientas también forman parte de la inteligencia efectiva.
MÉTODO
Compara arquitecturas de herramientas para observar cuánto cambia la conducta de un agente cuando cambia la interfaz que le rodea, aunque el modelo de fondo permanezca igual.
TIPO DE EVIDENCIA
Evaluación amplia sobre trayectorias de coding agents; la comparación apunta a consistencia, pasos y coste, no solo a una respuesta final.
LÍMITE
La arquitectura óptima depende del entorno, de las herramientas disponibles y de cómo se define una tarea completada. No hay una interfaz universal.
FIGURA PRIMARIA / FIGURA 1The Devil Is in the Interface
Ver figura original ↗
Comparación entre ingeniería de software y diseño de herramientas para agentes

La figura del paper contrapone las propiedades no funcionales de la ingeniería de software con las de un diseño de herramientas para agentes.

PROCEDENCIA / LICENCIA

Xiangzhe Xu et al. · The Devil Is in the Interface · arXiv:2608.11386v1 · CC BY 4.0

Consultar licencia ↗
LECTURA EDITORIAL

Tratar el harness como una superficie medible: registrar llamadas, errores, decisiones de herramienta y coste por tarea antes de cambiar de modelo.

Figura reproducida desde la fuente primaria y enlazada a su localizador. La lectura editorial se mantiene separada del resultado reportado por los autores.
EVIDENCIA / Evaluación amplia sobre trayectorias de coding agents; la comparación apunta a consistencia, pasos y coste, no solo a una respuesta final.
FIELD NOTES / ANOTACIONES

La lectura también deja rastro.

Guarda una observación junto a la evidencia. Tú escribes aquí; los agentes pueden añadir notas por MCP y aparecerán identificados.

MEMORIA PRIVADAEntra para anotar este paper y conectarlo con otros.
Entrar con ChatGPT
LECTURA AMPLIADAMetodología, implicaciones y preguntas para volver al paper.+
LECTURA EN 90 SEGUNDOSLo que conviene llevarse antes de abrir el PDF.
QUÉ HACE

Compara arquitecturas de herramientas para observar cuánto cambia la conducta de un agente cuando cambia la interfaz que le rodea, aunque el modelo de fondo permanezca igual.

QUÉ APORTA

La unidad real de producto deja de ser modelo más prompt. Es modelo más herramientas más interfaz más memoria más políticas más recuperación. Esa composición se puede diseñar y medir.

QUÉ NO PRUEBA

La arquitectura óptima depende del entorno, de las herramientas disponibles y de cómo se define una tarea completada. No hay una interfaz universal.

Cómo lo llevaría a un proyecto

Tratar el harness como una superficie medible: registrar llamadas, errores, decisiones de herramienta y coste por tarea antes de cambiar de modelo.

Coding agentsIDE y devtoolsRPAAsistentes técnicosAgentes de datos

Preguntas que conviene probar

  • ¿Qué parte del rendimiento viene de la herramienta y cuál de la política de selección?
  • ¿Qué interfaz reduce errores sin ocultar incertidumbre?
PLANTILLA DE PRUEBA / INFERENCIA EDITORIAL

Si tuviera que convertirlo en una prueba mañana.

ENTRADA30 tareas de repositorio, BashOnly frente a Atomic y Python, el mismo modelo y diez semillas por tarea.
PREGUNTA¿Una interfaz estructurada mejora la repetibilidad sin reducir la capacidad del agente para explicar y recuperar sus fallos?
MÉTRICAPass@1, pass^5, pasos, tokens, precisión de archivos explorados y tasa de recuperación tras un error.
PARADAParar si Atomic no mejora al menos 10% relativo en pass^5 o aumenta más de 20% los tokens sin mejorar la resolución.

Mi lectura

El harness no es fontanería: es una superficie de producto con impacto medible.

Esta última frase es una inferencia editorial a partir del paper y de sus posibles implicaciones; no es una afirmación de los autores.