Skip to main content
Las herramientas personalizadas permiten definir una interfaz (nombre + JSON Schema) y dejar que el asistente decida cuándo usarla. Cuando se usa, devuelve un bloque tool_use con input estructurado.

Requisitos previos

Requisitos

En la lista tools, incluye:
  • name: nombre único
  • description: qué hace la herramienta
  • inputSchema: JSON Schema de la entrada

Solicitud y respuesta básicas

Este ejemplo valida una herramienta de calculadora y fuerza su uso.
Ejemplo de respuesta:
Para ejecutar, envía el mismo cuerpo a POST /messages. Cuando el asistente devuelva un tool_use, ejecuta la herramienta y responde con un bloque tool_result.
Solo las herramientas personalizadas usan tool_use y tool_result. Las herramientas integradas se ejecutan en el servidor y devuelven bloques server_tool_use seguidos de su resultado; no envíes resultados de vuelta para ellas. Consulta Cómo se devuelven los resultados de las herramientas integradas.