Construcción de Arnés de Agente

¿Qué hace Construcción de Arnés de Agente?

Usa esta habilidad cuando estés mejorando cómo un agente planifica, llama a herramientas, se recupera de errores y converge hacia la finalización.

Modelo Central

La calidad de la salida del agente está limitada por:

1. Calidad del espacio de acción
2. Calidad de la observación
3. Calidad de la recuperación
4. Calidad del presupuesto de contexto

Diseño del Espacio de Acción

1. Usa nombres de herramientas estables y explícitos.
2. Mantén las entradas basadas en esquemas y estrechas.
3. Devuelve formas de salida deterministas.
4. Evita herramientas comodín a menos que el aislamiento sea imposible.

Reglas de Granularidad

• Usa micro-herramientas para operaciones de alto riesgo (despliegue, migración, permisos).
• Usa herramientas medianas para bucles comunes de edición/lectura/búsqueda.
• Usa macro-herramientas solo cuando la sobrecarga de ida y vuelta sea el costo dominante.

Diseño de Observaciones

Cada respuesta de herramienta debe incluir:

• status: éxito|advertencia|error
• summary: resultado de una línea
• next_actions: seguimientos procesables
• artifacts: rutas de archivo / IDs

Contrato de Recuperación de Errores

Para cada ruta de error, incluye:

• pista de causa raíz
• instrucción de reintento seguro
• condición de parada explícita

Presupuesto de Contexto

1. Mantén el prompt del sistema mínimo e invariable.
2. Mueve guías extensas a habilidades cargadas bajo demanda.
3. Prefiere referencias a archivos en lugar de incluir documentos largos en línea.
4. Compacta en los límites de fase, no en umbrales de tokens arbitrarios.

Guía de Patrones de Arquitectura

• ReAct: mejor para tareas exploratorias con ruta incierta.
• Llamada a funciones: mejor para flujos estructurados deterministas.
• Híbrido (recomendado): planificación ReAct + ejecución de herramientas tipadas.

Evaluación Comparativa

Rastrea:

• tasa de finalización
• reintentos por tarea
• pass@1 y pass@3
• costo por tarea exitosa

Anti-Patrones

• Demasiadas herramientas con semántica superpuesta.
• Salida de herramienta opaca sin pistas de recuperación.
• Salida solo de error sin pasos siguientes.
• Sobrecarga de contexto con referencias irrelevantes.