Narzędzia agentowe dla agentów AI 3CX

Wprowadzenie

Narzędzia agentowe umożliwiają agentom interakcję z centralą PBX i osobami dzwoniącymi, wykonując funkcje takie jak przełączanie połączeń i pobieranie informacji. W tym dokumencie wymieniamy narzędzia dostępne dla każdego typu agenta wraz z ich funkcjami.

Podstawy użytkowania i formatowania

Prompty agenta AI 3CX wykorzystują składnię Mustache. Ta sekcja zawiera omówienie tej składni. Zrozumienie tych zasad zapewnia dokładną integrację narzędzi agentowych z promptami agenta AI 3CX.

• Zmienne są wywoływane przy użyciu składni Mustache poprzez umieszczenie identyfikatora w nawiasach klamrowych.

• {{...}} lub {{{...}}}  -> (bez #, ^ lub /) wyświetla surową zawartość zmiennej bezpośrednio w tym miejscu (bez konwersji znaków specjalnych HTML).
• Możemy zamknąć sekcję promptu w bloku; treść zostanie wygenerowana w końcowym tekście promptu tylko wtedy, gdy zmienna przejdzie test.

• Mamy opcję wykonania testu pozytywnego:

• {{#...}} -> blok otwiera się tylko wtedy, gdy zmienna ma zawartość lub ma wartość TRUE.
• {{/…}} -> zamknięcie bloku.

• lub testu negatywnego:

• {{^...}} -> blok otwiera się tylko wtedy, gdy zmienna jest pusta lub ma wartość FALSE.
• {{/…}} -> zamknięcie bloku.

• Narzędzia agentowe mogą być „wywoływane” po nazwie, ale agent AI uruchamia je wtedy, gdy uzna, że są potrzebne.

Poniżej znajdują się dwa przykłady, z których oba wykorzystują miejsca docelowe przekierowania „Route By Topic” (Kieruj według tematu), które definiujesz w zakładce „Call Routing” (Routing połączeń) agenta AI 3CX.

W naszych przykładach użyjemy:

• zmiennej addressbook_topics – ta zmienna zawiera wszystkie skonfigurowane wpisy „Route by Topic”; jest ona wypełniana tematami przy każdym (re)starcie agenta; pełni funkcję zmiennej systemowej.
• narzędzia get_addressbook – narzędzie agentowe, które pobiera skonfigurowane wpisy tematów na żądanie.
• narzędzia resolve_handoff_destination – narzędzie agentowe, które rozpoznaje prośby sformułowane w języku naturalnym i dopasowuje je do miejsc docelowych (numerów wewnętrznych).

Przykład 1

Narzędzia agentowe mogą być wymienione w głównym prompcie wraz ze wskazówkami dla agenta AI dotyczącymi ich użycia, co pozwala mu swobodnie decydować, kiedy je wywołać.

If the caller asks for a department or makes a question about a problem first use get_addressbook to check if there are topics related to the question, and use resolve_handoff_destination right away, do not answer informatively first.



W powyższym przykładzie, ten dodatek do promptu poinformuje model AI, jakie narzędzia są dostępne, a następnie pozwoli mu zdecydować, czy powinny zostać wywołane. Powyższy tekst zawsze będzie istniał w końcowym, przetworzonym prompcie, niezależnie od tego, czy ustawiono jakiekolwiek tematy.

Przykład 2

Możesz również użyć składni Mustache, aby dodać podstawową logikę do konstrukcji promptu, pomijając elementy, gdy nie są potrzebne; może to skutkować bardziej zwartym lub przejrzystym promptem końcowym.

{{#addressbook_topics}}

If the caller asks for a department or makes a question about a problem check if there are topics related to the question in the following list:

{{addressbook_topics}}

and use resolve_handoff_destination right away, do not answer informatively first.

{{/addressbook_topics}}

{{^addressbook_topics}}

Use resolve_handoff_destination right away, do not answer informatively first.

{{/addressbook_topics}}



W tym przykładzie:

• Najpierw sprawdzasz, czy addressbook_topics są ustawione/istnieją, a jeśli tak,

• wyświetlasz listę tych tematów w prompcie, aby agent AI mógł

• użyć narzędzia resolve_handoff_destination do znalezienia najlepszego miejsca docelowego dla połączenia, biorąc pod uwagę listę tematów (oraz swoją wiedzę o Twoich działach i numerach wewnętrznych użytkowników/systemowych).

• Następnie, jeśli addressbook_topics nie są ustawione,

• nie „zanieczyszczasz” promptu dodatkowym tekstem i pustą listą, zamiast tego prosisz go o

• użycie narzędzia resolve_handoff_destination do znalezienia najlepszego miejsca docelowego dla połączenia na podstawie jego wiedzy o Twoich działach i numerach wewnętrznych użytkowników/systemowych.

W centrali PBX, gdzie skonfigurowano jeden temat: „For any electrical issues: 106”, powyższa definicja promptu wygenerowałaby następujący końcowy tekst dla agenta AI:

If the caller asks for a department or makes a question about a problem check if there are topics related to the question in the following list:

- For any elecrical issues

and use resolve_handoff_destination right away, do not answer informatively first.



Należy zauważyć, że agenci AI posiadają już wiedzę o tych narzędziach i ich możliwościach. W standardowym połączeniu przy użyciu domyślnych promptów, agent może z nich korzystać bez wyraźnych instrukcji. Jeśli jednak chcesz wpłynąć na zachowanie agenta lub wymusić ścisłą sekwencję wykonywania działań, możesz poinstruować go do bezpośredniego wywoływania narzędzi wewnątrz promptu, jak pokazano powyżej.

Narzędzia agentowe na czacie

Prompt agenta AI jest wspólny dla każdego agenta, niezależnie od kanału komunikacji – głosowego lub tekstowego/czatu. Poniższe opisy narzędzi koncentrują się na kanale głosowym i w większości przypadków będą działać identycznie również na czacie.

Niektóre narzędzia wykonujące routing połączeń głosowych, takie jak przekierowanie na pocztę głosową, oczywiście nie będą działać w komunikacji tekstowej, a inne będą wykonywać swoje akcje nieco inaczej, ale w ramach poniższej specyfikacji.

Narzędzia agentowe według typu agenta

Narzędzia agentowe – dane wejściowe i wyniki (input/output)

Zobacz również

• Konfiguracja OpenAI dla agentów AI 3CX
• Konfiguracja agenta obsługi klienta

Ostatnia aktualizacja
Ten dokument został ostatnio zaktualizowany 5 sierpnia 2026 r.
https://www.3cx.pl/docs/agentic-ai-tools/