Zum Hauptinhalt springen
Custom Tools ermöglichen es deinen KI-Agenten, auf externe Informationen zuzugreifen, indem sie sich mit deinen APIs verbinden.

​
So funktioniert es

​
Einrichtung

1

Zu den Agenten-Einstellungen navigieren

Gehe zu den Einstellungen deines Agenten
2

Custom Tool hinzufügen

Klicke im Bereich Tools auf + Add, um ein neues Custom Tool zu erstellen
3

Grundeinstellungen konfigurieren

Fülle die Konfiguration aus:
FeldBeschreibung
NameBezeichner für dein Tool (z. B. check_account_balance)
DescriptionWas das Tool macht und wann es verwendet werden soll.
HTTP MethodGET, POST, PUT, PATCH oder DELETE
URLDein API-Endpoint (muss HTTPS verwenden)
Response Timeout1-10 Sekunden
4

Parameter hinzufügen

Konfiguriere Header, Query-Parameter und Request-Body mit den unten aufgeführten Werttypen
5

System-Prompt aktualisieren (optional)

Füge Geschäftsregeln und Gesprächsabläufe für die Nutzung des Tools im System-Prompt deines Agenten hinzu

​
Werttypen

Verwende diese Werttypen für Header, Query-Parameter und Request-Body:
TypBeschreibungAnwendungsfall
ConstantStatische WerteFeste Konfiguration
System VariableKontakt-/AnrufdatenKunden-E-Mail, Telefonnummer
LLM ParameterKI-extrahiert aus dem GesprächKontonummern, Produkt-IDs
SecretVerschlüsselte sensible DatenAuth-Tokens, Passwörter

​
System Variable

Um Kontakt- und Anrufdaten zu deiner Anfrage hinzuzufügen, kannst du zwei verfügbare Typen verwenden: Standardfelder: Eingebaute Kontakt- und Anrufinformationen
  • contact.firstName, contact.lastName, contact.phoneNumber, contact.externalId
  • call.id
Verwende das Dropdown in der Benutzeroberfläche, um alle verfügbaren Variablen zu durchsuchen. Contact Details: Benutzerdefinierte Felder, die du pro Kontakt definierst (Zugriff über contact.contactDetails.*)
  • Beispiel: contact.contactDetails.customerId, contact.contactDetails.accountTier

​
LLM Parameter

Die KI extrahiert diese Werte aus dem Gespräch, indem sie Fragen stellt oder aus dem Kontext ableitet. Wenn du einen LLM Parameter konfigurierst, gibst du Folgendes an:
  • Name: Der Parametername in der API-Anfrage
  • Description: Anweisungen für die KI, was extrahiert werden soll und das erwartete Format
  • Data Type: String, Number oder Boolean
Die KI nutzt die Description, um zu verstehen, wann und wie sie diese Information vom Kunden erfassen soll. Beispiel: Ein Parameter namens account_number mit der Beschreibung “Customer’s account number (format: ACC-12345)” weist die KI an, eine Kontonummer in diesem Format abzufragen und zu extrahieren.