Narzędzie Rozmowy
Utwórz narzędzie, które AI może wykorzystać podczas rozmów. AI decyduje, kiedy je wywołać na podstawie kontekstu.
Kiedy Używać
Użyj tego wyzwalacza, aby rozszerzyć możliwości swojego AI:
- Wyszukiwanie produktów w katalogu
- Sprawdzanie statusu zamówienia w systemie
- Wyszukiwanie danych klientów w CRM
- Tworzenie zgłoszeń wsparcia w JIRA
- Rezerwacja spotkań
- Dowolna niestandardowa funkcjonalność
Konfiguracja
Ustawienia Podstawowe
| Pole | Opis |
|---|---|
| Nazwa Narzędzia | Nazwa czytelna dla ludzi (wyświetlana w Bibliotece Węzłów) |
| Opis | Wyjaśnia, kiedy/jak AI powinno używać tego narzędzia |
Targetowanie Użytkowników
Wybierz, kto może korzystać z tego narzędzia:
| Opcja | Opis |
|---|---|
| Wszyscy Użytkownicy | Użytkownicy anonimowi + zalogowani |
| Tylko Użytkownicy Zalogowani | Tylko użytkownicy zalogowani |
| Dostęp na Podstawie Ról | Konkretne role użytkowników |
Zmienne Narzędzia
Zdefiniuj parametry, które AI musi zebrać od użytkownika:
| Pole | Opis |
|---|---|
| Nazwa Zmiennej | Nazwa wewnętrzna (np. query, orderId) |
| Opis | Pomaga AI zrozumieć, o co pytać |
Zmienne stają się dostępne jako {{variableName}} w twoim przepływie.
Jak To Działa
- Definiujesz narzędzie z nazwą, opisem i zmiennymi
- AI uczy się, kiedy go używać na podstawie twojego opisu
- Użytkownik pyta o coś związanego (np. "Znajdź mi laptopa")
- AI zbiera wymagane zmienne w sposób konwersacyjny
- Przepływ działa z zebranymi danymi
- Wynik wraca do AI jako ostateczna odpowiedź
Nazewnictwo Twoich Narzędzi: Dlaczego To Ważne
Kiedy twój asystent AI ma dostęp do wielu narzędzi, wybiera, które z nich wywołać na podstawie trzech rzeczy: nazwy narzędzia, opisu narzędzia i opisów zmiennych. Nie może zobaczyć, co jest w przepływie — czyta tekst i podejmuje decyzję.
Jeśli te trzy pola są niejasne lub zbyt podobne w różnych narzędziach, AI wybierze niewłaściwe narzędzie. Badania nad wywoływaniem funkcji LLM pokazują, że poprawa jasności opisów może zwiększyć poprawny wybór narzędzia o 15–20 punktów procentowych, bez zmiany modelu.
Jest to szczególnie krytyczne, gdy masz kilka narzędzi, które przeszukują różne bazy wiedzy — z perspektywy AI, wszystkie one "przeszukują informacje". Nazwa i opis są jedynym sposobem, w jaki może je odróżnić.
Nazwa Narzędzia
Użyj wzoru domain_action_target, aby sama nazwa odróżniała każde narzędzie:
| ❌ Niejasne | ✅ Jasne |
|---|---|
Search | rgpd_legal_analysis |
search_docs | ecommerce_product_search |
Tool 2 | support_ticket_lookup |
AI używa nazwy jako pierwszego filtra przed przeczytaniem opisu. Jasna nazwa pozwala na natychmiastowe zawężenie wyboru; ogólna nazwa zmusza do zgadywania.
Opis Narzędzia
Opis jest twoim najpotężniejszym narzędziem. Użyj tej formuły:
[Co robi — 1 zdanie]
Użyj do: [3–5 konkretnych przypadków użycia z słowami, które rzeczywiście powiedzą twoi użytkownicy]
❌ Źle:
Przeszukuje bazę wiedzy w poszukiwaniu informacji.
✅ Dobrze:
Przeszukuje sankcje CNIL i orzecznictwo CJUE.
Użyj do: znajdowania decyzji o karach według sektora lub typu naruszenia,
wyszukiwania kwot kar, cytowania precedensów prawnych,
oceny ryzyka finansowego związane z niezgodnością z RGPD.
Słowa w sekcji "Użyj do" działają jako wyzwalacze semantyczne. Kiedy wiadomość użytkownika zawiera "kara", "sankcja" lub "ryzyko", AI natychmiast dopasowuje ją do tego narzędzia.
Opisy Zmiennych
Zmienna opisana jako "Zapytanie wyszukiwania" nie mówi AI nic. Będzie wklejać surowe pytanie użytkownika za każdym razem. Lepszy opis prowadzi AI do wyodrębnienia odpowiednich słów kluczowych przed ich wysłaniem.
| ❌ Niejasne | ✅ Jasne |
|---|---|
Zapytanie wyszukiwania | Zapytanie wyszukiwania: typ naruszenia, nazwa firmy, sektor, kwota kary lub pojęcie prawne |
Wejście użytkownika | Typ dokumentu żądanego: szablon, model, formularz, klauzula lub umowa |
To zmusza AI do przekształcania zamiast kopiowania całej wiadomości użytkownika — co skutkuje bardziej ukierunkowanymi wyszukiwaniami i lepszymi wynikami.
Unikanie Konfliktów Narzędzi
Kiedy dwa narzędzia mogą odpowiedzieć na to samo pytanie, AI waha się — a czasami wybiera losowo. Każde narzędzie musi obejmować wyłączny obszar.
Zasada: jeśli możesz pomyśleć o pytaniu użytkownika, które mogłoby trafić do obu narzędzi, twoje opisy potrzebują większej precyzji.
Przykład — 5 narzędzi zgodności z wyraźnymi granicami:
| Narzędzie | Obejmuje | Nie obejmuje |
|---|---|---|
compliance_legal_analysis | Artykuły prawne, obowiązki prawne, prawa | Brak praktycznych porad, brak przypadków z rzeczywistego świata |
compliance_methodology | Przewodniki krok po kroku, procedury audytowe, ramy | Brak tekstu prawnego, brak szablonów |
compliance_document_templates | Gotowe modele, formularze, klauzule umowne | Brak metodologii, brak analizy prawnej |
compliance_business_processes | Procesy operacyjne, obiegi zatwierdzania | Brak tekstu prawnego, tylko procesy wewnętrzne |
compliance_operational_solutions | Konkretne rozwiązania, rekomendacje techniczne | Brak teorii, tylko działania do podjęcia |
Im bardziej szczegółowy jest każdy opis dotyczący tego, co narzędzie obejmuje, tym mniej jest niejasności. Nie musisz pisać wyraźnych wyłączeń — precyzja wykonuje pracę.
Szybka Lista Kontrolna
Przed opublikowaniem przepływu z wyzwalaczem Narzędzia Rozmowy, zweryfikuj:
- Nazwa przestrzega wzoru
domain_action_target— odróżnialna bez czytania opisu - Opis zaczyna się od tego, co narzędzie robi w 1 zdaniu
- Opis zawiera "Użyj do:" z 3–5 konkretnymi przypadkami użycia
- Opisy zmiennych wymieniają typy oczekiwanych informacji, a nie tylko "zapytanie"
- Brak nakładania się z terytorium innego narzędzia
- Testowane z 2–3 niejednoznacznymi pytaniami w panelu testowym, aby potwierdzić poprawne kierowanie
Przykład: Wyszukiwanie Produktów
Konfiguracja Narzędzia:
- Nazwa:
ecommerce_product_search - Opis: Przeszukuje katalog produktów według nazwy, kategorii lub cechy. Użyj do: znajdowania konkretnego produktu, porównywania produktów w kategorii, sprawdzania, czy produkt istnieje, wyszukiwania specyfikacji lub cen produktów.
- Zmienna:
query— "Nazwa produktu, kategoria, cecha lub zakres cenowy do wyszukania"
Przepływ:
- Wyzwalacz: Narzędzie Rozmowy
- Akcja: Wyszukiwanie w Bazie Wiedzy (
{{query}}) - Akcja: Ustaw Obserwację (zwróć wyniki)
Rozmowa z użytkownikiem:
Użytkownik: "Czy macie jakieś bezprzewodowe słuchawki?"
AI: wywołuje ecommerce_product_search z query="bezprzewodowe słuchawki"
AI: "Tak! Znalazłem 3 bezprzewodowe słuchawki. Sony WH-1000XM5 to nasz bestseller w cenie 349 €..."
Przykład: Zgłoszenie JIRA
Konfiguracja Narzędzia:
- Nazwa:
support_create_jira_ticket - Opis: Tworzy zgłoszenie wsparcia JIRA z rozmowy. Użyj do: gdy użytkownik zgłasza błąd, prosi o funkcję lub musi eskalować problem do zespołu technicznego.
- Zmienne:
title— "Krótki opis problemu (1 zdanie)",description— "Szczegółowy opis, w tym kroki do reprodukcji, oczekiwane zachowanie i rzeczywiste zachowanie"
Przepływ:
- Wyzwalacz: Narzędzie Rozmowy
- Akcja: Prośba AI (generuj tytuł/opis)
- Równolegle: Generuj opis + tytuł
- Akcja: JIRA Utwórz Zgłoszenie
