Instrumentul de Conversație
Creează un instrument pe care AI-ul îl poate folosi în timpul conversațiilor. AI-ul decide când să-l apeleze în funcție de context.
Fă-ți agentul AI să ACȚIONEZE · construiește-ți primul Instrument
Când să Folosești
Folosește acest declanșator pentru a extinde ceea ce poate face AI-ul tău:
- Caută produse în catalogul tău
- Verifică starea comenzilor în sistemul tău
- Caută datele clienților în CRM
- Creează tichete de suport în JIRA
- Programează întâlniri
- Orice capacitate personalizată
Configurare
Setări de Bază
| Câmp | Descriere |
|---|---|
| Numele Instrumentului | Nume ușor de citit (afișat în Biblioteca de Noduri) |
| Descriere | Explică când/cum ar trebui AI-ul să folosească acest instrument |
Targetare Utilizatori
Alege cine poate folosi acest instrument:
| Opțiune | Descriere |
|---|---|
| Toți Utilizatorii | Utilizatori anonimi + utilizatori conectați |
| Numai Utilizatori Conectați | Numai utilizatori autentificați |
| Acces pe Bază de Roluri | Roluri specifice de utilizator |
Variabilele Instrumentului
Definește parametrii pe care AI-ul trebuie să-i colecteze de la utilizator:
| Câmp | Descriere |
|---|---|
| Numele Variabilei | Nume intern (de exemplu, query, orderId) |
| Descriere | Ajută AI-ul să înțeleagă ce să ceară |
Variabilele devin disponibile ca {{variableName}} în fluxul tău.
Cum Funcționează
- Definiți un instrument cu nume, descriere și variabile
- AI-ul învață când să-l folosească din descrierea ta
- Utilizatorul întreabă ceva legat (de exemplu, "Găsește-mi un laptop")
- AI-ul colectează variabilele necesare conversațional
- Fluxul rulează cu datele colectate
- Rezultatul se întoarce la AI pentru răspunsul final
Numele Instrumentelor Tale: De ce Contează
Când asistentul tău AI are acces la mai multe instrumente, alege pe care să-l apeleze pe baza a trei lucruri doar: numele instrumentului, descrierea instrumentului și descrierile variabilelor. Nu poate vedea ce este în flux — citește textul și decide.
Dacă aceste trei câmpuri sunt vagi sau prea similare între instrumente, AI-ul va alege instrumentul greșit. Studiile privind apelurile funcțiilor LLM arată că îmbunătățirea clarității descrierii poate crește selecția corectă a instrumentului cu 15–20 de puncte procentuale, fără a schimba modelul de bază.
Acest lucru este deosebit de critic atunci când ai mai multe instrumente care caută în baze de cunoștințe diferite — din perspectiva AI-ului, toate "caută informații." Numele și descrierea sunt singura modalitate prin care poate să le deosebească.
Numele Instrumentului
Folosește modelul domain_action_target astfel încât numele să distingă fiecare instrument:
| ❌ Vag | ✅ Clar |
|---|---|
Caută | rgpd_legal_analysis |
search_docs | ecommerce_product_search |
Instrument 2 | support_ticket_lookup |
AI-ul folosește numele ca un prim filtru înainte de a citi descrierea. Un nume clar îi permite să facă o selecție instantanee; un nume generic îl forțează să ghicească.
Descrierea Instrumentului
Descrierea este cea mai puternică pârghie a ta. Folosește această formulă:
[Ce face — 1 propoziție]
Folosește pentru: [3–5 cazuri concrete de utilizare cu cuvintele pe care utilizatorii tăi le-ar spune de fapt]
❌ Rău:
Caută în baza de cunoștințe informații.
✅ Bun:
Caută sancțiuni CNIL și jurisprudența CJUE.
Folosește pentru: găsirea deciziilor de penalizare după sector sau tip de încălcare,
căutarea sumelor amenzilor, citarea precedentelor legale,
evaluarea riscului financiar al neconformității cu RGPD.
Cuvintele din "Folosește pentru" acționează ca declanșatoare semantice. Când mesajul unui utilizator conține "amendă", "penalizare" sau "riscuri", AI-ul îl asociază imediat cu acest instrument.
Descrierile Variabilelor
O variabilă descrisă ca "Interogarea de căutare" nu îi spune nimic AI-ului. Va lipi întrebarea brută a utilizatorului de fiecare dată. O descriere mai bună ghidează AI-ul să extragă cuvintele cheie corecte înainte de a le trimite.
| ❌ Vag | ✅ Clar |
|---|---|
Interogarea de căutare | Interogare de căutare: tip de încălcare, numele companiei, sector, suma amenzii sau concept juridic |
Input utilizator | Tipul documentului solicitat: șablon, model, formular, clauză sau contract |
Aceasta împinge AI-ul să reformuleze în loc să copieze întreaga mesaj a utilizatorului — rezultând căutări mai țintite și rezultate mai bune.
Evitarea Conflictelor între Instrumente
Când două instrumente pot răspunde la aceeași întrebare, AI-ul ezită — și uneori alege aleatoriu. Fiecare instrument trebuie să acopere un teritoriu exclusiv.
Regula: dacă poți gândi la o întrebare a utilizatorului care ar putea merge la oricare dintre instrumente, descrierile tale au nevoie de mai multă precizie.
Exemplu — 5 instrumente de conformitate cu limite clare:
| Instrument | Acoperă | Nu acoperă |
|---|---|---|
compliance_legal_analysis | Articole de lege, obligații legale, drepturi | Fără sfaturi practice, fără cazuri din lumea reală |
compliance_methodology | Ghiduri pas cu pas, proceduri de audit, cadre | Fără text legal, fără șabloane |
compliance_document_templates | Modele gata de utilizare, formulare, clauze contractuale | Fără metodologie, fără analiză legală |
compliance_business_processes | Fluxuri de lucru operaționale, circuite de aprobat | Fără text legal, doar procese interne |
compliance_operational_solutions | Soluții concrete, recomandări tehnice | Fără teorie, doar soluții acționabile |
Cu cât fiecare descriere este mai specifică în legătură cu ceea ce acoperă instrumentul, cu atât mai puțină ambiguitate există. Nu trebuie să scrii excluderi explicite — precizia face munca.
Lista Rapidă de Verificare
Înainte de a publica un flux cu un declanșator de Instrument de Conversație, verifică:
- Numele urmează
domain_action_target— distinctibil fără a citi descrierea - Descrierea începe cu ceea ce face instrumentul în 1 propoziție
- Descrierea include "Folosește pentru:" cu 3–5 cazuri concrete de utilizare
- Descrierile variabilelor listează tipurile de informații așteptate, nu doar "interogarea"
- Fără suprapuneri cu teritoriul altui instrument
- Testat cu 2–3 întrebări ambigue în panoul de Test pentru a confirma rutarea corectă
Exemplu: Căutare Produs
Configurarea Instrumentului:
- Nume:
ecommerce_product_search - Descriere: Caută în catalogul de produse după nume, categorie sau caracteristică. Folosește pentru: găsirea unui produs specific, compararea produselor dintr-o categorie, verificarea existenței unui produs, căutarea specificațiilor sau prețului produsului.
- Variabilă:
query— "Numele produsului, categorie, caracteristică sau interval de preț pentru căutare"
Flux:
- Declanșator: Instrument de Conversație
- Acțiune: Caută în Baza de Cunoștințe (
{{query}}) - Acțiune: Setează Observația (returnează rezultatele)
Conversația utilizatorului:
Utilizator: "Aveți căști wireless?"
AI: apelează ecommerce_product_search cu query="căști wireless"
AI: "Da! Am găsit 3 căști wireless. Sony WH-1000XM5 este bestsellerul nostru la 349€..."
Exemplu: Tichet JIRA
Configurarea Instrumentului:
- Nume:
support_create_jira_ticket - Descriere: Creează un tichet de suport JIRA din conversație. Folosește pentru: când utilizatorul raportează o eroare, solicită o caracteristică sau trebuie să escaladeze o problemă echipei tehnice.
- Variabile:
title— "Sumar scurt al problemei (1 propoziție)",description— "Descriere detaliată inclusiv pașii pentru a reproduce, comportamentul așteptat și comportamentul real"
Flux:
- Declanșator: Instrument de Conversație
- Acțiune: Cerere AI (generează titlu/descriere)
- Paralel: Generează descriere + titlu
- Acțiune: JIRA Creează Problemă
