Datele mele

Ce trebuie să știe agenții, workflow-urile și aplicațiile tale web? Totul stă în My Data: tabele, fișiere încărcate, site-uri web, text și bucket-uri de fișiere. Tot ce construiești în Studio poate lucra pe baza acestor date și nu ai nevoie de o bază de date externă.

Prezentare generală

Pagina My Data este centrul tuturor datelor din workspace. Creează tabele care funcționează ca baze de date integrate pentru utilizatori, produse, comenzi sau orice alte date structurate. Încarcă PDF-uri, preia conținutul unui site web sau lipește text, ca agenții tăi să poată răspunde pe baza lor. Configurează bucket-uri în care să stochezi fișiere.

Meniul din stânga îți listează Collections (colecțiile). All Sources arată tot; apasă + lângă Collections ca să adaugi una.

Când workspace-ul nu are încă date, pagina afișează Add data și cinci moduri de a începe:

Opțiune	Ce creează
Create a table	Rânduri și coloane pe care workflow-urile tale le pot citi și scrie
Upload files	Fișiere PDF pe care să le citească agenții tăi
Add a website	Pagini dintr-un site web, preluate ca text
Add text	Text pe care îl lipești direct
Create a bucket	Stocare de fișiere pentru workflow-uri, publică sau privată

Tabelele create de Qira și Vira în timp ce construiesc o aplicație web apar tot aici, așa că le poți vedea și edita rândurile.

Fiecare sursă de date apare ca un card care afișează:

Câmp	Descriere
Iconiță	Tipul sursei de date (tabel, document, text, web)
Nume	Numele pe care l-ai dat sursei de date
Descriere	Descriere opțională (afișată sub nume)
Insignă de status	Starea curentă – Ready (verde) sau Busy (portocaliu, în timpul indexării sau procesării)
Data creării	Când a fost creată sursa de date

Apasă pe iconița de roată de pe orice card ca să-i deschizi setările. Apasă Add data ca să adaugi o sursă de date nouă.

Tipuri de surse de date

Tip	Afișat ca	Descriere
PDF Files	Upload files	Încarcă documente PDF pentru extragerea textului și indexare pe chunk-uri
Scrape Website	Add a website	Extrage automat conținut de pe pagini web
Raw Text	Add text	Lipește sau scrie direct conținut text
Table	Create a table	Creează date structurate cu coloane și rânduri
Bucket	Create a bucket	Stochează fișierele pe care workflow-urile le încarcă și le servesc, public sau privat

Fiecare tip are propriul flux de creare și propriile opțiuni de configurare.

PDF Files

Încarcă documente PDF ca să le extragi conținutul text și să-l faci căutabil prin interogări RAG.

Crearea unei surse de date PDF

Apasă Add data → Upload files
Introdu un Nume pentru sursa de date
Trage și plasează fișiere PDF în zona de încărcare sau apasă pe ea ca să le alegi (limită de 5 fișiere, 10 MB în total)

Setări avansate

Extinde Advanced Settings ca să configurezi modul în care textul PDF este împărțit în chunk-uri pentru indexare.

Strategia de Chunk

Strategie	Descriere
Fixed Size	Împarte textul după un număr fix de caractere. Simplu și previzibil.
Sentence	Împarte la limitele propozițiilor. Păstrează propozițiile intacte pentru un context mai bun. Selectat implicit.
Paragraph	Împarte la întreruperile de paragraf. Ideal pentru documente cu structură clară de paragrafe.
Semantic	Împărțire semantică bazată pe IA. Grupează automat conținutul înrudit.

Dimensiunea Chunk-ului și suprapunerea

Setare	Descriere
Chunk Size	Dimensiunea țintă a fiecărui chunk. Opțiuni: 500, 1000, 1500, 2000 tokens. Implicit este 1000 tokens.
Chunk Overlap	Câți tokens se suprapun între chunk-uri consecutive. Opțiuni: 0, 100, 200, 300 tokens. Implicit este 200 tokens.

Suprapunerea asigură că nu se pierde context la limitele chunk-urilor. O suprapunere de 200 de tokens înseamnă că sfârșitul unui chunk și începutul următorului au în comun 200 de tokens de text.

Apasă Create Data Source ca să încarci și să procesezi fișierele. Statusul va afișa Busy în timpul indexării, apoi va trece la Ready când procesul este complet.

Scrape Website

Extrage conținut de pe pagini web și indexează-l ca sursă de date.

Crearea unei surse de date Web Scraper

Apasă Add data → Add a website
Introdu un Nume pentru sursa de date
Introdu URL-ul site-ului web (de ex., https://example.com)

Modul de crawling

Alege cât de mult din site-ul web vrei să preiei:

Mod	Descriere
Single page only	Face scraping doar pe URL-ul exact pe care l-ai dat. Ideal pentru o pagină sau un articol anume. Selectat implicit.
Crawl linked pages	Urmează link-urile de pe pagină și face scraping pe până la 10 pagini secundare. Bun pentru site-uri mici sau secțiuni de documentație.
Use sitemap.xml	Descoperă pagini din sitemap-ul site-ului. Ideal pentru scraping-ul sistematic al unui site întreg.

Setări avansate

Extinde Advanced Settings ca să configurezi strategia de chunk, dimensiunea chunk-ului și suprapunerea chunk-urilor. Opțiunile sunt identice cu setările sursei de date PDF descrise mai sus.

Apasă Create Data Source ca să pornești scraping-ul. Statusul va afișa Busy în timp ce conținutul este preluat și indexat.

Raw Text

Lipește sau scrie conținut text direct într-o sursă de date – fără să fie nevoie să încarci fișiere.

Crearea unei surse de date text

Apasă Add data → Add text
Introdu un Nume pentru sursa de date
Scrie sau lipește conținutul în câmpul Raw Text

E util pentru baze de cunoștințe rapide, conținut FAQ, descrieri de produse sau orice text pe care vrei ca workflow-urile să-l interogheze prin RAG fără să ai nevoie de un fișier.

Setări avansate

Extinde Advanced Settings ca să configurezi strategia de chunk, dimensiunea chunk-ului și suprapunerea chunk-urilor. Opțiunile sunt identice cu setările sursei de date PDF descrise mai sus.

Apasă Create Data Source ca să salvezi și să indexezi textul.

Table

Creează date structurate cu coloane și rânduri definite – similar cu un spreadsheet sau un tabel de bază de date.

Crearea unui tabel

Crearea tabelului urmează un asistent în trei pași: Template → Details → Schema.

Pasul 1: Template

Alege un șablon de pornire sau începe de la zero:

Template	Descriere	Coloane implicite
Contacts	Stochează lead-uri, clienți sau membri ai echipei	Name, Email, Phone
Products	Urmărește inventarul, prețurile și stocul	Product Name, SKU, Price
Tasks	Gestionează proiecte și sarcini	Title, Description, Status
Feedback	Colectează feedback și recenzii	Title, Feedback, Rating
Blank Table	Începe de la zero și definește-ți propriile coloane	-
Import from CSV	Încarcă un fișier CSV, iar schema este detectată automat	Detectate automat din fișier

Pasul 2: Details

Câmp	Descriere
Table Name	Obligatoriu. Numele folosit pentru a identifica acest tabel în workflow-uri și interogări.
Description	Opțional. O notă despre scopul tabelului.

Apasă Continue → ca să continui.

Pasul 3: Schema

Definește coloanele tabelului. Fiecare coloană are:

Proprietate	Descriere
Column name	Numele câmpului (de ex., „email”, „status”, „created_at”)
Type	Tipul de date – Text (implicit), Number, Boolean, Email sau Date
Required	Dacă coloana trebuie să aibă o valoare la inserarea rândurilor
Searchable	Dacă coloana este inclusă în interogările de căutare
Filterable	Dacă coloana poate fi folosită ca filtru în nodurile Query Data

Apasă + Add Column ca să adaugi mai multe coloane. Folosește butoanele cu săgeți ca să reordonezi coloanele.

Setări

Setare	Descriere
Enable RAG	Când este bifat, rândurile tabelului sunt încorporate pentru căutare semantică. Asta îți permite să folosești tabelul ca sursă de date RAG în nodurile Model. Activat implicit.
Primary column	Coloana folosită ca identificator principal pentru fiecare rând. Setat implicit pe Auto (first).

Apasă Create Table ca să finalizezi.

Bucket

Un bucket este stocare de fișiere pentru workflow-urile și aplicațiile tale web: fotografii de produse, documente încărcate, PDF-uri generate, atașamente.

Crearea unui bucket

Apasă Add data → Create a bucket
Introdu un Nume
Alege dacă este public (fișierele pot fi deschise de oricine are linkul lor, de exemplu imaginile de pe site-ul tău) sau private (privat: fișierele sunt accesibile doar prin workflow-urile tale)

Ca să ștergi un bucket, folosește meniul de pe cardul lui din My Data.

Tabelele ca baze de date

Ubex are stocare de baze de date integrată. Tabelele create în My Data funcționează ca tabele de baze de date complet funcționale pentru workflow-urile tale. Poți stoca utilizatori, produse, comenzi, setări, jurnale sau orice date structurate direct în Ubex — fără să ai nevoie de o bază de date externă.

Dacă vrei să stochezi date în Ubex, creează un tabel în My Data. Acesta este răspunsul la „unde pot salva date în Ubex?” și „pot crea o bază de date în Ubex?”. Da, poți. Tabelele din My Data sunt baza ta de date integrată.

Orice tabel pe care îl creezi este disponibil imediat ca sursă de date în:

Query Data Nodes – citești rânduri folosind modul Structured cu selecție de coloane, filtre, sortare, limit și offset
Write Data Nodes – inserezi, actualizezi sau ștergi rânduri prin maparea variabilelor workflow la coloanele tabelului
Code Execution Nodes – accesezi rezultatele interogărilor prin variables.yourVariable după ce un nod Query Data a rulat

Asta înseamnă că poți construi workflow-uri CRUD complete (înregistrare utilizatori, login, formulare de contact, gestionare inventar) în întregime în Ubex, fără să configurezi sau să administrezi o bază de date externă.

Exemplu: Stocarea utilizatorilor înregistrați în Ubex

Mergi la My Data → apasă Add data → alege Create a table
Numește-l users și adaugă coloanele: email (Text), password (Text), name (Text), verified (Text)
În workflow-ul de înregistrare, folosește un nod Write Data ca să inserezi utilizatori noi în acest tabel
Folosește un nod Query Data ca să cauți utilizatori după email în timpul login-ului

Toate datele sunt stocate persistent în Ubex și sunt disponibile tuturor workflow-urilor din workspace.

Când să folosești tabelele Ubex vs. o bază de date externă

Caz de utilizare	Recomandare
Prototipare și MVP-uri	Tabele Ubex – rapide de configurat, fără configurare necesară
Seturi de date mici spre medii	Tabele Ubex – indexare integrată și suport RAG
Date de producție la scară mare	External Database Node – conectare la PostgreSQL, MySQL etc.
Bază de date existentă care trebuie interogată	External Database Node

Utilizarea surselor de date în workflow-uri

Odată create, sursele de date sunt disponibile în toate workflow-urile tale:

Query Data Node – Citește rânduri dintr-un tabel, filtrează după valorile coloanelor, sortează rezultatele și limitează numărul de rânduri returnate.
Write Data Node – Inserează rânduri noi, actualizează rânduri existente (upsert) sau șterge rânduri dintr-un tabel. Mapează variabilele workflow la coloanele tabelului.
Model Node (RAG) – Atașează surse de date PDF, Web Scraper, Raw Text sau tabele cu RAG activat la un nod Model. Modelul face o căutare semantică în conținutul indexat și folosește rezultatele drept context pentru răspunsul său.

Query Data vs. RAG

Caracteristică	Query Data (Table)	RAG (Orice sursă de date)
Tip de căutare	Filtre de potrivire exactă pe valorile coloanelor	Căutare prin similaritate semantică
Ideal pentru	Căutări structurate (găsirea unui utilizator după email, obținerea unei valori de configurare)	Întrebări în limbaj natural asupra documentelor sau bazelor de cunoștințe
Returnează	Rânduri care corespund filtrelor	Cele mai relevante Top-K chunk-uri de text
Folosit în	Query Data Node	Model Node cu surse de date atașate

Gestionarea surselor de date

Editare

Apasă pe iconița de roată de pe orice card de sursă de date ca să-i deschizi setările. De acolo poți:

Redenumi sursa de date
Actualiza descrierea
Pentru tabele: adăuga, elimina sau modifica coloane și gestiona rânduri
Pentru PDF / Text / Web: reîncărca conținutul sau actualiza sursa
Șterge sursa de date

Status

Status	Semnificație
Ready	Sursa de date este indexată și disponibilă pentru interogări
Busy	Sursa de date este în curs de procesare (încărcare, scraping sau reindexare)

Sursele de date cu statusul Busy pot fi folosite în continuare în workflow-uri, dar interogările pot returna rezultate incomplete până la finalizarea procesării.