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 herramientas, se recupera de errores y converge hacia la finalización.

Modelo Central

La calidad del resultado de un 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 específicas.
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 el costo de ida y vuelta sea el 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

Gestión del Presupuesto de Contexto

1. Mantén el mensaje del sistema mínimo e invariante.
2. Mueve guías extensas a habilidades cargadas bajo demanda.
3. Prefiere referencias a archivos en lugar de incluir documentos largos.
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.
• Function-calling: mejor para flujos deterministas estructurados.
• Híbrido (recomendado): planificación ReAct + ejecución de herramientas con tipo.

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 próximos pasos.
• Sobrecarga de contexto con referencias irrelevantes.