Saltar al contenido principal
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.