Narzędzie Rozmowy
Stwórz narzędzie, które AI może wykorzystać podczas rozmów. AI decyduje, kiedy je wywołać na podstawie kontekstu.
Spraw, aby Twój agent AI DZIAŁAŁ · zbuduj swoje pierwsze narzędzie
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
- Rezerwowanie spotkań
- Dowolna niestandardowa funkcjonalność
Konfiguracja
Podstawowe Ustawienia
| 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 używać 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 je 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 tylko trzech rzeczy: nazwy narzędzia, opisu narzędzia i opisów zmiennych. Nie może zobaczyć, co jest w przepływie — czyta tekst i decyduje.
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 podstawowego modelu.
Jest to szczególnie krytyczne, gdy masz kilka narzędzi, które przeszukują różne bazy wiedzy — z perspektywy AI, wszystkie one "szukają informacji". 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 filtru przed przeczytaniem opisu. Jasna nazwa pozwala na natychmiastowe zawężenie wyboru; ogólna nazwa zmusza do zgadywania.
Opis Narzędzia
Opis to Twój najpotężniejszy dźwignia. Użyj tej formuły:
[Co robi — 1 zdanie]
Użyj do: [3–5 konkretnych przypadków użycia z słowami, które Twoi użytkownicy rzeczywiście by powiedzieli]
❌ Źle:
Szukaj w bazie wiedzy informacji.
✅ Dobrze:
Szukaj sankcji CNIL i orzecznictwa CJUE.
Użyj do: znajdowania decyzji o karach według sektora lub typu naruszenia,
wyszukiwania kwot kar, cytowania precedensów prawnych,
oceny ryzyka finansowego braku zgodności z RGPD.
Słowa w "Użyj do" działają jako wyzwalacze semantyczne. Gdy wiadomość użytkownika zawiera "kara", "grzywna" lub "ryzyko", AI natychmiast dopasowuje to do tego narzędzia.
Opisy Zmiennych
Zmienna opisana jako "Zapytanie wyszukiwania" nic nie mówi AI. Za każdym razem wkleja surowe pytanie użytkownika. 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 grzywny lub pojęcie prawne |
Wejście użytkownika | Typ dokumentu żądanego: szablon, model, formularz, klauzula lub umowa |
To zmusza AI do przekształcenia 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 |
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ą rodzaje 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: Szuka w katalogu produktów według nazwy, kategorii lub cechy. Użyj do: znalezienia konkretnego produktu, porównania produktów w kategorii, sprawdzenia, czy produkt istnieje, wyszukiwania specyfikacji lub cen produktu.
- 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 użytkownika:
Użytkownik: "Czy masz 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 potrzebuje 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
