Cargando

Introducción al uso de herramientas

Lección 212 min
Cargando

Las herramientas permiten que Claude acceda a información del mundo exterior, resolviendo una de sus limitaciones clave. Por defecto, Claude solo tiene acceso a la información con la que fue entrenado, lo que significa que no puede proporcionar información actual como el clima de hoy o noticias recientes.

Una aplicación de chat le pregunta a Claude sobre el clima en San Francisco, y Claude responde que no tiene información actualizada sobre el clima.

Cuando un usuario pregunta "¿Cuál es el clima en San Francisco, California?" Claude normalmente responderá con "Lo siento, pero no tengo acceso a información actualizada sobre el clima." Las herramientas solucionan este problema creando un puente entre Claude y fuentes de datos externas.

Cómo funciona el uso de herramientas

El proceso de uso de herramientas sigue un flujo específico que implica múltiples comunicaciones de ida y vuelta entre tu servidor y Claude:

Diagrama de los cuatro mensajes intercambiados entre nuestro servidor y Claude durante el uso de herramientas, descrito paso a paso a continuación.

  1. Solicitud inicial: Envías a Claude una pregunta junto con instrucciones sobre cómo obtener datos adicionales
  2. Solicitud de herramienta: Claude analiza la pregunta y solicita los datos externos específicos que necesita
  3. Recuperación de datos: Tu servidor ejecuta código para obtener la información solicitada
  4. Respuesta final: Claude usa los datos externos para proporcionar una respuesta completa e informada

Ejemplo del clima en la práctica

Así es como funciona el flujo de uso de herramientas para una consulta del clima:

Diagrama de los cuatro mensajes entre nuestro servidor y Claude para una consulta del clima, descrito paso a paso a continuación.

Cuando un usuario pregunta sobre el clima, incluyes detalles sobre cómo recuperar los datos actuales del clima en tu solicitud inicial a Claude. Claude reconoce que necesita información actual del clima y le pide a tu servidor que la obtenga. Tu servidor llama a una API del clima, recupera los datos en vivo y los envía de vuelta a Claude. Finalmente, Claude combina la pregunta original con los datos actualizados del clima para proporcionar una respuesta precisa y actual.

Desafíos de implementación

El uso de herramientas puede sentirse confuso porque existe una desconexión entre el flujo lógico y la forma en que realmente escribes el código. La implementación no sigue el mismo orden que los pasos conceptuales:

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.

En la práctica, a menudo necesitas:

  • Escribir primero la función de la herramienta
  • Crear una especificación de esquema JSON
  • Manejar las partes ToolUse y ToolResult
  • Incluir el esquema con tu solicitud

Este ir y venir entre diferentes partes de la implementación es la razón por la que el uso de herramientas inicialmente parece complejo. La clave es entender que cada paso del flujo lógico requiere componentes de código específicos que construirás en un orden diferente al que se ejecutan.

En los siguientes videos, implementaremos el uso de herramientas paso a paso, haciendo referencia frecuente a este diagrama de flujo para hacer un seguimiento de qué pieza estamos construyendo actualmente.