Aktualizuj stan

Omówienie

Narzędzie Aktualizuj stan pozwala agentowi ustawić jedną lub więcej zmiennych dynamicznych w trakcie rozmowy. Podobnie jak inne narzędzia systemowe, zmienia ono tylko wewnętrzny stan rozmowy — nigdy nie wywołuje zewnętrznego API ani funkcji po stronie klienta.

Użyj go, by zapisywać informacje w trakcie rozmowy — na przykład oznaczyć, że rozmowę należy eskalować, zapisać wartość podaną przez użytkownika lub obliczyć wartość na podstawie innych zmiennych dynamicznych.

Aby stosować aktualizacje stanu w stałym punkcie workflow, zamiast wtedy, gdy LLM wywoła narzędzie, użyj węzła aktualizacji stanu. Przyjmuje on te same aktualizacje stanu.

Działanie

• Wiele aktualizacji na wywołanie: Jedno wywołanie narzędzia może przypisać jednocześnie do 50 zmiennych dynamicznych.
• Wartości oparte na wyrażeniach: Każda wartość jest wynikiem wyrażenia, które może łączyć stałe, istniejące zmienne dynamiczne, wartości wyodrębnione przez LLM z rozmowy oraz operatory.
• Wyodrębnianie przez LLM tylko w razie potrzeby: Narzędzie prosi LLM o wyodrębnienie parametrów tylko dla aktualizacji, które tego wymagają. Aktualizacje zbudowane wyłącznie ze stałych i/lub istniejących zmiennych dynamicznych nie dodają parametrów do wywołania funkcji.
• Natychmiastowa dostępność: Po uruchomieniu narzędzia zaktualizowane zmienne dynamiczne są dostępne w dalszej części rozmowy — mogą się do nich odwoływać późniejsze prompty, inne wywołania narzędzi i nadpisania, tak jak do każdej innej zmiennej dynamicznej.

Jak to działa

Każda aktualizacja stanu przypisuje wynik wyrażenia do zmiennej dynamicznej:

variable_name = expression

Wyrażenie może mieć jeden z poniższych typów. Wyrażenia można też zagnieżdżać, aby tworzyć bardziej złożoną logikę:

Na przykład poniższa aktualizacja stanu ustawia should_escalate na true, jeśli LLM uzna, że użytkownik jest sfrustrowany, lub jeśli zmienna dynamiczna retry_count jest już większa niż 3:

should_escalate = (llm: "User sounds frustrated with the conversation") OR (retry_count > 3)

Konfiguracja

Przykłady użycia

• Flagi eskalacji: Ustaw zmienną dynamiczną (na przykład should_escalate), którą sprawdzi system podrzędny lub reguła biznesowa, jak pokazano w przewodniku po integracji z Genesys.
• Zapisywanie wyodrębnionych informacji: Zapisz wartość podaną przez użytkownika (numer zamówienia, preferencję, wybrany dział) jako zmienną dynamiczną do użycia później w rozmowie.
• Wartości pochodne: Oblicz wartość na podstawie innych zmiennych dynamicznych, na przykład zwiększ licznik lub połącz dwie zmienne w jedną.

Cel: Pozwala agentowi aktualizować jedną lub więcej zmiennych dynamicznych na podstawie rozmowy, bez wywoływania zewnętrznego API.

Warunki wywołania: LLM powinien wywołać to narzędzie, gdy:

• Rozmowa dostarcza informacji, którą należy zapisać (np. flagę eskalacji, wybraną opcję lub wartość podaną przez użytkownika)
• Skonfigurowana aktualizacja stanu zależy od wartości, którą LLM musi ocenić lub wyodrębnić z rozmowy

Parametry:

Parametry funkcji zależą od konfiguracji narzędzia. Każda skonfigurowana aktualizacja stanu używająca wartości wyodrębnionej przez LLM dodaje jedną właściwość do schematu, nazwaną od zmiennej dynamicznej tej aktualizacji i z typem string, number lub boolean. Aktualizacje stanu tworzone wyłącznie ze stałych lub innych zmiennych dynamicznych nie dodają parametrów.

Format wywołania funkcji:

{
  "type": "function",
  "function": {
    "name": "update_state",
    "arguments": "{\"should_escalate\": true}"
  }
}

Implementacja: Agent ocenia każde skonfigurowane wyrażenie, używając wyodrębnionych parametrów oraz bieżących zmiennych dynamicznych rozmowy, a następnie przypisuje wyniki do odpowiednich zmiennych dynamicznych. Nie wykonuje żadnego zewnętrznego żądania.

FAQ