> ## Documentation Index
> Fetch the complete documentation index at: https://aipro.placetel.de/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools Guide

> Tools im Voice Wizard und Sidebar -- gemeinsame Funktionen für alle Voice Agents.

## Überblick

**Tools** sind Funktionen, die Ihre Voice Agents während eines Gesprächs ausführen können. Sie erweitern die Fähigkeiten Ihrer Bots über einfache Text-Antworten hinaus -- z.B. können Tools externe APIs aufrufen, Termine buchen, SMS versenden oder E-Mails schreiben.

Tools finden Sie an zwei Stellen in der Anwendung:

* **Sidebar**: Hier verwalten Sie alle verfügbaren Tools global
* **Voice Wizard**: Hier weisen Sie Tools einem spezifischen Voice Agent zu und konfigurieren bot-spezifische Bedingungen

## Gemeinsames Konzept -- Wichtig zu verstehen!

<Tip>
  **Zentrales Konzept:** Tools sind **gemeinsam für alle Voice Agents** verfügbar!

  Das bedeutet: Ein Tool, das Sie einmal erstellen, steht automatisch **allen Ihren Voice Agents** zur Verfügung. Sie müssen es nicht für jeden Bot neu anlegen. Dies ist ein fundamentales Konzept unserer Anwendung und ermöglicht:
</Tip>

* Zentrale Verwaltung aller Funktionen
* Konsistente Konfiguration über alle Bots hinweg
* Effizienz beim Erstellen neuer Voice Agents
* Einfache Wartung und Updates

Sie definieren also ein Tool **einmal global** in der Sidebar, und können es dann in **jedem Voice Agent** im Voice Wizard aktivieren und individuell anpassen.

## Wo werden Tools verwaltet?

### Sidebar (Globale Verwaltung)

Hier sehen Sie eine Übersicht aller verfügbaren Tools für Ihren gesamten Account. Sie können:

* Neue Tools erstellen
* Bestehende Tools bearbeiten oder löschen
* Globale Bedingungen definieren (wann ein Tool ausgeführt werden soll)
* Tools testen
* Allgemeine Einstellungen vornehmen

### Voice Wizard (Bot-spezifische Konfiguration)

Im Voice Wizard können Sie für jeden einzelnen Voice Agent:

* Tools aktivieren oder deaktivieren
* Die globale Bedingung mit einer bot-spezifischen **Bedingung (Override)** überschreiben

## Tool-Typen

### Vordefinierte Tools (Predefined)

Diese **3 System-Tools** sind bereits in der Anwendung integriert und stehen immer zur Verfügung:

| Tool-Name                         | Beschreibung                                                                                                                                                                                                         |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Anruf beenden**                 | Beendet das aktuelle Gespräch. Wird typischerweise verwendet, wenn der Kunde sich verabschiedet oder das Anliegen vollständig geklärt ist.                                                                           |
| **Anrufer-Informationen abrufen** | Ruft Informationen über den aktuellen Anrufer ab (z.B. Telefonnummer und Zeitzone). Nützlich für Personalisierung und Kontext.                                                                                       |
| **Absichtserkennung**             | Erkennt die Absicht des Anrufers und leitet ihn basierend auf dieser Absicht weiter (z.B. zu einem anderen Prompt oder einer Rufnummer). Wird automatisch aktiviert, wenn Sie Intents im Voice Wizard konfigurieren. |

<Info>
  **Hinweis:** Diese vordefinierten Tools können nicht gelöscht werden und sind fest in das System integriert. Sie können jedoch für jeden Voice Agent individuell aktiviert oder deaktiviert werden.
</Info>

### Benutzerdefinierte Tools (Custom)

Diese Tools erstellen Sie selbst, basierend auf Ihren spezifischen Anforderungen:

| Tool-Typ          | Beschreibung & Verwendung                                                                                                                                                         |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **API-Anfragen**  | Ermöglicht die Integration externer Systeme und Datenquellen über REST-APIs. *Beispiele: Daten aus Ihrem CRM abrufen, Bestellstatus prüfen, Informationen aus Ihrem System laden* |
| **Terminbuchung** | Integration mit Kalender-Systemen (z.B. Cal.com) zum Buchen von Terminen. *Beispiele: Beratungsgespräche, Service-Termine, Rückruf-Vereinbarungen*                                |
| **n8n-Workflows** | Triggert n8n-Workflows für komplexe Automatisierungen. *Beispiele: Multi-Step-Prozesse, Datenverarbeitung, System-Synchronisationen*                                              |
| **SMS**           | Versendet SMS-Nachrichten an den Anrufer oder andere Empfänger. *Beispiele: Bestätigungen, Terminerinnerungen, Zugangscodes*                                                      |
| **E-Mail**        | Versendet E-Mails während oder nach dem Gespräch. *Beispiele: Gesprächszusammenfassungen, Dokumente, Follow-ups*                                                                  |

## Was sind Bedingungen?

**Bedingungen** sind Regeln, die der KI helfen zu entscheiden, **wann ein Tool verwendet werden soll**. Sie beschreiben den Kontext oder die Voraussetzungen für den Einsatz eines Tools.

### Typische Elemente einer Bedingung

* **Intention/Schlüsselwörter:** "wenn der Kunde einen Termin buchen möchte", "wenn nach einer Bestellung gefragt wird"
* **Parameter-Vollständigkeit:** "nur wenn ein Datum genannt wurde", "nur wenn die E-Mail-Adresse bekannt ist"
* **Geschäftslogik:** "nur während Geschäftszeiten", "nur für authentifizierte Anrufer"

<Warning>
  **Wichtig:** Bedingungen sind **optional**! Ohne Bedingung kann die KI das Tool jederzeit aufrufen, wenn sie es für sinnvoll hält. Mit einer guten Bedingung kontrollieren Sie präzise, wann das Tool zum Einsatz kommt.
</Warning>

## Globale Bedingung vs. Override

Da Tools gemeinsam für alle Voice Agents verfügbar sind, gibt es zwei Ebenen für Bedingungen:

### 1. Globale Bedingung (in Sidebar)

Die **globale Bedingung** wird beim Erstellen eines Tools definiert und gilt standardmäßig für **alle Voice Agents**, die dieses Tool verwenden.

<Accordion title="Beispiel: Globale Bedingung für Terminbuchung">
  ```
  Verwende dieses Tool, wenn der Kunde explizit einen Termin vereinbaren möchte und ein gewünschtes Datum genannt hat.
  ```

  Diese Regel gilt jetzt für **alle** Voice Agents, die das Terminbuchungs-Tool aktiviert haben.
</Accordion>

### 2. Override / Lokale Bedingung (im Voice Wizard)

Im Voice Wizard können Sie für einen **spezifischen Voice Agent** die globale Bedingung mit einer **lokalen Bedingung überschreiben**.

<Accordion title="Beispiel: Override für Support-Bot">
  ```
  Verwende dieses Tool nur, wenn der Kunde explizit sagt "Ich möchte einen Termin buchen" UND die Öffnungszeiten (Mo-Fr 9-17 Uhr) nennt. Wenn keine Uhrzeit genannt wurde, frage nach: "Zu welcher Uhrzeit möchten Sie kommen?"
  ```

  Dieser Support-Bot ist **restriktiver** und verlangt explizite Bestätigung vom Kunden.
</Accordion>

<Info>
  **Priorität:** Die **lokale Bedingung (Override)** hat immer Vorrang!

  * Wenn ein Override definiert ist, wird die globale Bedingung durch die lokale Bedingung ersetzt
  * Wenn kein Override definiert ist, gilt die globale Bedingung
</Info>

## Häufig gestellte Fragen (FAQ)

### Werden globale Änderungen sofort in allen Agents wirksam?

Ja, wenn Sie ein Tool global ändern, wirkt sich das sofort auf alle Voice Agents aus, die dieses Tool **aktiviert haben** -- **außer** ein Agent hat einen Override definiert. In diesem Fall gilt weiterhin der Override.

### Was passiert, wenn keine Bedingung definiert ist?

Das Tool steht der KI zur Verfügung und kann jederzeit aufgerufen werden, wenn die KI es für sinnvoll hält. Bedingungen sind optional, aber empfohlen für präzise Kontrolle.

### Können mehrere Tools nacheinander ausgeführt werden?

Ja, die KI kann mehrere Tools in einem Gespräch nutzen. Sie steuern die Voraussetzungen über Bedingungen.

### Wo lege ich die globale Bedingung an?

In der **Sidebar** beim jeweiligen Tool. Klicken Sie auf "Bearbeiten" und geben Sie die Bedingung im entsprechenden Feld ein.

### Wo überschreibe ich die Bedingung für einen spezifischen Bot?

Im **Voice Wizard** bei der Tool-Konfiguration des jeweiligen Voice Agents. Dort finden Sie ein Feld für die bot-spezifische Bedingung (Override).

### Kann ich ein Tool deaktivieren?

Global können Sie ein Tool nur löschen. Pro Voice Agent können Sie im Voice Wizard Tools individuell deaktivieren. Ein deaktiviertes Tool steht diesem spezifischen Voice Agent nicht zur Verfügung.

### Muss ich für die vordefinierten Tools auch Bedingungen definieren?

Nein, die vordefinierten Tools (Anruf beenden, Anrufer-Info, Intent-Erkennung) haben bereits sinnvolle Standard-Bedingungen. Sie können diese aber überschreiben, wenn Sie ein anderes Verhalten wünschen.

### Kann ich Bedingungen in mehreren Sprachen definieren?

Ja, Sie können Bedingungen in Deutsch, Englisch oder jeder anderen Sprache schreiben. Die KI versteht natürliche Sprache. Bleiben Sie aber konsistent innerhalb eines Tools.