Query Data Node
Buscar en una fuente de datos y obtener resultados coincidentes.
Descripción general
El Query Data Node busca en una fuente de datos y devuelve resultados coincidentes. Admite dos modos de búsqueda — Semántico y Estructurado — ofreciendo flexibilidad entre consultas en lenguaje natural y filtrado preciso a nivel de columna. Los resultados pueden devolverse en múltiples formatos de salida para facilitar la integración con los nodos posteriores.
Las fuentes de datos incluyen Ubex Tables. Cualquier tabla que cree en My Data está disponible aquí como fuente de datos. Puede consultar tablas integradas de Ubex sin necesidad de una base de datos externa. Consulte la documentación de My Data para saber cómo crear tablas.
Configuración
| Campo | Descripción | Obligatorio |
|---|---|---|
Select Source |
La fuente de datos contra la que se consulta | Sí |
Search Mode |
Alternar entre búsqueda Semántica o Estructurada | Sí |
Select output format |
Cómo se devuelven los resultados (Lista de filas, Fila única, Diccionario clave-valor) | Sí |
Output Variable |
Nombre de la variable para almacenar los resultados | Sí |
Modos de búsqueda
Semántico
Busca en todas las columnas indexables utilizando coincidencia semántica impulsada por IA. Ideal para consultas en lenguaje natural donde desea encontrar resultados por significado en lugar de valores exactos.
| Campo | Descripción | Obligatorio |
|---|---|---|
Search Query |
Entrada de consulta en texto libre. Admite variables mediante el botón Insert Variable. | Sí |
Opciones avanzadas (solo Semántico)
| Ajuste | Tipo | Rango | Predeterminado | Descripción |
|---|---|---|---|---|
Number of Results |
Control deslizante | 1–20 | 5 | Número máximo de resultados coincidentes a devolver |
Relevance Threshold |
Control deslizante | 0–1 | 0.7 | Puntuación mínima de similitud para inclusión (0 = cualquier coincidencia, 1 = coincidencia exacta) |
Estructurado
Consulte su fuente de datos con control preciso sobre columnas, filtros, ordenamiento y paginación. Ideal cuando conoce la forma exacta de los datos que necesita.
| Campo | Descripción | Obligatorio |
|---|---|---|
Columns to Return |
Seleccione qué columnas incluir en los resultados. Use los atajos All o None. | Sí |
Filters |
Agregar condiciones para acotar los resultados | No |
Sort By |
Ordenar resultados por una o más columnas | No |
Limit |
Número máximo de filas a devolver (predeterminado: 100) |
No |
Offset |
Número de filas a omitir desde el inicio (predeterminado: 0) |
No |
Seleccionar formato de salida
Controle cómo se estructuran los resultados antes de pasarlos al siguiente nodo.
| Formato | Descripción |
|---|---|
List of Rows |
Devuelve todos los resultados coincidentes como un array de objetos (predeterminado) |
Single Row (First) |
Devuelve solo el primer resultado coincidente como un objeto único |
Key-Value Dictionary |
Devuelve los resultados como un mapa clave-valor para acceso directo a propiedades |
Ejemplo: Búsqueda semántica en base de conocimiento
Consultar una base de conocimiento con la pregunta de un usuario:
Select Source: product-docs
Mode: Semantic
Search Query: {{user_question}}
Number of Results: 5
Relevance Threshold: 0.7
Output Format: List of Rows
Output Variable: searchResults
Luego pase {{searchResults}} a un nodo Model para la generación de respuestas.
Ejemplo: Consulta de datos estructurada
Obtener columnas específicas con filtrado y paginación:
Select Source: contact_rate_limits
Mode: Structured
Columns to Return: email, attempt_count, window_start
Filters: attempt_count > 5
Sort By: window_start DESC
Limit: 100
Offset: 0
Output Format: List of Rows
Output Variable: rateLimitData
Ejemplo: Obtener un solo registro
Obtener solo la primera fila coincidente para una consulta rápida:
Select Source: users
Mode: Structured
Columns to Return: email, name, role
Filters: email == {{input_email}}
Output Format: Single Row (First)
Output Variable: currentUser
Acceda directamente a los campos: {{currentUser.name}}, {{currentUser.role}}.
Ejemplo: Diccionario clave-valor
Devolver resultados como diccionario para acceso directo a propiedades:
Select Source: app_settings
Mode: Structured
Columns to Return: All
Output Format: Key-Value Dictionary
Output Variable: settings
Uso de variables
Pasar consultas dinámicas desde nodos anteriores:
{{user_input}}
{{extracted_keywords}}
{{model_generated_query}}
Use el botón Insert Variable en el modo Semántico para explorar e insertar variables disponibles.
Buenas prácticas
- Use el modo Semántico para consultas en lenguaje natural y flujos de trabajo RAG
- Use el modo Estructurado cuando necesite control preciso sobre columnas, filtros y ordenamiento
- Elija Single Row (First) cuando solo necesite un resultado para evitar datos innecesarios
- Use Key-Value Dictionary cuando los nodos posteriores necesiten acceso directo a propiedades
- Establezca valores apropiados de Limit y Offset en el modo Estructurado para la paginación
- Reduzca el umbral de relevancia en el modo Semántico si obtiene muy pocos resultados