Cargando

Funciones de herramientas

Lección 225 min
Cargando

Crear herramientas para Claude requiere resolver varios desafíos que no son inmediatamente obvios. Cuando quieres que Claude configure recordatorios para fechas futuras, rápidamente descubres que, aunque Claude conoce la fecha actual, no siempre sabe la hora exacta, tiene dificultades con la aritmética compleja de fechas y no tiene una forma integrada de configurar realmente recordatorios.

En un chat, un usuario pide un recordatorio para una cita médica dentro de una semana a partir del jueves, un objetivo que requiere de 3 a 4 herramientas personalizadas.

La solución es crear herramientas personalizadas que manejen estas tareas específicas. Para un sistema de recordatorios, necesitarás tres herramientas separadas: una para obtener la fecha y hora actual, otra para sumar duraciones a fechas, y una tercera para configurar realmente el recordatorio.

Por qué esto es un desafío

Claude tiene algunas limitaciones cuando se trata de tareas basadas en el tiempo:

  • Claude podría conocer la fecha actual, pero no la hora exacta
  • Claude no siempre maneja bien la suma basada en el tiempo, especialmente cuando se trata de mirar muchos días hacia el futuro
  • Claude no sabe cómo configurar un recordatorio

Un usuario pregunta "Configura un recordatorio para mi cita médica. Es dentro de una semana a partir del jueves." y la IA responde "Bien, te lo recordaré".

Las herramientas que necesitas

Para resolver estos problemas, crearás tres herramientas dedicadas:

  • Obtener la fecha y hora actual - Claude necesita conocer la fecha y hora actual
  • Sumar duración a fecha y hora - Claude no es perfecto con la suma de fecha y hora
  • Configurar un recordatorio - Se necesita una forma de configurar un recordatorio

Las tres herramientas necesarias para un sistema de recordatorios y la razón de cada una, listadas arriba.

Cómo funcionan las funciones de herramientas

El sistema de herramientas sigue un flujo específico entre tu servidor y Claude. Escribes funciones que Claude puede llamar cuando necesita información adicional, y Claude recibe los resultados para ayudar a formular su respuesta.

Flujo de uso de herramientas marcado con el código para cada paso, en orden: esquema JSON, parte ToolUse, función de herramienta, parte ToolResult.

El proceso implica varios pasos: escribir la función de herramienta, crear una especificación de esquema JSON, llamar a Claude con ese esquema, ejecutar la herramienta cuando Claude la solicita y proporcionar los resultados de vuelta a Claude.

Ejemplo de función de herramienta get_weather: genera un ValueError si la ubicación está vacía, luego devuelve una respuesta de API del clima como JSON.

Escribir funciones de herramientas

Las funciones de herramientas son funciones simples de Python que se ejecutan cuando Claude decide que necesita información adicional para ayudar al usuario. Aquí te explicamos cómo escribirlas de manera efectiva:

Prácticas recomendadas

  • Usa argumentos bien nombrados y descriptivos (esto se vuelve importante más adelante)
  • Valida las entradas, generando un error si no pasan la validación
  • Devuelve errores significativos - Claude intentará llamar a tu función una segunda vez si recibe un error

Celdas de notebook que crean un cliente de boto3 para bedrock-runtime, y luego definen add_user_message, add_assistant_message y chat.

Creando tu primera herramienta

Comencemos con la herramienta más simple: obtener la fecha y hora actual. Esta función toma un parámetro de formato de fecha y devuelve la marca de tiempo actual:

python
from datetime import datetime, timedelta

def get_current_datetime(date_format="%Y-%m-%d %H:%M:%S"):
    return datetime.now().strftime(date_format)

Esta función es sencilla pero sigue los principios clave: tiene un nombre descriptivo, toma un parámetro bien nombrado con un valor predeterminado razonable, y devuelve exactamente lo que promete.

Especificación de esquema JSON

Una vez que tienes tu función, necesitas escribir un esquema JSON que la describa a Claude. Este esquema le dice a Claude qué argumentos requiere la función y le ayuda a entender cuándo y cómo usar la herramienta.

Celda de notebook llamando a get_current_datetime con el formato de fecha "lkajsflkajsfd", cuya salida es "lkajsflkajsfd".

El esquema JSON cumple dos propósitos: ayuda a Claude a entender qué argumentos requiere tu función, y no es solo un concepto de LLM - el esquema JSON se usa comúnmente para la validación de datos en muchos contextos de programación. Hay muchas herramientas en línea que te pueden ayudar a generar esquemas.

Prácticas recomendadas para esquemas

  • Explica qué hace la herramienta, cuándo usarla y qué devuelve
  • Apunta a 3 o 4 oraciones en tus descripciones
  • Proporciona descripciones detalladas para los parámetros

Con tu función de herramienta escrita y el esquema definido, estás listo para integrarla con Claude y comenzar a construir interacciones de IA más sofisticadas que puedan manejar tareas del mundo real, como configurar recordatorios.