Nástroj pro konverzaci
Vytvořte nástroj, který může AI používat během konverzací. AI rozhoduje, kdy jej zavolat na základě kontextu.
Kdy použít
Použijte tento spouštěč k rozšíření toho, co vaše AI může dělat:
- Hledat produkty ve vašem katalogu
- Zkontrolovat stav objednávky ve vašem systému
- Vyhledat zákaznická data v CRM
- Vytvářet podpůrné tikety v JIRA
- Rezervovat schůzky
- Jakoukoli vlastní funkčnost
Konfigurace
Základní nastavení
| Pole | Popis |
|---|---|
| Název nástroje | Název srozumitelný pro člověka (zobrazeno v Knihovně uzlů) |
| Popis | Vysvětluje, kdy/jak by AI měla tento nástroj používat |
Cílení na uživatele
Vyberte, kdo může tento nástroj používat:
| Možnost | Popis |
|---|---|
| Všichni uživatelé | Anonymní + připojení uživatelé |
| Pouze připojení uživatelé | Pouze přihlášení uživatelé |
| Přístup na základě rolí | Specifické uživatelské role |
Proměnné nástroje
Definujte parametry, které AI potřebuje shromáždit od uživatele:
| Pole | Popis |
|---|---|
| Název proměnné | Interní název (např. query, orderId) |
| Popis | Pomáhá AI pochopit, co se má ptát |
Proměnné se stávají dostupnými jako {{variableName}} ve vašem toku.
Jak to funguje
- Definujete nástroj s názvem, popisem a proměnnými
- AI se učí, kdy jej použít z vašeho popisu
- Uživatel se ptá na něco souvisejícího (např. "Najdi mi laptop")
- AI shromažďuje potřebné proměnné konverzačně
- Tok běží s nasbíranými daty
- Výsledek se vrací AI pro konečnou odpověď
Pojmenování vašich nástrojů: Proč je to důležité
Když má váš AI asistent přístup k více nástrojům, vybírá, který z nich zavolat, na základě pouze tří věcí: názvu nástroje, popisu nástroje a popisů proměnných. Nemůže vidět, co je uvnitř toku — čte text a rozhoduje.
Pokud jsou tyto tři pole vágní nebo příliš podobná napříč nástroji, AI si vybere špatný nástroj. Studie o volání funkcí LLM ukazují, že zlepšení jasnosti popisu může zvýšit správný výběr nástroje o 15–20 procentních bodů, aniž by se měnil základní model.
To je obzvlášť kritické, když máte několik nástrojů, které prohledávají různé znalostní báze — z pohledu AI všechny "hledají informace." Název a popis jsou jediným způsobem, jak je může rozlišit.
Název nástroje
Použijte vzor domain_action_target, aby název sám o sobě rozlišoval každý nástroj:
| ❌ Vágní | ✅ Jasné |
|---|---|
Hledat | rgpd_legal_analysis |
search_docs | ecommerce_product_search |
Nástroj 2 | support_ticket_lookup |
AI používá název jako první filtr před čtením popisu. Jasný název mu umožňuje okamžitě zúžit výběr; obecný název ho nutí hádat.
Popis nástroje
Popis je váš nejmocnější páka. Použijte tuto formuli:
[Co dělá — 1 věta]
Použít pro: [3–5 konkrétních případů použití s výrazy, které by vaši uživatelé skutečně řekli]
❌ Špatně:
Hledá informace v znalostní bázi.
✅ Dobře:
Hledá sankce CNIL a judikaturu CJUE.
Použít pro: nalezení rozhodnutí o pokutách podle sektoru nebo typu porušení,
vyhledávání částek pokut, citování právních precedensů,
hodnocení finančního rizika nedodržení RGPD.
Slova uvnitř "Použít pro" fungují jako sémantické spouštěče. Když zpráva uživatele obsahuje "pokutu", "sankci" nebo "riziko", AI ji okamžitě přiřadí k tomuto nástroji.
Popisy proměnných
Proměnná popsána jako "Dotaz na vyhledávání" neříká AI nic. Pokaždé vloží surovou otázku uživatele. Lepší popis vede AI k extrakci správných klíčových slov před jejich odesláním.
| ❌ Vágní | ✅ Jasné |
|---|---|
Dotaz na vyhledávání | Dotaz na vyhledávání: typ porušení, název společnosti, sektor, částka pokuty nebo právní pojem |
Uživatelský vstup | Typ dokumentu požadovaný: šablona, model, formulář, klauzule nebo smlouva |
To nutí AI přeformulovat místo kopírování celé zprávy uživatele — což vede k cílenějším vyhledáváním a lepším výsledkům.
Vyhýbání se konfliktům nástrojů
Když mohou dva nástroje odpovědět na stejnou otázku, AI váhá — a někdy vybírá náhodně. Každý nástroj musí pokrývat exkluzivní území.
Pravidlo: pokud si dokážete představit otázku uživatele, která by mohla jít k oběma nástrojům, vaše popisy potřebují větší přesnost.
Příklad — 5 nástrojů pro dodržování předpisů s jasnými hranicemi:
| Nástroj | Pokrývá | Nepokrývá |
|---|---|---|
compliance_legal_analysis | Právní články, právní povinnosti, práva | Žádné praktické rady, žádné reálné případy |
compliance_methodology | Krok za krokem průvodce, auditní postupy, rámce | Žádný právní text, žádné šablony |
compliance_document_templates | Modely, formuláře, klauzule smluv připravené k použití | Žádná metodologie, žádná právní analýza |
compliance_business_processes | Operační pracovní postupy, schvalovací okruhy | Žádný právní text, pouze interní procesy |
compliance_operational_solutions | Konkrétní opravy, technická doporučení | Žádná teorie, pouze akční řešení |
Čím konkrétnější je každý popis o tom, co nástroj pokrývá, tím méně je nejasností. Není nutné psát explicitní vyloučení — přesnost vykonává práci.
Rychlý kontrolní seznam
Před publikováním toku s vyvolávačem nástroje pro konverzaci ověřte:
- Název dodržuje
domain_action_target— rozlišitelný bez čtení popisu - Popis začíná tím, co nástroj dělá v 1 větě
- Popis zahrnuje "Použít pro:" s 3–5 konkrétními případy použití
- Popisy proměnných uvádějí typy očekávaných informací, ne pouze "dotaz"
- Žádné překryvy s územím jiného nástroje
- Testováno s 2–3 nejednoznačnými otázkami v testovacím panelu pro potvrzení správného směrování
Příklad: Hledání produktu
Konfigurace nástroje:
- Název:
ecommerce_product_search - Popis: Hledá v produktovém katalogu podle názvu, kategorie nebo vlastnosti. Použít pro: nalezení konkrétního produktu, porovnání produktů v kategorii, kontrola, zda produkt existuje, vyhledávání specifikací nebo cen produktu.
- Proměnná:
query— "Název produktu, kategorie, vlastnost nebo cenový rozsah pro vyhledávání"
Tok:
- Spouštěč: Nástroj pro konverzaci
- Akce: Hledat v znalostní bázi (
{{query}}) - Akce: Nastavit pozorování (vrátit výsledky)
Uživatelská konverzace:
Uživatel: "Máte nějaká bezdrátová sluchátka?"
AI: zavolá ecommerce_product_search s query="bezdrátová sluchátka"
AI: "Ano! Našel jsem 3 bezdrátová sluchátka. Sony WH-1000XM5 jsou naše bestsellery za 349 €..."
Příklad: JIRA tiket
Konfigurace nástroje:
- Název:
support_create_jira_ticket - Popis: Vytváří JIRA podpůrný tiket z konverzace. Použít pro: když uživatel hlásí chybu, žádá o funkci nebo potřebuje eskalovat problém technickému týmu.
- Proměnné:
title— "Krátké shrnutí problému (1 věta)",description— "Podrobný popis včetně kroků k reprodukci, očekávaného chování a skutečného chování"
Tok:
- Spouštěč: Nástroj pro konverzaci
- Akce: AI žádost (vygenerovat název/popis)
- Paralelně: Vygenerovat popis + název
- Akce: JIRA Vytvořit problém
