Query Data Node
Caută într-o sursă de date și obține rezultatele corespunzătoare.
Prezentare generală
Nodul Query Data caută într-o sursă de date și returnează rezultatele corespunzătoare. Suportă două moduri de căutare — Semantic și Structurat — oferind flexibilitate între interogări în limbaj natural și filtrare precisă la nivel de coloană. Rezultatele pot fi returnate în mai multe formate de ieșire pentru integrare ușoară cu nodurile ulterioare.
Sursele de date includ Ubex Tables. Orice tabel creat în My Data este disponibil aici ca sursă de date. Puteți interoga tabelele integrate Ubex fără a avea nevoie de o bază de date externă. Consultați documentația My Data pentru a afla cum să creați tabele.
Configurare
| Câmp | Descriere | Obligatoriu |
|---|---|---|
Select Source |
Sursa de date împotriva căreia se face interogarea | Da |
Search Mode |
Comutare între căutarea Semantică sau Structurată | Da |
Select output format |
Cum sunt returnate rezultatele (Listă de rânduri, Rând unic, Dicționar cheie-valoare) | Da |
Output Variable |
Numele variabilei pentru stocarea rezultatelor | Da |
Moduri de căutare
Semantic
Caută în toate coloanele indexabile folosind potrivire semantică bazată pe IA. Ideal pentru interogări în limbaj natural unde doriți să găsiți rezultate după semnificație, nu după valori exacte.
| Câmp | Descriere | Obligatoriu |
|---|---|---|
Search Query |
Interogare în text liber. Suportă variabile prin butonul Insert Variable. | Da |
Opțiuni avansate (doar Semantic)
| Setare | Tip | Interval | Implicit | Descriere |
|---|---|---|---|---|
Number of Results |
Cursor | 1–20 | 5 | Numărul maxim de rezultate corespunzătoare de returnat |
Relevance Threshold |
Cursor | 0–1 | 0.7 | Scorul minim de similaritate pentru includere (0 = orice potrivire, 1 = potrivire exactă) |
Structurat
Interogați sursa de date cu control precis asupra coloanelor, filtrelor, sortării și paginării. Cel mai potrivit când cunoașteți forma exactă a datelor de care aveți nevoie.
| Câmp | Descriere | Obligatoriu |
|---|---|---|
Columns to Return |
Selectați coloanele de inclus în rezultate. Folosiți scurtăturile All sau None. | Da |
Filters |
Adăugați condiții pentru a restrânge rezultatele | Nu |
Sort By |
Ordonați rezultatele după una sau mai multe coloane | Nu |
Limit |
Numărul maxim de rânduri de returnat (implicit: 100) |
Nu |
Offset |
Numărul de rânduri de omis de la început (implicit: 0) |
Nu |
Selectare format de ieșire
Controlați cum sunt structurate rezultatele înainte de a fi transmise nodului următor.
| Format | Descriere |
|---|---|
List of Rows |
Returnează toate rezultatele corespunzătoare ca un array de obiecte (implicit) |
Single Row (First) |
Returnează doar primul rezultat corespunzător ca un singur obiect |
Key-Value Dictionary |
Returnează rezultatele ca o mapare cheie-valoare pentru acces direct la proprietăți |
Exemplu: Căutare semantică în baza de cunoștințe
Interogarea unei baze de cunoștințe cu întrebarea unui utilizator:
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
Apoi transmiteți {{searchResults}} unui nod Model pentru generarea răspunsului.
Exemplu: Interogare structurată de date
Obținerea unor coloane specifice cu filtrare și paginare:
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
Exemplu: Obținerea unui singur înregistrare
Obțineți doar primul rând corespunzător pentru o căutare rapidă:
Select Source: users
Mode: Structured
Columns to Return: email, name, role
Filters: email == {{input_email}}
Output Format: Single Row (First)
Output Variable: currentUser
Accesați câmpurile direct: {{currentUser.name}}, {{currentUser.role}}.
Exemplu: Dicționar cheie-valoare
Returnarea rezultatelor ca dicționar pentru acces direct la proprietăți:
Select Source: app_settings
Mode: Structured
Columns to Return: All
Output Format: Key-Value Dictionary
Output Variable: settings
Utilizarea variabilelor
Transmiteți interogări dinamice din nodurile anterioare:
{{user_input}}
{{extracted_keywords}}
{{model_generated_query}}
Folosiți butonul Insert Variable în modul Semantic pentru a explora și insera variabilele disponibile.
Bune practici
- Folosiți modul Semantic pentru interogări în limbaj natural și fluxuri de lucru RAG
- Folosiți modul Structurat când aveți nevoie de control precis asupra coloanelor, filtrelor și sortării
- Alegeți Single Row (First) când aveți nevoie de un singur rezultat pentru a evita datele inutile
- Folosiți Key-Value Dictionary când nodurile ulterioare au nevoie de acces direct la proprietăți
- Setați valori adecvate pentru Limit și Offset în modul Structurat pentru paginare
- Reduceți pragul de relevanță în modul Semantic dacă obțineți prea puține rezultate