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.
Usa Database Query para traducir lenguaje natural a SQL sobre una conexión configurada.

Requisitos previos

Requisitos

  • Especificación de la herramienta: { "name": "database_query", "type": "database_query_v1" }
  • tool_context: un contexto sql_database con connection_string

Solicitud y respuesta básicas

Este ejemplo valida el cuerpo de la petición y usa tool_choice: none para no conectar durante la validación.
Ejemplo de respuesta:
Para ejecutar, envía el mismo cuerpo a POST /messages y cambia tool_choice a { \"type\": \"auto\" }.

Bloques de respuesta

Zylon ejecuta esta herramienta en el servidor. La respuesta contiene un bloque server_tool_use con la llamada, seguido de un bloque server_tool_result con el resultado. El ID de la llamada empieza por srvtoolu_. No envíes un tool_result de vuelta para ella.
Error:
is_error es true cuando la herramienta falla, y content contiene el mensaje de error. Consulta Migración de 1.57 a 1.58 para ver la lista completa de bloques de herramientas de servidor.

Consejos

  • Usa un usuario de solo lectura.
  • Limita los esquemas (schemas) para acelerar la inspección.

Próximos pasos