Builderul de workflow-uri
Un workflow își rulează pașii singur: pornește după un program, la un apel API, la un mesaj WebSocket sau manual, apoi citește și scrie date, aplică regulile tale, apelează alte servicii și returnează un rezultat. Îl construiești pe un canvas vizual, manual sau cerându-i lui Vira.
Cum deschizi builderul
- Studio - apasă Start a workflow pe cardul Workflow.
- Un workflow existent - deschide-l din Studio. Tot acolo găsești și workflow-urile create de Qira și Vira pentru o aplicație web.
- Import a flow - ai deja un workflow ca JSON? Apasă Import a flow sub cardurile din Studio.
Canvasul
| Zonă | Ce face |
|---|---|
| Stânga sus | Numele workflow-ului (apasă creionul ca să-l redenumești) |
| Canvas | Nodurile și liniile dintre ele. Datele curg de la trigger-ul din partea de sus prin fiecare nod, pe rând |
| Undo, redo și zoom | În dreapta sus pe canvas, cu un buton care încadrează tot workflow-ul pe ecran |
| Mini hartă | În dreapta jos. Trage de ea ca să te deplasezi prin workflow-urile mari |
| Active | Pornește sau oprește workflow-ul. Un workflow inactiv nu răspunde la adresa lui API și nu rulează după program |
| History | Versiunile anterioare ale workflow-ului. Deschide una ca s-o vezi sau ca să revii la ea |
| Publish | Pune modificările tale live |
| Ask Vira | În stânga jos. Chatul în care Vira construiește și modifică workflow-ul pentru tine |
Apasă pe orice nod ca să-i deschizi setările. Dă dublu click pe canvas ca să adaugi un nod: dialogul Add Node te lasă să cauți după nume sau să răsfoiești toate cele 32 de noduri, împărțite în cinci grupuri: Flow Control, AI & Models, Data, Code & Transform și Integrations & I/O. Fiecare are propria pagină în secțiunea Workflows a acestei documentații.
Trigger-e
Fiecare workflow pornește cu un trigger:
| Trigger | Pornește workflow-ul când |
|---|---|
| Manual | Apeși Run în editor |
| Schedule | Vine momentul pe care l-ai setat: în fiecare dimineață, în fiecare vineri la 17:00, la fiecare 5 minute |
| API | Ceva îi apelează adresa. Setezi metodele permise, autentificarea, limita de cereri, timeout-ul, lista de IP-uri permise și CORS |
| WebSocket | Sosește un mesaj pe o conexiune WebSocket |
Agenții pornesc în schimb cu un Chat trigger. Vezi Builderul de agenți.
Construiește cu Vira
Apasă Ask Vira ca să-i deschizi panoul. Descrie ce trebuie să facă workflow-ul așa cum i-ai explica unui coleg, iar Vira alege nodurile, le configurează și le conectează pe canvas, sub ochii tăi.
Lângă caseta de mesaj:
- @ - îi arăți lui Vira ceva din spațiul tău de lucru, de exemplu un tabel
- Încărcare - atașezi un fișier, de exemplu un exemplu de cerere sau o specificație
- Microfon - vorbești în loc să scrii
- Coș de gunoi - ștergi conversația
- Selectorul de model - modelul AI pe care îl folosește Vira. Creditele rămase apar dedesubt
Iconița cu ceas din partea de sus a panoului îți deschide conversațiile anterioare cu Vira.
Cum modifici un workflow
Vira lucrează pe workflow-ul deschis, așa că îi poți cere modificări, nu doar workflow-uri noi:
- „Adaugă un pas care să-mi trimită un email când totalul comenzii depășește 500 €”
- „Dacă clientul nu e găsit, returnează 404 în loc de o listă goală”
- „Pune apelul de plată într-un try/catch și scrie eroarea în tabelul de erori”
Fiecare modificare apare pe canvas, iar History păstrează versiunea de dinainte.
Exemple de cereri
Rezumat zilnic
„În fiecare dimineață la 8, citește înregistrările noi de ieri din tabelul users și trimite-mi lista pe email.”
Trigger: Schedule. Apoi Query Data, Code pentru formatarea listei și Mail.
Endpoint pentru formular de contact
„Un endpoint API care primește nume, email și mesaj, verifică dacă emailul e valid, îl salvează într-un tabel contacts și returnează 201.”
Trigger: API. Apoi Data Validator, Write Data și Simple Output.
Alertă de comandă
„Când vine o comandă prin API, verifică stocul în tabelul products. Dacă e sub 5, trimite un mesaj pe Slack-ul nostru.”
Trigger: API. Apoi Query Data, Condition și un nod MCP Server conectat la Slack. Vezi Apps.
Testarea și urmărirea rulărilor
Rulează workflow-ul din editor ca să-l testezi. Fiecare rulare, din editor sau live, apare în Activity cu statusul, durata, intrarea și ieșirea ei, plus jurnalele de execuție pas cu pas.
Pașii următori
- Cum funcționează workflow-urile - noduri, conexiuni și variabile
- Trigger-e - toate modurile în care poate porni un workflow
- Referință API - apelează-ți workflow-urile din propriul cod