Make your AI agent ACT · build your first Tool
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.
Kedy Použiť
Použite tento spúšťač na rozšírenie toho, čo vaša AI môže 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 Roly | Špecifické uží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áha AI pochopiť, čo sa má pýtať |
Premenné sa stanú dostupnými 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 niečo súvisiace (napr. "Nájdi mi laptop")
- AI zhromažďuje požadované premenné konverzačne
- Tok beží so zhromaždený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á, ktorý z nich zavolať, na základe iba troch vecí: názvu nástroja, popisu nástroja a popisov 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 volaní funkcií LLM ukazujú, že zlepšenie jasnosti popisu 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 "vyhľadávajú 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 o sebe rozlišoval každý nástroj:
| ❌ Nejasné | ✅ Jasné |
|---|---|
Search | rgpd_legal_analysis |
search_docs | ecommerce_product_search |
Tool 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 s výrazmi, 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 nesúhlasu 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 "Hľadacia otázka" nepovie AI nič. Pri každom použití vloží surovú otázku používateľa. Lepší popis vedie AI k extrakcii správnych kľúčových slov pred ich odoslaním.
| ❌ Nejasné | ✅ Jasné |
|---|---|
Hľadacia otázka | Hľadacia otázka: typ porušenia, názov spoločnosti, sektor, výška pokuty alebo právny koncept |
Vstup používateľa | Typ dokumentu požadovaného: šablóna, model, formulár, klauzula alebo zmluva |
To núti AI, aby preformulovala namiesto kopírovania celej správy používateľa — čo vedie k cielenejším vyhľadávaniam a lepším výsledkom.
Vyhýbanie sa Konfliktom Nástrojov
Keď dva nástroje môžu 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 si dokážete predstaviť 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 predpisov 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 návody, audítorské postupy, rámce | Žiadny právny text, žiadne šablóny |
compliance_document_templates | Modely, formuláre, zmluvné klauzuly pripravené na použitie | Ž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 akčné riešenia |
Čím konkrétnejší je každý popis o tom, čo nástroj pokrýva, tým menej je nejasností. Nemusíte písať explicitné vylúčenia — presnosť robí prácu.
Rýchly Kontrolný Zoznam
Pred publikovaním toku s vyvolávačom Nástroja na Konverzáciu overte:
- Názov dodržiava
domain_action_target— rozliš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 Testovacej 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 vlastnosti. 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 produktov.
- Premenná:
query— "Názov produktu, kategória, vlastnosť alebo cenový rozsah na vyhľadávanie"
Tok:
- Spúšťač: Nástroj na Konverzáciu
- Akcia: Vyhľadávanie v Databáze Znalostí (
{{query}}) - Akcia: Nastavenie Pozorovania (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 bestsellerom 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, žiada 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:
- Spúšťač: Nástroj na Konverzáciu
- Akcia: Žiadosť AI (vygenerovať názov/popis)
- Paralelne: Vygenerovať popis + názov
- Akcia: JIRA Vytvoriť Problém
