Procedury w formie swobodnego tekstu

Omówienie

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

Kiedy używać procedury swobodnej

Użyj procedury swobodnej, gdy agent może dostosować sformułowania i kolejność do sytuacji, a ty chcesz szybko stworzyć 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 składa się z dwóch głównych części: wyzwalacza i treści. Obie mogą zawierać odwołania w tekście do innych zasobów, widoczne 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.

Zostaw wyzwalacz pusty tylko podczas tworzenia podprocedury.

Treść

Treść procedury zapisana w Markdown. Opisuje, co agent powinien zrobić: zadać pytanie, wyszukać zamówienie, wywołać narzędzie lub zakończyć rozmowę. Może to być numerowana sekwencja kroków albo ogólne wskazówki dla 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 elementów podrzędnych w kroku.

Odwołania w tekście

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

• Narzędzi (np. wyszukanie zamówienia, obciążenie karty, zakończenie rozmowy, przekazanie do człowieka)
• Dokumentów bazy wiedzy
• Innych procedur

Używaj odwołań w tekście, gdy krok wymaga od agenta użycia 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 tutaj 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 potem wybierając zasób z menu ukośnika. Odwołania są wyświetlane w edytorze jako klikalne tagi. Kliknij tag, aby otworzyć dany zasób i potwierdzić jego konfigurację.

Podczas pisania treści swobodnej przez API wstawiaj odwołania za pomocą tej składni:

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

Odwołanie do procedury w tekście musi używać procedury z tego samego agenta. Informacje o zakresie agenta i zachowaniu przy duplikowaniu znajdziesz w sekcji Ograniczenia.

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

Jeśli wskazany zasób zostanie później usunięty albo twoje konto straci do niego dostęp, tag będzie widoczny jako uszkodzony. Plakietka Błędy u góry edytora pokazuje te odwołania: nieprawidłowe, jeśli zasób już nie istnieje, lub niedostępne, jeśli istnieje, ale twoje konto nie ma do niego dostępu. Otwórz plakietkę, 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 ograniczyć liczbę procedur dostępnych naraz. Nadaj procedurze głównej wyzwalacz, odwołaj się do powiązanych podprocedur w jej treści i zostaw ich wyzwalacze puste.

Podprocedura eskalacji może zawierać kroki przekazania rozmowy człowiekowi. Odwołaj się do niej w procedurach zwrotu środków i anulowania, a jej wyzwalacz zostaw pusty. Agent może eskalować jako krok jednej 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 do 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, podziel go na mniejsze pliki przed przesłaniem.

Zarządzanie procedurą swobodną

Dobre praktyki

Dobre pisanie procedur wymaga dobrego przygotowania dwóch części: wyzwalacza, który uruchamia procedurę wtedy, gdy powinien, oraz treści, którą agent może wykonać.

Pisanie wyzwalaczy

Pisanie treści

Łączenie procedur