Tworzenie i konfigurowanie agentów AI

Aby uzyskać więcej informacji, zobacz sekcje Konfigurowanie agenta AI ze skryptami i Konfigurowanie autonomicznego agenta AI w podręczniku administracji Webex AI Agent Studio.

Konfigurowanie agentów AI w przepływie

Za pomocą węzła agenta AI można odpowiadać na określone zapytania z korpusu lub bazy wiedzy. Możesz także włączyć rozmowy wieloetapowe. Agent AI może zadawać pytania uzupełniające, rozumieć kontekst i udzielać spersonalizowanych odpowiedzi.

Aby rozpocząć, wystarczy przeciągnąć i upuścić węzeł agenta AI na narzędzie do tworzenia przepływów wizualizacji. Ten węzeł ułatwia korzystanie ze skryptowanych i autonomicznych agentów AI skonfigurowanych w Webex AI Agent Studio.

Konfigurowanie zmiennych wejściowych i wyjściowych w węźle agenta AI

Węzeł agenta AI zawiera dwie metody:

• Przetwarzaj wiadomość: Umożliwia wysyłanie wiadomości użytkownika do wybranego agenta i uzyskiwanie odpowiedzi agenta.

• Zamknij sesję: Umożliwia zamknięcie sesji w agencie AI. W niektórych scenariuszach może być konieczne zamknięcie istniejącej sesji agenta AI i zainicjowanie nowej. Można to osiągnąć za pomocą określonej metody w węźle agenta AI. Jeśli na przykład sesja pozostaje nieaktywna przez określony czas, system automatycznie zamyka sesję w celu optymalizacji zasobów.

1. W metodzie Process Message skonfiguruj następujące zmienne wejściowe:

   • Typ agenta: typ agenta używanego w przepływie, na przykład skryptowy lub autonomiczny.

   • Agent: agent, który przetwarza wiadomość użytkownika i otrzymuje odpowiedź.

     Agenci AI, do których masz dostęp, możesz zobaczyć w Webex AI Agent Studio. Aby uzyskać więcej informacji na temat zarządzania użytkownikami i agentami w Webex AI Agent Studio, zobacz Role użytkowników.

   • Komunikat: nazwa zmiennej zawierająca wiadomość przychodzącą klienta wysłaną do wybranego agenta AI

   • Język: Jeśli wybrany agent AI jest wielojęzyczny, można wybrać język wiadomości przychodzącej z listy rozwijanej Język. Listę rozwijaną wypełniamy na podstawie języków w ustawieniach agenta AI.

     Uwaga: Wyłączamy tę listę rozwijaną dla agentów posługujących się jednym językiem.

   • Kanał: Nazwa kanału, z którego system odbiera wiadomość od klienta.

   • Identyfikator użytkownika: podaj unikatowy identyfikator użytkownika dla wybranego kanału.

   • Parametry niestandardowe (opcjonalnie): Możesz przekazać dodatkowe informacje o kliencie do Webex AI Agent Studio jako parę klucz-wartość. Łączymy te informacje z profilem użytkownika i wykorzystujemy je do późniejszych rozmów. Można na przykład określić, czy użytkownik jest nowym czy istniejącym klientem.

     Klucze przekazane jako parametry niestandardowe są dostępne jako ${consumerData.extra_params.<your_key>} w odpowiedziach agentów.

     Obecnie parametry niestandardowe są obsługiwane tylko dla skryptowanego agenta AI za pośrednictwem kanałów cyfrowych.

   • Parametry wiadomości (opcjonalnie): Możesz przekazać dodatkowe informacje o bieżącej wymianie do Webex AI Agent Studio jako parę klucz-wartość.

     Ten komunikat nie jest przechowywany i jest on dostępny tylko do użycia w następnej odpowiedzi agenta. Klucze przekazane jako parametry wiadomości są dostępne jako ${extra_params.<your_key>} w odpowiedziach agentów.

2. Skonfiguruj następujące zmienne wyjściowe w metodzie Process Message:

   • TextResponse: Tekst wyjściowy skonfigurowany w agencie AI; działa tylko wtedy, gdy nie ma innego typu elementów bogatych lub specjalnych. Ponadto w przypadku wielu elementów tekstowych w odpowiedzi zwracany jest pierwszy element tekstowy.

   • FullResponse: Pełna odpowiedź ze wszystkimi elementami rozszerzonymi i wieloma komunikatami obecnymi w danych wyjściowych od agenta.

   • Magazyn danych: kod JSON/dykt wszystkich zmiennych sesji zdefiniowanych przez użytkownika w agencie

   • TransactionId: identyfikator transakcji dla żądania w Webex AI Agent Studio

   • SessionId: identyfikator sesji/rozmowy w Webex AI Agent Studio

   • ConsumerId: identyfikator klienta w Webex AI Agent Studio

   • MessageMetadata: metadane skojarzone z bieżącą odpowiedzią skonfigurowanego agenta

   • SessionMetadata: metadane skojarzone z sesją dla bieżącej odpowiedzi od skonfigurowanego agenta

     Obecnie MessageMetadata i SessionMetadata są obsługiwane tylko dla skryptowanych agentów AI za pośrednictwem kanałów cyfrowych.

   • ResponsePayload: Kompletny ładunek odpowiedzi z Webex AI Agent Studio

3. Skonfiguruj następujące zmienne wejściowe w metodzie zamknięcia sesji:

   • Agent: Agent, który przetwarza wiadomość użytkownika i otrzymuje odpowiedź.

     Agenci AI, do których masz dostęp, możesz zobaczyć w Webex AI Agent Studio. Aby uzyskać więcej informacji na temat zarządzania użytkownikami i agentami w Webex AI Agent Studio, zobacz Role użytkowników.

   • Identyfikator sesji: Zamykamy sesję agenta AI. Identyfikator sesji jest dostępny jako zmienna wyjściowa metody komunikatów Process.

Wyniki węzła

Możesz zobaczyć listę możliwych wyników węzła dla tego węzła. Etykiety węzłów można dostosowywać za pomocą ikony Edytuj (ołówkiem). Węzeł wychodzi przez jedną z krawędzi węzła odpowiadającą wynikowi węzła. Każdy węzeł agenta AI odpowiada wynikowi węzła. Oto lista wyników węzłów.

• Błąd (czerwony): oznacza następujące elementy:

  • onError: gdy agent nie odpowiedział komunikatem.

  • onInvalidCustomerID: gdy brakuje identyfikatora klienta.

  • onInvalidMessage: gdy brakuje wartości wiadomości.

• Sukces (zielony): oznacza następujące elementy:

  • onSuccess: gdy agent odpowiada wiadomością.

  • onAgentHandover: gdy agent zgłasza żądanie przekazania agentom.

• Limit czasu (żółty/bursztynowy): oznacza następujące parametry:

  • onTimeOut: gdy agent nie odpowiedział w czasie nie dłuższym niż 15 sekund.