Procedury w dowolnej formie

Przegląd

Procedura w dowolnej formie opisuje jedno zadanie prostym, naturalnym językiem. Agent interpretuje instrukcje i dostosowuje sformułowania oraz kolejność do sytuacji. Taka procedura może wywoływać narzędzia (w tym narzędzia systemowe, jak zakończenie rozmowy), wyszukiwać dokumenty w bazie wiedzy i łączyć się z innymi procedurami.

Kiedy używać procedury w dowolnej formie

Użyj takiej procedury, gdy agent może dostosować sformułowania i kolejność do sytuacji, a ty chcesz szybko napisać ją prostym językiem. Porównanie z procedurami strukturalnymi, workflow i promptem systemowym znajdziesz w sekcji Kiedy używać procedur.

Budowa procedury

Oto procedura zwrotu środków w edytorze:

Procedura ma dwie główne części: wyzwalacz i treść. Obie mogą zawierać odwołania inline do innych zasobów, pokazane na zrzucie ekranu powyżej jako tagi z ikonami klucza. Każda procedura ma też nazwę widoczną w panelu.

Nazwa

Krótka etykieta identyfikująca procedurę w panelu. Nazwa nigdy nie jest wysyłana do LLM, więc nie wpływa na zachowanie agenta.

Wyzwalacz

Opis, kiedy agent powinien użyć tej procedury, na przykład Gdy użytkownik prosi o zwrot środków za zamówienie.

Pozostaw wyzwalacz pusty tylko podczas tworzenia podprocedury.

Treść

Treść procedury, napisana w markdown. Opisuje, co agent powinien zrobić: zadać pytanie, wyszukać zamówienie, wywołać narzędzie lub zakończyć rozmowę. Może być numerowaną sekwencją kroków albo ogólnymi wskazówkami do danej sytuacji. Każdy krok lub wskazówka może być jednym zdaniem (Poproś użytkownika o identyfikator zamówienia) albo krótkim akapitem wyjaśniającym, co zrobić i dlaczego.

Używaj numerowanych kroków dla działań wykonywanych po kolei, a punktów dla wymagań lub podpunktów w kroku.

Odwołania inline

Procedury mogą inline odwoływać się do różnych zasobów:

• Narzędzi (np. wyszukiwania zamówienia, obciążenia karty, zakończenia rozmowy, przekazania do człowieka)
• Dokumentów bazy wiedzy
• Innych procedur

Używaj odwołań inline, gdy krok wymaga użycia przez agenta narzędzia, dokumentu bazy wiedzy lub innej procedury. Odwołania automatycznie dołączają zasób do procedury, aby agent mógł go użyć. Zwykłe wzmianki w tekście (np. użyj tu narzędzia kalkulatora) też działają, ale tylko jeśli zasób jest już dołączony do agenta.

Wstaw odwołanie, wpisując / w wyzwalaczu lub treści, a następnie wybierając zasób z menu ukośnika. Odwołania pojawiają się w edytorze jako klikalne tagi. Kliknij tag, aby otworzyć powiązany zasób i sprawdzić jego konfigurację.

Podczas pisania treści w dowolnej formie przez API wstaw odwołania w następującej składni:

[tool id="tool_abc123"]
[kb id="kb_abc123"]
[procedure id="agtprc_abc123"]
[system_tool id="end_call"]
{{customer_id}}

Odwołanie inline do procedury musi używać procedury tego samego agenta. Zobacz Ograniczenia, aby poznać zakres agenta i działanie duplikacji.

Odwołanie w wyzwalaczu pozwala uruchomić procedurę na podstawie wyniku zasobu, na przykład Gdy get_user zwraca poziom „gold”. Odwołanie w treści mówi agentowi, aby wywołał lub sprawdził zasób w tym kroku.

Dokumenty bazy wiedzy, do których odwołuje się procedura, zawsze używają trybu auto użycia: gdy RAG jest włączony dla agenta, pobiera on odpowiednie fragmenty zamiast umieszczać cały dokument w prompcie. Jeśli dokument jest też dołączony do agenta, stosowany jest dla niego tryb użycia agenta, dlatego dołącz go do agenta w trybie prompt, aby zachować pełny tekst w prompcie.

Jeśli zasób, do którego się odwołano, zostanie później usunięty lub twoje konto straci do niego dostęp, tag będzie oznaczony jako uszkodzony. Etykieta Błędy u góry edytora wyświetla te odwołania: nieprawidłowe, jeśli zasób już nie istnieje, albo niedostępne, jeśli istnieje, ale twoje konto nie ma do niego dostępu. Otwórz etykietę, aby sprawdzić, którego kroku dotyczy problem, i popraw lub usuń odwołanie.

Podprocedury

Podprocedura ma pusty wyzwalacz. Agent może uruchomić ją tylko z innej procedury, która się do niej odwołuje.

Używaj podprocedur, aby współdzielić kroki w ramach jednego agenta i zmniejszyć liczbę procedur dostępnych jednocześnie. Nadaj procedurze wejściowej wyzwalacz, odwołaj się w jej treści do powiązanych podprocedur, a ich wyzwalacze pozostaw puste.

Podprocedura eskalacji może zawierać kroki przekazania rozmowy człowiekowi. Odwołaj się do niej z procedur zwrotu środków i anulowania, a jej wyzwalacz pozostaw pusty. Agent może eskalować jako krok dowolnej z tych procedur, ale poza nimi podprocedura pozostanie niedostępna.

Importowanie z dokumentu

Możesz zacząć od istniejącej standardowej procedury operacyjnej (SOP). Wybierz Z SOP w menu + na liście procedur, a następnie prześlij plik.

Obsługiwane formaty: PDF, DOCX, TXT, MD, HTML, EPUB. Pliki muszą mieć maksymalnie 20 MB.

Importer analizuje dokument, rozpoznaje maksymalnie 10 odrębnych procedur i tworzy dla każdej szkic z wygenerowaną nazwą, wyzwalaczem i treścią. Otwórz każdy szkic, aby go dopracować. Jeśli dokument zawiera więcej niż 10 SOP-ów, przed przesłaniem podziel go na mniejsze pliki.

Zarządzanie procedurą w dowolnej formie

Dobre praktyki

Dobre pisanie procedur oznacza dobre napisanie dwóch części: wyzwalacza, który uruchamia procedurę wtedy, gdy trzeba, oraz treści, którą agent potrafi wykonać.

Dopracowywanie procedury

Zalecamy zacząć od małej skali i używać testów agenta, aby sprawdzić każdą zmianę przed wprowadzeniem kolejnej.

Gdy test lub rozmowa na żywo się nie powiedzie, poszukaj kategorii błędu, która za tym stoi. Jeśli agent powiedział coś nieprawidłowego, dodanie Nie mów tego naprawi jedną rozmowę. Przeszukaj wcześniejsze rozmowy pod kątem podobnych błędów i napisz jedną instrukcję, która obejmie je wszystkie. Przyczyna może też leżeć w bazie wiedzy lub konfiguracji agenta. Architect może przeprowadzić takie wyszukiwanie: otwórz nieudaną rozmowę, wybierz Architect i poproś go o znalezienie podobnych błędów oraz zaproponowanie rozwiązania. Architect może też zamienić rozmowę w test.

Pisanie wyzwalaczy

Pisanie treści

Łączenie procedur