3CX KI-Agententools

Einführung

Agententools ermöglichen es Agenten, mit der Telefonanlage und Anrufern zu interagieren und Funktionen wie Anrufweiterleitung und Informationsabfrage durchzuführen. In diesem Dokument listen wir die für jeden Agententyp verfügbaren Tools zusammen mit ihrer Funktion auf.

Grundlagen der Verwendung und Formatierung

Die Ansagen des 3CX AI-Agenten verwenden die Mustache-Syntax. Dieser Abschnitt bietet einen Überblick über die Syntax. Das Verständnis dieser Regeln gewährleistet die korrekte Integration von Agenten-Tools in die Ansagen des 3CX AI-Agenten.

• Variablen werden mit der Mustache-Syntax aufgerufen, indem der Bezeichner in geschweifte Klammern gesetzt wird.

• {{...}} or {{{...}}}  -> (no #, ^ or /) gibt den Rohinhalt einer Variablen direkt an diesen Ort zurück (kein Echo) (kein HTML-Escape).
• Wir können einen Eingabeaufforderungsabschnitt in einen Block einbetten; der Inhalt wird im endgültigen Eingabeaufforderungstext nur dann angezeigt, wenn eine Variable einen Test besteht.

• Wir haben die Möglichkeit, einen positiven Test durchzuführen.

• {{#...}} -> Der Block öffnet sich nur, wenn die Variable einen Inhalt hat oder den Wert TRUE hat.
• {{/…}} -> Block schließen

• oder ein negatives Testergebnis:

• {{^...}} -> Der Block öffnet sich nur, wenn die Variable leer oder FALSE ist.
• {{/…}} -> Block schließen

• Agentische Werkzeuge können zwar namentlich "aufgerufen" werden, der KI-Agent ruft sie jedoch erst dann auf, wenn er feststellt, dass sie benötigt werden.

Nachfolgend finden Sie zwei Beispiele, die beide die Anrufweiterleitungsziele gemäß Route By Topic verwenden, die Sie auf der Registerkarte „Anrufweiterleitung“ des 3CX AI Agent definiert haben.

In unseren Beispielen verwenden wir:

• Variable `addressbook_topics` – Diese Variable enthält alle von Ihnen konfigurierten Routen-nach-Themen-Einträge. Sie wird bei jedem (Neu-)Start des Agenten mit den Themen befüllt und fungiert als Systemvariable.
• Tool `get_addressbook` – Ein Agenten-Tool, das die konfigurierten Themeneinträge bei Bedarf abruft.
• Tool `resolve_handoff_destination` – Ein Agenten-Tool, das natürlichsprachliche Anfragen an Ziele (Nebenstellen) auflöst.

Beispiel 1

Agentische Werkzeuge können in der Kernaufforderung erwähnt werden, zusammen mit Hinweisen für den KI-Agenten zu deren Verwendung, sodass dieser frei entscheiden kann, wann er sie aufruft.

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.



Im obigen Beispiel teilt diese Ergänzung der Eingabeaufforderung dem KI-Modell mit, welche Werkzeuge verfügbar sind, und ermöglicht es ihm anschließend zu entscheiden, ob diese aufgerufen werden sollen oder nicht. Der obige Text ist in der endgültigen, aufgelösten Eingabeaufforderung immer enthalten, unabhängig davon, ob Themen festgelegt wurden.

Beispiel 2

Sie können auch die Mustache-Syntax verwenden, um der Prompt-Konstruktion eine grundlegende Logik hinzuzufügen und Elemente zu überspringen, wenn sie nicht benötigt werden; dies kann zu einem kompakteren oder übersichtlicheren endgültigen Prompt führen.

{{#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}}



In diesem Beispiel:

• Zuerst prüfen wir, ob addressbook_topics gesetzt sind/existieren. Falls ja,

• geben wir eine Liste dieser Themen in die Eingabeaufforderung des KI-Agenten ein, damit dieser

• mithilfe des Tools resolve_handoff_destination das beste Ziel für den Anruf anhand der Themenliste (und seines Wissens über unsere Abteilungen und Nutzer-/Systemdurchwahlen) ermitteln kann.

• Wenn also keine addressbook_topics festgelegt sind,

• wird das Prompt nicht mit zusätzlichem Text und einer leeren Liste „überladen“, sondern stattdessen

• das Tool resolve_handoff_destination verwenden, um das beste Ziel für den Anruf zu finden, basierend auf dessen Kenntnissen über unsere Abteilungen und Benutzer-/Systemdurchwahlen.

In einer PBX-Anlage, in der ein einzelnes Thema konfiguriert wurde: „Für alle elektrischen Probleme: 106“, würde die obige Eingabeaufforderungsdefinition den folgenden endgültigen Prompttext darstellen, dem der AI-Agent folgen soll:

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.



Es ist zu beachten, dass KI-Agenten diese Tools und ihre Funktionen bereits kennen. Bei einem Standardaufruf mit Standardansagen kann der Agent sie ohne explizite Anweisungen nutzen. Um das Verhalten des Agenten zu beeinflussen oder eine bestimmte Ausführungsreihenfolge festzulegen, können Sie ihn jedoch anweisen, die Tools direkt in der Ansage aufzurufen, wie oben gezeigt.

Agentische Tools im Chat

Die KI-Agentenansage ist für jeden Agenten unabhängig vom Kommunikationskanal (Sprache oder Text/Chat) gleich. Die folgenden Toolbeschreibungen konzentrieren sich auf den Sprachkanal und funktionieren in den meisten Fällen auch im Chat identisch. Bestimmte Tools zur Anrufweiterleitung, wie z. B. die Umleitung zur Voicemail, funktionieren natürlich nicht in der textbasierten Kommunikation. Andere Tools verhalten sich etwas anders, aber innerhalb der unten stehenden Spezifikation.

Agententools nach Agententyp

Agentische Werkzeuge, Eingaben und Ausgaben

Siehe auch

• OpenAI für 3CX-KI-Agenten konfigurieren
• Kundendienstagenten konfigurieren

Letztes Update
Dieses Dokument wurde zuletzt am 21. August 2026 aktualisiert.
https://www.3cx.de/docs/agentic-ai-tools/