Cargando

Envío de resultados de herramientas

Lección 2510 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ó.

Ejecución de 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
response.content[1].input

Esto te proporciona un diccionario de los argumentos que Claude quiere pasar a tu función. Dado que tu función espera argumentos de palabra clave en lugar de un diccionario, usas la sintaxis de desempaquetado de Python:

python
get_current_datetime(**response.content[1].input)

Celda del notebook ejecutando la llamada de desempaquetado mostrada arriba, que devuelve la cadena de hora "14:41:05".

Bloque de resultado de herramienta

Después de ejecutar la función de la herramienta, necesitas enviar los resultados de vuelta a Claude usando un bloque de resultado de herramienta. Este bloque va dentro de un mensaje de usuario e indica a Claude qué sucedió cuando ejecutaste la herramienta.

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

El bloque de resultado de herramienta tiene varias propiedades importantes:

  • tool_use_id - Debe coincidir con el id del bloque ToolUse al que corresponde este ToolResult
  • content - Salida de la ejecución de tu herramienta, serializada como una cadena
  • is_error - True si ocurrió un error

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 responder con dos bloques ToolUse 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 po9 60 luego ab3 20.

Cada llamada a herramienta obtiene un ID único, y debes hacer coincidir estos IDs al enviar los resultados de vuelta. Esto asegura que Claude sepa qué resultado corresponde a qué solicitud, incluso si los resultados llegan en un orden diferente.

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

Construcción 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. Aquí está la estructura:

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

El historial completo de mensajes ahora contiene:

  • Mensaje original del usuario
  • Mensaje del asistente con bloque de uso de herramienta
  • Mensaje del usuario con bloque de resultado de herramienta

Realización de la solicitud final

Al enviar la solicitud de seguimiento, debes seguir incluyendo el esquema de la herramienta aunque no esperes que Claude haga otra llamada a herramienta. Claude necesita el esquema para comprender las referencias a la herramienta en tu historial de conversación.

python
client.messages.create(
    model=model,
    max_tokens=1000,
    messages=messages,
    tools=[get_current_datetime_schema]
)

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

Claude entonces responderá con un mensaje final que incorpora los resultados de la herramienta en una respuesta natural para el usuario. El flujo de trabajo de uso de herramientas ahora está completo: has habilitado exitosamente a Claude para acceder a información en tiempo real a través de tu función personalizada.