Describir herramientas

Un agente de analítica dispone de dos herramientas: get_data y query. La primera lee una tabla; la segunda ejecuta SQL. Las dos descripciones tienen cuatro palabras. En producción, el modelo llama a query para leer una tabla entera, se encuentra con un timeout a los 30 segundos, vuelve a llamar a query con la misma consulta y después prueba get_data con un nombre de tabla inventado. Ninguna línea del bucle es defectuosa. El modelo hizo lo que cabía esperar de él: adivinar, por falta de información.

La descripción de una herramienta no es documentación, es la especificación que el modelo utiliza para decidir. Hace a la vez de firma de función, de docstring y de contrato de errores. Un esquema impreciso produce llamadas inválidas; un nombre ambiguo produce llamadas a la herramienta equivocada; un valor de retorno mal formado produce vueltas de bucle inútiles. Son las tres causas dominantes de deriva en un agente, muy por delante de la elección del modelo, y todas se corrigen en el archivo donde declara sus herramientas.

El esquema de una herramienta, completo

Esta es la forma completa de una declaración aprovechable. Compare la densidad de información con get_data.