Cargando

Envío de resultados de herramientas

Lección 267 min
Cargando

Después de que Claude solicita una llamada a herramienta, necesitas ejecutar la función y enviar los resultados de vuelta. Esto completa el flujo de trabajo de uso de herramientas al proporcionarle a Claude la información que solicitó.

Ejecutar la función de la herramienta

Cuando Claude responde con un bloque de uso de herramienta, extraes los parámetros de entrada y llamas a tu función. Así es como accedes a los parámetros de la herramienta:

python
# Accede al bloque de uso de herramientas
tool_use_block = response.content[1]

# Obtén los parámetros de entrada
input_params = tool_use_block.input

# Llama a tu función con los parámetros
result = get_current_datetime(**input_params)

El doble asterisco (**) descompone el diccionario en argumentos de palabra clave que tu función espera.

Bloque de resultado de herramienta

Después de ejecutar la herramienta, envías los resultados de vuelta a Claude usando un bloque de resultado de herramienta. Este bloque tiene varias propiedades importantes:

Ejemplo de JSON de resultado de herramienta con tipo "tool_result", contenido "12:47:13", is_error False y un tool_use_id coincidente.

  • tool_use_id - Debe coincidir con el ID del bloque de uso de herramienta original
  • content - La salida de tu función de herramienta, convertida a una cadena de texto
  • is_error - Se establece en true si ocurrió un error durante la ejecución

Manejo de múltiples llamadas a herramientas

Claude puede solicitar múltiples llamadas a herramientas en una sola respuesta. Por ejemplo, si un usuario pregunta "¿Cuánto es 10 + 10 y cuánto es 30 + 30?", Claude podría enviar dos bloques de uso de herramienta separados:

Claude envía bloques de uso de herramienta de calculadora ab3 para 10 + 10 y po9 para 30 + 30; los resultados regresan como salida de po9 60 y luego ab3 20.

Cada bloque de uso de herramienta obtiene un ID único, y debes hacer coincidir estos IDs al enviar los resultados de vuelta:

Claude devuelve usos de herramienta ab3 para 10 + 10 y po9 para 30 + 30; nuestro servidor responde con salida de po9 60, luego salida de ab3 20.

Este sistema de ID asegura que Claude pueda hacer coincidir correctamente cada resultado con su solicitud correspondiente, incluso si los resultados llegan en un orden diferente.

Envío de la solicitud de seguimiento

Tu solicitud de seguimiento a Claude debe incluir el historial completo de la conversación más el nuevo resultado de herramienta:

python
messages.append({
    "role": "user",
    "content": [{
        "type": "tool_result",
        "tool_use_id": response.content[1].id,
        "content": result,
        "is_error": False
    }]
})

El flujo de la conversación se ve así:

Nuestro servidor envía a Claude el esquema de herramienta, la pregunta "¿Cuál es la hora actual?", los bloques de uso de herramienta y resultado de herramienta.

Recuerda incluir el esquema de la herramienta en tu solicitud de seguimiento, aunque probablemente Claude no necesite llamar a las herramientas de nuevo. Claude necesita el esquema para entender las referencias a herramientas en el historial de la conversación.

Flujo de trabajo completo

Aquí está el proceso completo:

  1. El usuario hace una pregunta que requiere uso de herramientas
  2. Claude responde con un bloque de uso de herramienta
  3. Ejecutas la función de herramienta solicitada
  4. Envías una solicitud de seguimiento con el resultado de la herramienta
  5. Claude proporciona una respuesta final usando la salida de la herramienta

La solicitud final incluye tu historial completo de mensajes, el bloque de resultado de herramienta y el esquema de la herramienta. Claude entonces responde con un mensaje de texto regular que incorpora la información de la ejecución de tu herramienta.