Nástroj na konverzáciu
Vytvorte nástroj, ktorý m ôže AI používať počas konverzácií. AI rozhoduje, kedy ho zavolať na základe kontextu.
Urobte, aby váš AI agent KONAL · vytvorte svoj prvý nástroj
Kedy použiť
Použite tento spúšťač na rozšírenie toho, čo môže vaša AI robiť:
- Hľadanie produktov vo vašom katalógu
- Kontrola stavu objednávky vo vašom systéme
- Vyhľadávanie údajov o zákazníkoch v CRM
- Vytváranie podporných tiketov v JIRA
- Rezervácia schôdzok
- Akákoľvek vlastná funkcia
Konfigurácia
Základné nastavenia
| Pole | Popis |
|---|---|
| Názov nástroja | Názov čitateľný pre človeka (zobrazený v knižnici uzlov) |
| Popis | Vysvetľuje, kedy/ako by mala AI tento nástroj používať |
Cielenie na používateľov
Vyberte, kto môže tento nástroj používať:
| Možnosť | Popis |
|---|---|
| Všetci používatelia | Anonymní + pripojení používatelia |
| Iba pripojení používatelia | Iba prihlásení používatelia |
| Prístup na základe rolí | Konkrétne používateľské roly |
Premenné nástroja
Definujte parametre, ktoré AI potrebuje zhromaždiť od používateľa:
| Pole | Popis |
|---|---|
| Názov premennej | Interný názov (napr. query, orderId) |
| Popis | Pomôžte AI pochopiť, čo sa má pýtať |
Premenné sú dostupné ako {{variableName}} vo vašom toku.
Ako to funguje
- Definujete nástroj s názvom, popisom a premennými
- AI sa učí, kedy ho používať z vášho popisu
- Používateľ sa pýta na niečo súvisiace (napr. "Nájdi mi laptop")
- AI zhromažďuje potrebné premenné konverzačne
- Tok beží s nazbieranými údajmi
- Výsledok sa vracia AI na konečnú odpoveď
Názvy vašich nástrojov: Prečo to záleží
Keď má váš AI asistent prístup k viacerým nástrojom, vyberá si, ktorý zavolať, na základe iba troch vecí: názov nástroja, popis nástroja a popisy premenných. Nemôže vidieť, čo je vo vnútri toku — číta text a rozhoduje.
Ak sú tieto tri polia nejasné alebo príliš podobné naprieč nástrojmi, AI si vyberie nesprávny nástroj. Štúdie o funkčnom volaní LLM ukazujú, že zlepšenie jasnosti popisu samo o sebe môže zvýšiť správny výber nástroja o 15–20 percentuálnych bodov, bez zmeny základného modelu.
To je obzvlášť kritické, keď máte niekoľko nástrojov, ktoré vyhľadávajú rôzne databázy znalostí — z pohľadu AI všetky "hľadajú informácie." Názov a popis sú jediným spôsobom, ako ich rozlíšiť.
Názov nástroja
Použite vzor domain_action_target, aby názov sám rozlišoval každý nástroj:
| ❌ Nejasné | ✅ Jasné |
|---|---|
Hľadanie | rgpd_právna_analýza |
search_docs | ecommerce_product_search |
Nástroj 2 | support_ticket_lookup |
AI používa názov ako prvý filter pred čítaním popisu. Jasný názov mu umožňuje okamžite vytvoriť zoznam; generický názov ho núti hádať.
Popis nástroja
Popis je váš najvýkonnejší páka. Použite túto formulu:
[Čo robí — 1 veta]
Použiť na: [3–5 konkrétnych prípadov použitia so slovami, ktoré by používatelia skutočne povedali]
❌ Zlé:
Hľadá informácie v databáze znalostí.
✅ Dobré:
Hľadá sankcie CNIL a judikatúru CJUE.
Použiť na: nájdenie rozhodnutí o pokutách podľa sektora alebo typu porušenia,
vyhľadávanie výšky pokút, citovanie právnych precedensov,
hodnotenie finančného rizika nekompatibility s RGPD.
Slová v "Použiť na" fungujú ako semantické spúšťače. Keď správa používateľa obsahuje "pokutu", "sankciu" alebo "riziko", AI ju okamžite priradí k tomuto nástroju.
Popisy premenných
Premenná opísaná ako "Vyhľadávací dotaz" nepovedie AI nič. Každý raz vloží surovú otázku používateľa. Lepší popis nasmeruje AI na extrakciu správnych kľúčových slov pred ich odoslaním.
| ❌ Nejasné | ✅ Jasné |
|---|---|
Vyhľadávací dotaz | Vyhľadávací dotaz: typ porušenia, názov spoločnosti, sektor, výška pokuty alebo právny koncept |
Používateľský vstup | Typ dokumentu požadovaného: šablóna, model, formulár, klauzula alebo zmluva |
To núti AI preformulovať namiesto kopírovania celej správy používateľa — čo vedie k cielenejším vyhľadávaniam a lepším výsledkom.
Vyhnutie sa konfliktom nástrojov
Keď môžu dva nástroje odpovedať na tú istú otázku, AI váha — a niekedy si vyberá náhodne. Každý nástroj musí pokrývať exkluzívne územie.
Pravidlo: ak dokážete vymyslieť otázku používateľa, ktorá by mohla ísť k obom nástrojom, vaše popisy potrebujú väčšiu presnosť.
Príklad — 5 nástrojov na dodržiavanie s jasnými hranicami:
| Nástroj | Pokrýva | Nepokrýva |
|---|---|---|
compliance_legal_analysis | Právne články, právne povinnosti, práva | Žiadne praktické rady, žiadne reálne prípady |
compliance_methodology | Krok-za-krokom príručky, audítorské postupy, rámce | Žiadny právny text, žiadne šablóny |
compliance_document_templates | Modely pripravené na použitie, formuláre, zmluvné klauzuly | Žiadna metodológia, žiadna právna analýza |
compliance_business_processes | Prevádzkové pracovné toky, schvaľovacie okruhy | Žiadny právny text, iba interné procesy |
compliance_operational_solutions | Konkrétne opravy, technické odporúčania | Žiadna teória, iba vykonateľné riešenia |
Čím konkrétnejší je každý popis o tom, čo nástroj pokrýva, tým menej je nejasností. Nie je potrebné písať explicitné vylúčenia — presnosť robí prácu.
Rýchly kontrolný zoznam
Pred publikovaním toku s triggerom Nástroja na konverzáciu overte:
- Názov dodržiava
domain_action_target— rozlíšiteľný bez čítania popisu - Popis začína tým, čo nástroj robí v 1 vete
- Popis obsahuje "Použiť na:" s 3–5 konkrétnymi prípadmi použitia
- Popisy premenných uvádzajú typy očakávaných informácií, nie len "dotaz"
- Žiadne prekrytie s územím iného nástroja
- Testované s 2–3 nejasnými otázkami v testovacom paneli na potvrdenie správneho smerovania
Príklad: Hľadanie produktu
Konfigurácia nástroja:
- Názov:
ecommerce_product_search - Popis: Hľadá v produktovom katalógu podľa názvu, kategórie alebo funkcie. Použiť na: nájdenie konkrétneho produktu, porovnávanie produktov v kategórii, kontrola, či produkt existuje, vyhľadávanie špecifikácií alebo cien produktu.
- Premenná:
query— "Názov produktu, kategória, funkcia alebo cenový rozsah na vyhľadávanie"
Tok:
- Trigger: Nástroj na konverzáciu
- Akcia: Hľadanie v databáze znalostí (
{{query}}) - Akcia: Nastaviť pozorovanie (vrátiť výsledky)
Konverzácia používateľa:
Používateľ: "Máte nejaké bezdrôtové slúchadlá?"
AI: zavolá ecommerce_product_search s query="bezdrôtové slúchadlá"
AI: "Áno! Našiel som 3 bezdrôtové slúchadlá. Sony WH-1000XM5 sú naším najpredávanejším produktom za 349 €..."
Príklad: JIRA tiket
Konfigurácia nástroja:
- Názov:
support_create_jira_ticket - Popis: Vytvára JIRA podporný tiket z konverzácie. Použiť na: keď používateľ hlási chybu, požaduje funkciu alebo potrebuje eskalovať problém technickému tímu.
- Premenné:
title— "Krátky súhrn problému (1 veta)",description— "Podrobný popis vrátane krokov na reprodukciu, očakávaného správania a skutočného správania"
Tok:
- Trigger: Nástroj na konverzáciu
- Akcia: AI požiadavka (vygenerovať názov/popis)
- Paralelne: Vygenerovať popis + názov
- Akcia: JIRA vytvoriť problém
