Cómo diseñar herramientas para agentes LLM

Una herramienta es un manual para el modelo

Diseñar una herramienta para un agente es escribir su nombre, su descripción, sus parámetros y sus errores para que un modelo la use bien. Esas palabras son el único manual del modelo.

Una herramienta llamada do con cinco opciones sueltas se adivina. Una herramienta llamada read_file con una sola ruta se usa bien.

Al final de esta lección

Nota

Puedo escribir una herramienta que un modelo use bien, con un nombre claro, un límite dicho y un error útil.

Palabras clave

Palabra	Qué significa
Herramienta	una función que el agente puede pedir al arnés que ejecute
Descripción	las palabras que dicen al modelo cuándo usar una herramienta
Herramienta estrecha	una herramienta que hace un solo trabajo
Parámetro	una entrada con nombre de una herramienta
Ambigüedad	dos herramientas que parecen servir para una misma tarea
Error de herramienta	el texto que devuelve una herramienta cuando falla

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

Las herramientas estrechas ganan a las anchas

Una herramienta estrecha hace un solo trabajo y recibe pocos parámetros. Una herramienta ancha, como run_anything(options), obliga al modelo a inventar un minilenguaje, y suele equivocarse.

Da a cada trabajo su herramienta: read_file, write_file, list_files. Quédate en cuatro parámetros o menos. Una herramienta que necesita más suele ser dos herramientas.

Nombres y descripciones dicen cuándo no usarla

Un nombre es un verbo y un sustantivo: search_text, no helper. Una descripción dice qué hace la herramienta y también cuándo no usarla.

Dos herramientas que parecen servir para la misma tarea son una ambigüedad. Esa segunda frase las separa. Sin ella, el modelo elige al azar entre read_file y search_text, y lo descubres en una traza.

Fallos que hay que revisar

Fallo	Aspecto	Arreglo
Nombre vago	`do`, `helper`	Un verbo y un sustantivo
Descripción corta	`Hace cosas`	Decir qué lee o qué cambia
Sin límite	Ningún «no la uses»	Añadir para qué no sirve
Demasiados parámetros	Cinco o más	Dividirla en herramientas

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

Escribe los errores para el modelo

Un error de herramienta es la siguiente entrada que lee el modelo. Escríbelo, pues, para él: qué salió mal y qué hacer después.

Error: no hay ningún archivo en src/app.pyy. Llama a list_files y vuelve a intentarlo. dice al modelo cómo recuperarse. Un simple ENOENT no. En un rechazo, di que no reintente, o el modelo lo intentará una y otra vez.

Un error frecuente

Advertencia

Mucha gente escribe las palabras de una herramienta para sí misma y las deja cortas. El modelo no tiene nada más. Escribe la descripción como para un compañero que nunca ha visto el código.