Skip to main content
Próxima versión — Zylon 1.58Esta documentación se publica antes del lanzamiento para que puedas preparar tus integraciones de API. La imagen de la versión todavía no está disponible. Para instalaciones con 1.57, consulta la documentación de 1.57.
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.