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 Semantic Search cuando quieras recuperar información de artefactos ingeridos (documentos, notas, PDFs, HTML, etc.).

Requisitos previos

Requisitos

  • Especificación de la herramienta: { "name": "semantic_search", "type": "semantic_search_v1" }
  • tool_context: al menos un ingested_artifact con context_filter.

Solicitud y respuesta básicas

Este ejemplo valida una petición que habilita Semantic Search:
Ejemplo de respuesta:
Para ejecutar, envía el mismo cuerpo a POST /messages.

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.
Los bloques source son específicos de Zylon. Solo se devuelven cuando la extensión Zylon está activada. 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

  • Mantén tool_context acotado.
  • Si los resultados no son relevantes, ingesta texto más depurado.

Próximos pasos