Cargando

Envío de resultados de herramientas

Lección 267 min
Cargando

Ahora estamos en el paso final del flujo de trabajo de uso de herramientas. Después de ejecutar nuestras herramientas y obtener los resultados, necesitamos enviar todo de vuelta a Claude para que pueda proporcionar una respuesta completa al usuario.

Nuestro servidor envía a Claude "¿Qué hora es?", el texto del asistente y la parte de uso de herramienta, luego un mensaje de usuario con el resultado de la herramienta.

El proceso es sencillo: tomamos todas las partes de resultado de herramienta que generamos, las empaquetamos en un mensaje de usuario y enviamos todo el historial de la conversación de vuelta a Claude junto con los esquemas originales de las herramientas.

Agregar el mensaje del asistente

Primero, necesitamos asegurarnos de que nuestro historial de conversación esté completo. Después de la respuesta inicial de Claude con la solicitud de uso de herramienta, necesitamos agregar esa respuesta a nuestro historial de mensajes usando add_assistant_message().

El mensaje del asistente, que contiene una parte de texto y una parte toolUse, resaltado en el historial que nuestro servidor envía a Claude.

Esto asegura que tengamos el flujo de conversación completo: pregunta del usuario → solicitud de herramienta del asistente → resultados de la herramienta → respuesta final del asistente.

Ejecutar herramientas y crear resultados de herramientas

La función run_tools() procesa todas las solicitudes de uso de herramienta de la respuesta de Claude y crea partes de resultado de herramienta correctamente formateadas. Cada resultado de herramienta incluye:

  • El ID de uso de herramienta (que coincide con la solicitud original)
  • La salida real de la ejecución de la herramienta
  • Un estado que indica éxito o error

Código del notebook llamando a run_tool en un bloque try y colocando json.dumps de la salida, o el texto del error, en cada toolResult.

La función maneja tanto las ejecuciones exitosas de herramientas como los errores de forma adecuada, envolviendo todo en la estructura JSON correcta que Claude espera.

Agregar resultados de herramientas a la conversación

Una vez que tenemos nuestros resultados de herramientas, los agregamos a la conversación usando add_user_message():

python
add_user_message(messages, run_tools(parts))

Esto crea un mensaje de usuario que contiene todas las partes de resultado de herramienta. La conversación ahora tiene el ir y venir completo necesario para que Claude proporcione una respuesta final.

La lista de mensajes impresa tiene tres mensajes, terminando en un resultado de herramienta de usuario "2025-04-03 12:54:00" con estado "success".

Llamada final a Claude

El último paso es enviar todo de vuelta a Claude. Esto requiere dos elementos importantes:

  • El historial de mensajes completo (usuario → asistente → usuario)
  • Los esquemas originales de las herramientas
python
text, parts = chat(messages, tools=[get_current_datetime_schema])

Incluir los esquemas de las herramientas es crucial. Sin ellos, Claude estaría confundido acerca de las referencias a herramientas en el historial de la conversación y no entendería qué hace realmente get_current_datetime.

La lista de mensajes termina con el resultado de herramienta "2025-04-03 12:54:00" y estado "success", luego la celda llama a chat nuevamente.

Éxito

Cuando todo funciona correctamente, Claude recibe los resultados de las herramientas y puede proporcionar una respuesta completa e informada. En nuestro ejemplo, Claude recuperó con éxito la hora actual y la formateó en una respuesta natural: "La fecha y hora actual es 2025-04-03, 12:54:00."

Esto demuestra que nuestra integración de herramientas está funcionando correctamente. Aunque Claude conoce la fecha actual, no tiene acceso a información en tiempo real como la hora exacta actual, que es precisamente lo que proporcionó nuestra herramienta.

El ciclo completo de uso de herramientas ahora está funcionando: Claude solicita una herramienta, nosotros la ejecutamos, devolvemos los resultados, y Claude incorpora esa información en su respuesta final al usuario.