← Todas las guías
Agentes y automatización

Diseñar herramientas que un agente sepa usar

Un agente es tan bueno como sus herramientas. El proceso y los cinco principios para diseñarlas, con ejemplos concretos.

3 min de lecturaRevisada en octubre de 20262 fuentes

Las herramientas son la interfaz del agente

Las definiciones de herramientas merecen el mismo cuidado que el prompt principal. Igual que diseñas una pantalla para una persona, diseñas una herramienta para un modelo: con nombres claros, documentación y pruebas. Lo llaman interfaz agente-ordenador.

El proceso: prototipo, evaluación y mejora

  1. Prototipo rápido. Monta una primera versión y pruébala tú mismo, por ejemplo como servidor MCP conectado a Claude.
  2. Evaluación con tareas reales. Crea tareas basadas en datos y servicios reales, no en entornos de juguete; las buenas pueden requerir decenas de llamadas. Cada tarea necesita un resultado comprobable.
  3. Análisis. Lee las transcripciones completas. Muchas llamadas redundantes suelen indicar problemas de paginación; muchos errores de parámetros, descripciones confusas.
  4. Mejora con el propio agente. Pega las transcripciones en un agente de código y pídele que reescriba herramientas y descripciones. Comprueba la mejora con un conjunto de pruebas que no haya visto.

Los cinco principios

1. Elige bien qué herramientas crear

No te limites a envolver cada punto de tu API. El contexto del agente es limitado, así que necesita herramientas que devuelvan solo lo importante. Mejor una herramienta de búsqueda que una que lista todo. Y mejor una herramienta que haga una operación completa, como "agendar reunión" (busca disponibilidad y reserva), que tres que el agente tenga que coordinar.

2. Agrúpalas con nombres claros

Con muchas herramientas, usa prefijos por servicio y recurso para marcar límites. Elegir prefijo o sufijo afecta al rendimiento y que depende del modelo: pruébalo.

3. Devuelve información con significado

Devuelve nombres y descripciones, no identificadores técnicos crípticos. Cuando el agente necesite identificadores para encadenar llamadas, ofrece un parámetro de formato con respuesta concisa o detallada. En un ejemplo publicado, la respuesta concisa usaba un tercio de los tokens.

4. Cuida el consumo de tokens

Para resultados grandes, usa paginación, filtros y truncado con valores por defecto sensatos. Si truncas, dile al agente cómo afinar la búsqueda. Y escribe mensajes de error que expliquen cómo corregir, con un ejemplo de entrada válida, en lugar de códigos opacos.

5. Redacta las descripciones como para un compañero nuevo

Las descripciones entran en el contexto del agente y guían su comportamiento. Explica formatos de consulta, términos del negocio y relaciones entre recursos. Usa nombres de parámetros sin ambigüedad: id_cliente en lugar de cliente. Pequeños ajustes en las descripciones produjeron mejoras grandes en pruebas de programación.

Diseña para que equivocarse sea difícil

A esto se le llama "a prueba de errores". Su ejemplo: un agente se equivocaba con rutas de archivo relativas tras cambiar de carpeta. La solución no fue explicarlo mejor, sino exigir rutas absolutas. El error desapareció.

Ejemplo de descripción de herramientanombre: crm_buscar_cliente descripción: Busca clientes en el CRM por nombre, CIF o correo. Úsala antes de cualquier acción sobre un cliente para obtener su id_cliente. Devuelve como máximo 10 resultados ordenados por coincidencia. Si no hay resultados, prueba con una parte del nombre o con el CIF sin letra. parámetros: consulta (texto, obligatorio): nombre, CIF o correo. Ejemplo: "Talleres Ruiz" o "B12345678". formato (opcional): "conciso" (nombre, ciudad, id_cliente) o "detallado" (añade contactos y últimos pedidos). Por defecto, conciso.

Qué medir

Precisión de las tareas, tiempo de ejecución, número de llamadas, tokens consumidos y errores de herramienta. Pide además al agente que explique su razonamiento antes de cada llamada: eso mejora el rendimiento y te da pistas para corregir.

Fuentes

Contenido redactado por Esclusa a partir de la documentación oficial citada. Los modelos, precios y funciones cambian a menudo: comprueba la fuente antes de tomar decisiones.

@esclusa.ia