Tools-Übersicht

Übersicht

Tools erlauben deinen KI-Agenten, mehr zu tun als nur Fragen zu beantworten. Mit konfigurierten Tools können Agenten Termine planen, Anrufe weiterleiten, Systeme aktualisieren und sich mit deinen bestehenden Workflows verbinden - alles während eines Live-Gesprächs.

Tools werden automatisch basierend auf dem Gesprächskontext und dem Prompt ausgeführt, den du dem Agenten gibst. Du definierst über Prompt Engineering, wann und wie Tools genutzt werden.

Was sind Tools?

Tools sind vorkonfigurierte Fähigkeiten, die dein Agent während des Gesprächs aufrufen kann, um konkrete Aufgaben zu erledigen. Wenn ein Kunde etwas wie Terminbuchung oder ein Gespräch mit einem Spezialisten anfragt, führt dein Agent automatisch das passende Tool aus.

Wie Tools funktionieren

Während eines Gesprächs entscheidet dein Agent, ob er direkt antwortet oder ein Tool ausführt: Der Agent nutzt Tool-Namen und Beschreibungen, um zu verstehen, was jedes Tool macht. Diese Details helfen dem Modell, im richtigen Moment das richtige Tool zu wählen. Best Practices:

Gib Tools klare, beschreibende Namen, etwa “book_appointment” statt “tool1”
Schreibe detaillierte Beschreibungen, die erklären, was das Tool tut
Füge im Agent Prompt explizite Hinweise dazu ein, wann jedes Tool verwendet werden soll

Während Tool-Namen und Beschreibungen dem Agenten sagen, was ein Tool macht, sollte dein Agent-Prompt festlegen, wann es genutzt wird. Beispiel: “Wenn ein Kunde mit einem Menschen sprechen will, nutze das Tool transfer_to_support.”

Verfügbare Tool-Typen

Im Hinzufügen-Menü des Tabs Tools findest du:

Anruf weiterleiten
Kalenderbuchung
Benutzerdefinierte Aktion
Websuche (Alpha)
Rechner (Profi)
MCP-Server (Profi)

Das Beenden von Anrufen ist kein separat hinzufügbares Tool mehr. Konfiguriere es unter Anrufablauf → Gesprächsende mit KI darf auflegen.

Für die Einrichtung der einzelnen Tools siehe Anruf weiterleiten, Kalenderbuchung, Benutzerdefinierte Aktion, Websuche, Rechner und MCP-Server. Für den Ablauf von Live-Variablen und Ergebnissen lies Gesprächsdatenfluss.

Wann Tools ausgeführt werden

Tools laufen während des Gesprächs, wenn dein Agent sie anhand des Prompts auslöst. Anders als klassische IVR-Systeme, die starren Skripten folgen, nutzen KI-Agenten kontextuelles Verständnis, um zu entscheiden, wann Tools angebracht sind.

Trigger-Mechanismen

Anweisungsbasierte Trigger:

When the customer asks to speak to a human, use the 'Transfer to Support' tool.

When the customer wants to schedule, use the 'Book Consultation' tool after you have the required details.

Wenn der Kunde aktuelle externe Informationen braucht, nutze das Tool 'Websuche'.

Conditional Triggers:

If the customer reports a billing issue:
1. Use the 'Lookup Account' tool to retrieve their information
2. If balance is overdue, transfer to billing department
3. If balance is current, troubleshoot the issue

{% if contact.contact_status == "vip" %}
Always offer to transfer VIP customers to dedicated support immediately.
{% endif %}

Multi-Step Workflows:

Appointment Booking Flow:
Gather required information (name, email, preferred date)
Use 'Check Availability' tool to query Cal.com
Present options to customer
Use 'Book Appointment' tool to confirm
Confirm the booked slot and next steps clearly
End the conversation naturally or rely on **Allow AI to hang up** if you have enabled it in **Conversation** → **Call End**

Tools laufen in Echtzeit während des Anrufs. Stelle sicher, dass verbundene Systeme zuverlässig sind und schnell reagieren, um unangenehme Pausen im Gespräch zu vermeiden.

Tools konfigurieren

Die gesamte Tool-Konfiguration passiert im Agent-Editor unter dem Tab Tools.

Zu Tools navigieren

Öffne deinen Agenten im Editor und klicke auf den Tab Tools

Tool-Typ wählen

Durchsuche die verfügbaren Tools und klicke auf Add, um ein Tool zu konfigurieren

Tool konfigurieren

Fülle das tool-spezifische Formular aus:

Name: Gib deinem Tool einen klaren, beschreibenden Namen
Beschreibung: Erkläre, was dieses Tool tut
Tool-specific settings: Konfiguriere Parameter je nach Tool-Typ

Speichern

Speichere das Tool, damit es zur Werkzeugkiste deines Agenten hinzugefügt wird

Tools-Tabelle

Konfigurierte Tools erscheinen in einer einzigen Tabelle im Tools-Tab. Typische Spalten sind:

Name - Anzeigename des Tools
Typ - Tool-Typ, zum Beispiel Anruf weiterleiten, Kalenderbuchung, Benutzerdefinierte Aktion, Websuche, MCP-Server
Category - Untertyp oder Anbieter-Detail
Details - Wichtige Konfigurationsdetails

Nutze Add, um weitere Tools zu erstellen, klicke eine Zeile zum Bearbeiten und verwende die Entfernen-Aktion zum Löschen.

Tools im Prompt referenzieren

Um Tools zu nutzen, referenziere sie im Prompt mit genauem Namen:

Direkte Referenz

When a customer asks to speak to someone about billing,
use the 'Transfer to Billing Department' tool.

Mit Bedingungen

If the customer's issue cannot be resolved:
Apologize for the inconvenience
Explain you're connecting them to a specialist
Use the 'Transfer to Support' tool

Mit Parametern

After gathering the customer's email and preferred date,
use the 'Book Consultation' tool to schedule the meeting.

Tool-Namen sind case-sensitiv und müssen exakt mit der Konfiguration übereinstimmen. Wenn du ein Tool umbenennst, aktualisiere alle Referenzen in deinem Prompt.

Best Practices für die Konfiguration

Einfach starten

Beginne mit grundlegenden Tools, bevor du komplexe Integrationen hinzufügst. Füge jeweils nur ein Tool hinzu, teste es gründlich und nimm dann das nächste.Beispiel-Reihenfolge:

Transfer to Support hinzufügen
Kalenderbuchung oder Websuche hinzufügen
Custom Action hinzufügen
MCP Server nur dann hinzufügen, wenn du externe Tool-Kataloge brauchst

Klare, beschreibende Namen verwenden

Tool-Namen sind entscheidend, weil das Modell sie benutzt, um zu verstehen, was jedes Tool macht. Nutze beschreibende, handlungsorientierte Namen, die den Zweck klar vermitteln.Warum das wichtig ist: Das Modell stützt sich auf Funktionsnamen und Beschreibungen, um zu erkennen, wann eine Funktion aufgerufen werden muss und welches Tool für die Aufgabe passt.Gute Namen:

“Get Customer Account” - klares Verb + konkretes Ziel
“Transfer to Billing Department” - konkretes Ziel enthalten
“Book 30-Minute Consultation” - relevante Details enthalten

Schlechte Namen:

“Tool 1” - kein Kontext
“Transfer” - zu allgemein
“API Call” - beschreibt das Tool nicht

Detaillierte Beschreibungen schreiben

Tool-Beschreibungen helfen dem Modell zu verstehen, was das Tool tut. Die Beschreibung sollte den Zweck, die Rückgabe und die verwendeten Parameter erklären.Best Practices aus OpenAI function calling:

Klar beschreiben, was das Tool tut und was es zurückgibt
Erklären, welche Parameter oder Daten es verwendet
Präzise Sprache verwenden, die dem Modell hilft
Kurz, aber umfassend bleiben

Beispiel:

Name: Get Customer Account
Beschreibung: Retrieves customer account data from Salesforce CRM using
their phone number. Returns account status, balance, and recent orders.

Hinweis: Beschreibe in der Beschreibung was das Tool tut. Lege in deinem Agent Prompt fest, wann es verwendet werden soll.

Gründlich testen

Teste jedes Tool in der Agent-Testoberfläche, bevor du live gehst:

Prüfe, ob das Tool korrekt ausgeführt wird
Teste Erfolgsfälle
Teste Fehlerfälle
Prüfe das Error-Handling
Kontrolliere den Gesprächsfluss

Fehler elegant behandeln

Konfiguriere Fallback-Verhalten für den Fall, dass Tools fehlschlagen. Sage deinem Agenten, was er tun soll, wenn Tools nicht funktionieren.

If the 'Book Appointment' tool fails:
Apologize sincerely
Offer to have someone call back to schedule
Collect their preferred callback number
Summarize the fallback plan before ending the conversation

Informationen zuerst sammeln

Stelle sicher, dass Agenten die nötigen Daten einsammeln, bevor sie Tools ausführen. Versuche nicht, Termine ohne E-Mail-Adressen zu buchen oder Anrufe ohne Begründung weiterzuleiten.

Before using the 'Book Consultation' tool:
Confirm the customer wants to schedule
Ask for their email address if not in contact record
Discuss their preferred dates and times
Explain what the consultation will cover
Only then execute the booking tool

Zugangsdaten absichern

Verwende geeignete Authentifizierung für alle benutzerdefinierten Tools. Exponiere niemals API-Schlüssel oder Zugangsdaten in URLs oder unverschlüsselten Feldern.

Bearer-Tokens für API-Authentifizierung verwenden
Basic Auth nur über HTTPS einsetzen
Sensible Zugangsdaten sicher speichern
Zugangsdaten regelmäßig rotieren

Tools testen

Einige Tools funktionieren nur bei einem echten Telefonanruf. Weiterleitungen an eine Telefonnummer oder SIP-Adresse können nicht im Web-Simulator getestet werden — die Weiterleitungsaktion erfordert eine echte Telefonieverbindung. Verwende Agent testen → Telefonanruf, um diese zu testen.

Teste vor dem Einsatz von Agenten mit Tools gründlich in der Dashboard-Testoberfläche:

Testoberfläche öffnen

Klicke auf Agent testen in der oberen rechten Ecke des Agenten-Editors.

Testgespräch im Browser starten

Starte das Testgespräch im Browser, um ein Tool-End-to-End zu prüfen.

Jedes Tool auslösen

Führe Szenarien durch, die jedes konfigurierte Tool auslösen.

Ausführung prüfen

Überprüfe, ob Tools korrekt ausgeführt werden und Antworten angemessen verarbeiten.

Fehlerfälle testen

Simuliere Fehler, um sicherzustellen, dass die Fehlerbehandlung wie erwartet funktioniert.

Transkript prüfen

Überprüfe das Gesprächstranskript, um sicherzustellen, dass der Ablauf natürlich ist und Tools reibungslos integriert sind.

Was zu testen ist

Für Weiterleitungs-Tools:

Weiterleitung zum richtigen Ziel
Wartemusik bei Agent-Weiterleitung, sofern konfiguriert
Weiterleitungsnachricht ist angemessen
Cold-Transfer-Verhalten und Fallback-Behandlung funktionieren korrekt

Für Buchungs-Tools:

Verfügbarkeit wird korrekt abgerufen
Buchung wird erfolgreich bestätigt
E-Mail-/SMS-Benachrichtigungen werden korrekt gesendet
Zeitzonenbehandlung ist korrekt

Für benutzerdefinierte Aktionen:

Verbundene Systeme antworten erfolgreich
Authentifizierung funktioniert
Antwortdaten sind für den Agenten verfügbar
Fehlerantworten werden korrekt behandelt

Für alle Tools:

Agent referenziert Tool mit dem richtigen Namen
Agent sammelt zuerst erforderliche Informationen
Gesprächsfluss bleibt natürlich
Fehler unterbrechen das Gespräch nicht

Testanrufe verwenden echte Integrationen. Wenn du ein Buchungs-Tool testest, werden echte Termine in deinem Cal.com-Account erstellt. Bereinige Testdaten anschließend.

Häufige Anwendungsfälle

Kundensupport-Workflow

Agentenkonfiguration:
- Weiterleitung zum Support (für komplexe Probleme)
- Kunden-Account nachschlagen (benutzerdefinierte API)
- Support-Ticket erstellen (benutzerdefinierte API)
- "KI darf auflegen" aktiviert unter Gespräch → Gesprächsende

Anweisungen:
Wenn ein Kunde anruft:
1. Begrüße ihn freundlich
2. Verwende "Kunden-Account nachschlagen", um seine Informationen abzurufen
3. Frage nach seinem Anliegen
4. Wenn du es lösen kannst, tue es mithilfe der Wissensdatenbank
5. Bei komplexen Problemen verwende "Support-Ticket erstellen" und gib die Ticketnummer an
6. Wenn der Kunde einen Menschen wünscht, verwende "Weiterleitung zum Support"
7. Bei Lösung bestätige die nächsten Schritte und beende natürlich

Terminbuchungs-Workflow

Agentenkonfiguration:
- Beratung buchen (Cal.com-Buchung)
- Weiterleitung zur Terminplanung (Fallback)
- "KI darf auflegen" aktiviert unter Gespräch → Gesprächsende

Anweisungen:
Wenn ein Kunde einen Termin buchen möchte:
1. Frage, welche Art von Termin benötigt wird
2. E-Mail-Adresse erfragen, falls nicht im Kontaktdatensatz
3. Bevorzugte Termine besprechen
4. Verwende "Beratung buchen", um Verfügbarkeit anzuzeigen und zu bestätigen
5. Bei erfolgreicher Buchung Details mündlich bestätigen
6. Bei fehlgeschlagener Buchung "Weiterleitung zur Terminplanung" verwenden
7. Gespräch nach Bestätigung des Ergebnisses natürlich beenden

Verkaufsqualifizierungs-Workflow

Agentenkonfiguration:
- Unternehmensdaten nachschlagen (benutzerdefinierte API)
- CRM-Lead aktualisieren (benutzerdefinierte API)
- Weiterleitung zum Vertrieb (für qualifizierte Leads)
- "KI darf auflegen" aktiviert unter Gespräch → Gesprächsende

Anweisungen:
Für ausgehende Verkaufsanrufe:
1. Stelle dich und den Zweck vor
2. Verwende "Unternehmensdaten nachschlagen", um Firmendaten abzurufen
3. Stelle Qualifizierungsfragen (Budget, Zeitplan, Entscheidungsbefugnis)
4. Verwende "CRM-Lead aktualisieren" mit Qualifizierungsstatus
5. Bei Qualifizierung "Weiterleitung zum Vertrieb" mit Kontext verwenden
6. Bei fehlender Qualifizierung bedanke dich und beende das Gespräch natürlich

Häufige Probleme beheben

Tool wird nicht ausgelöst

Problem: Agent verwendet das Tool nicht, obwohl er sollte.Lösungen:

Überprüfe, ob der Tool-Name im Prompt exakt übereinstimmt (Groß-/Kleinschreibung beachten)
Stelle sicher, dass das Tool in der Tools-Tabelle vorhanden ist und eine erforderliche Integration verbunden ist
Mache deinen Prompt expliziter, wann das Tool verwendet werden soll
Teste isoliert, indem du den Agenten explizit auffordest, das Tool zu verwenden
Überprüfe das Gesprächstranskript, um die Überlegungen des Agenten zu sehen

Agent kündigt Tool an, führt es aber nicht aus

Problem: Agent bestätigt mündlich die Ausführung eines Tools (z.B. “Ich leite dich jetzt weiter”), aber das Tool wird erst im nächsten Gesprächszug ausgeführt.Warum das passiert: Der Agent generiert eine Antwort und führt das Tool im selben Zug aus, aber nur eines kann pro Zug passieren.Lösung: Weise den Agenten an, vor der Tool-Ausführung eine Bestätigung einzuholen:

Bevor du das Tool "Weiterleitung zum Support" verwendest:
Erkläre, warum du weiterleitest
Frage: "Soll ich dich jetzt weiterleiten?"
Warte auf Bestätigung
Nach Bestätigung führe das Tool "Weiterleitung zum Support" aus

So stellt der Agent sicher, dass das Tool sofort nach der Bestätigung ausgeführt wird, nicht im selben Zug wie die Ankündigung.

Authentifizierungsfehler

Problem: Benutzerdefinierte Tools schlagen mit 401/403-Fehlern fehl.Lösungen:

Überprüfe, ob Zugangsdaten korrekt und nicht abgelaufen sind
Prüfe, ob der Authentifizierungstyp den Anforderungen des verbundenen Systems entspricht
Stelle sicher, dass Bearer-Tokens ggf. den Präfix “Bearer” enthalten
Bitte den Eigentümer des verbundenen Systems zu bestätigen, dass die Verbindung außerhalb des Agenten funktioniert
Überprüfe die Authentifizierungsanforderungen des verbundenen Systems

Buchungsaktion schlägt fehl

Problem: Das Cal.com-Buchungs-Tool gibt Fehler zurück.Lösungen:

Überprüfe, ob die Cal.com-Integration verbunden ist
Prüfe, ob der Event-Typ vorhanden und aktiv ist
Stelle sicher, dass die Meeting-Plattform in Cal.com konfiguriert ist
Überprüfe, ob Planungsfenster die angeforderten Termine zulassen
Zeitzonenkonfiguration prüfen
Teste die Buchung manuell in Cal.com, um die Verfügbarkeit zu prüfen

Weiterleitung stellt keine Verbindung her

Problem: Das Weiterleitungs-Tool wird ausgeführt, stellt aber keine Verbindung her.Lösungen:

Überprüfe, ob das Ziel im korrekten E.164-Format vorliegt (z.B. +49151234567)
Stelle sicher, dass die Telefonnummer erreichbar ist (bei Telefon-Weiterleitungen)
Überprüfe, ob die SIP-Adresse korrekt ist (bei SIP-Weiterleitungen)
Teste das Ziel unabhängig

Nächste Schritte

Weiterleitungs-Tools

Ziele, Modi, Routing-Muster und Gesprächsende konfigurieren

Buchungsintegration

Cal.com-Terminplanung mit E-Mail- und SMS-Benachrichtigungen einrichten

Benutzerdefinierte Aktion

Agenten mit externen Systemen und APIs verbinden

Gesprächsdatenfluss

Verstehen, wie Werte in Live-Tools und Post-Call-Workflows fließen

Prompt

Effektive Agenten-Prompts schreiben

Prompt Engineering

Fortgeschrittene Prompt-Techniken für zuverlässiges Agentenverhalten

Häufige Fragen

Spielt der Tool-Name eine Rolle?

Ja. Der Agent wählt Tools basierend auf dem von dir angegebenen Namen und der Beschreibung aus. Verwende klare, beschreibende Namen wie “Weiterleitung zum Vertrieb” oder “Termin buchen” — nicht “Tool 1” oder “Aktion A”. Namen unterscheiden zwischen Groß- und Kleinschreibung.

Kann ich Tools ohne Programmierung hinzufügen?

Integrierte Tools (Anruf weiterleiten, Kalenderbuchung, Websuche) erfordern keinen Code. Benutzerdefinierte API-Aktionen benötigen einen aufzurufenden API-Endpunkt, werden aber vollständig in der Benutzeroberfläche konfiguriert — kein SDK oder serverseitiger Code erforderlich.

Was passiert, wenn ein Tool während eines Anrufs fehlschlägt?

Der Agent erhält die Fehlerantwort und kann damit umgehen, wenn dein Prompt Fallback-Anweisungen enthält. Überprüfe die Gesprächszeitleiste, um die genaue Anfrage und Antwort für jeden Tool-Aufruf zu sehen.

​Übersicht

​Was sind Tools?

​Wie Tools funktionieren

​Verfügbare Tool-Typen

​Wann Tools ausgeführt werden

​Trigger-Mechanismen

​Tools konfigurieren

​Tools-Tabelle

​Tools im Prompt referenzieren

​Direkte Referenz

​Mit Bedingungen

​Mit Parametern

​Best Practices für die Konfiguration

​Tools testen

​Was zu testen ist

​Häufige Anwendungsfälle

​Kundensupport-Workflow

​Terminbuchungs-Workflow

​Verkaufsqualifizierungs-Workflow

​Häufige Probleme beheben

​Nächste Schritte

Weiterleitungs-Tools

Buchungsintegration

Benutzerdefinierte Aktion

Gesprächsdatenfluss

Prompt

Prompt Engineering

​Häufige Fragen

Übersicht

Was sind Tools?

Wie Tools funktionieren

Verfügbare Tool-Typen

Wann Tools ausgeführt werden

Trigger-Mechanismen

Tools konfigurieren

Tools-Tabelle

Tools im Prompt referenzieren

Direkte Referenz

Mit Bedingungen

Mit Parametern

Best Practices für die Konfiguration

Tools testen

Was zu testen ist

Häufige Anwendungsfälle

Kundensupport-Workflow

Terminbuchungs-Workflow

Verkaufsqualifizierungs-Workflow

Häufige Probleme beheben

Nächste Schritte

Häufige Fragen