Make your AI agent ACT · build your first Tool
Instrument 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.
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 comenzii în sistemul tău
- Caută date despre clienți î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 să folosească AI-ul acest instrument |
Țintirea Utilizatorilor
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
Definirea parametrilor 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 trebuie 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 relevant (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, acesta 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 despre 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 |
|---|---|
Search | rgpd_legal_analysis |
search_docs | ecommerce_product_search |
Tool 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 levierul tău cel mai puternic. Folosește această formulă:
[Ce face — 1 propoziție]
Folosește pentru: [3–5 cazuri de utilizare concrete cu cuvintele pe care utilizatorii tăi le-ar spune efectiv]
❌ Prost:
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,
cercetarea 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 spune nimic AI-ului. Va lipi întrebarea brută a utilizatorului de fiecare dată. O descriere mai bună ghidează AI-ul pentru a extrage cuvintele cheie corecte înainte de a le trimite.
| ❌ Vag | ✅ Clar |
|---|---|
Interogarea de căutare | Interogare de căutare: tip de încălcare, nume companie, sector, sumă a amenzii sau concept legal |
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 precise ș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 instrument, 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 ceea ce acoperă instrumentul, cu atât mai puțină ambiguitate există. Nu trebuie să scrii excluderi explicite — precizia își face treaba.
Lista Rapidă de Verificare
Înainte de a publica un flux cu un declanșator 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 de utilizare concrete
- 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 Testare pentru a confirma rutarea corectă
Exemplu: Căutare Produs
Configurare Instrument:
- 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 dacă un produs există, căutarea specificațiilor sau prețului produsului.
- Variabilă:
query— "Numele produsului, categorie, caracteristică sau interval de preț pentru a căuta"
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 bestseller-ul nostru la 349€..."
Exemplu: Tichet JIRA
Configurare Instrument:
- 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 are nevoie 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ă
