Cargando

Agregar múltiples herramientas

Lección 287 min
Cargando

Ahora que tenemos una herramienta funcionando, es hora de agregar las dos herramientas restantes para completar nuestro proyecto: add_duration_to_datetime y set_reminder. La buena noticia es que una vez que tienes la base lista, agregar nuevas herramientas es sencillo.

Se necesitan tres herramientas: obtener la fecha y hora actual, agregar duración a la fecha y hora, algo en lo que Claude no es perfecto, y configurar un recordatorio.

Funciones y esquemas preconstruidos

Para ahorrar tiempo, las implementaciones de ambas funciones adicionales ya están proporcionadas, junto con sus especificaciones de esquema JSON. Puedes encontrarlas en las celdas de código anteriores:

  • add_duration_to_datetime - Maneja la aritmética de fechas para varias unidades de tiempo
  • set_reminder - Crea recordatorios (actualmente solo imprime la salida, pero podría extenderse para integrarse con sistemas de recordatorios reales)

Celda de notebook que define add_duration_to_datetime, con ramas para unidades como "seconds", "days" y "months".

Cada función viene con un esquema JSON correspondiente que define los parámetros esperados y sus tipos.

Agregar herramientas a la conversación

El primer paso es incluir los nuevos esquemas de herramientas en tu función de conversación. En la función run_conversation, agrega los esquemas adicionales al array de herramientas:

python
tools=[
    get_current_datetime_schema,
    add_duration_to_datetime_schema,
    set_reminder_schema
]

La celda run_conversation pasa los tres esquemas anteriores al chat, luego itera hasta que la razón de detención no sea "tool_use".

Conectando las funciones de herramientas

A continuación, necesitas actualizar la función run_tool para manejar los nuevos nombres de herramientas. Agrega dos ramas condicionales adicionales:

python
def run_tool(tool_name, tool_input):
    if tool_name == "get_current_datetime":
        return get_current_datetime(**tool_input)
    elif tool_name == "set_reminder":
        return set_reminder(**tool_input)
    elif tool_name == "add_duration_to_datetime":
        return add_duration_to_datetime(**tool_input)
    else:
        raise Exception(f"Unknown tool name: {tool_name}")

Celda de notebook con la función run_tool mostrada arriba, seguida de una función run_tools que recopila partes toolUse.

Probando el sistema completo

Con todas las herramientas conectadas, ahora puedes probar flujos de trabajo complejos que requieren múltiples llamadas a herramientas. Por ejemplo, pedirle a Claude que "Configure un recordatorio para ir al médico. La cita es en 100 días" activará una secuencia de operaciones:

  1. Obtener la fecha de hoy usando get_current_datetime
  2. Agregar 100 días a esa fecha usando add_duration_to_datetime
  3. Crear el recordatorio usando set_reminder

Salida del notebook: Claude planifica los pasos, luego imprime el recordatorio "Go to the doctor appointment" para 2025-07-12T00:00:00.

Claude divide automáticamente la solicitud en pasos lógicos y explica su plan antes de ejecutar cada llamada a herramienta. La salida muestra el flujo de trabajo completo, incluyendo la fecha futura calculada y la confirmación de que se configuró el recordatorio.

Conclusión clave

Una vez que tienes la infraestructura fundamental de uso de herramientas en su lugar, agregar nuevas herramientas requiere solo dos pasos simples: incluir el esquema en tu array de herramientas y agregar un caso para manejar el nombre de la herramienta en tu función de enrutamiento. La configuración inicial puede parecer compleja, pero escalar a múltiples herramientas se vuelve muy manejable.