> ## 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 hinzufügen

> Dem Agent Funktionen geben, die er während eines Gesprächs aufrufen kann.

Ein Tool ist eine Funktion, die der Telefonassistent mitten im Anruf aufrufen
kann: einen Termin nachschlagen, ein Ticket anlegen, eine Bestellung prüfen.
Dein Token braucht `tools:read` und `tools:write`; ein Tool zum Test
auszuführen braucht zusätzlich `tools:execute`.

## 1. Sehen, was möglich ist

> Welche Tool-Typen können wir erstellen, und welche Tools gibt es schon?

Der Assistent listet die Typen (`list_tool_types`) und deine bestehenden Tools
(`list_tools`). Nur Typen, die als per API erstellbar markiert sind, lassen sich
hier einrichten. Kalender- und andere Integrationstools brauchen zuerst eine im
Dashboard verbundene Integration.

## 2. Das Tool beschreiben

Gib dem Assistenten die API-Dokumentation oder eine Beispielanfrage:

> Erstelle ein Tool, das die nächsten freien Werkstatttermine holt. GET
> [https://api.example.com/slots?date=YYYY-MM-DD](https://api.example.com/slots?date=YYYY-MM-DD), Header X-Api-Key. Der Agent
> soll es aufrufen, wenn ein Anrufer nach einem Termin fragt.

Der Assistent entwirft die Funktionsdefinition (Name, Beschreibung, Parameter,
Anfrage) und erstellt sie (`create_tool`). Bevor du bestätigst, prüfe:

* URL und Methode stimmen, und das Zugangsdatum ist ein Platzhalter, nicht in
  den Chat eingefügt.
* Die Beschreibung sagt, *wann* der Agent das Tool aufrufen soll und was es
  zurückgibt.
* Parameter, die der Anrufer liefern muss, sind markiert, mit einem Hinweis,
  wie danach zu fragen ist.

Die Anleitung [Externe API-Integration](https://aipro.placetel.de/docs/de/external-api-integration.md) erklärt,
wie sich diese Funktionen im laufenden Gespräch verhalten.

## 3. Aktivieren und dem Agent sagen

Der Assistent aktiviert das Tool für deinen Agent (`enable_tool`) und
bestätigt mit `list_tools`, dass `is_active` gesetzt ist. Lass ihn dann eine
Zeile in die Anweisungen aufnehmen, wann das Tool zu nutzen ist; ein Tool, das
der Prompt nie erwähnt, wird selten aufgerufen. `disable_tool` schaltet es
wieder aus, ohne es zu löschen.

## 4. Vorsichtig testen

> Führe das Termin-Tool für morgen aus und zeig mir die Rohantwort.

`execute_tool` ruft den echten Endpunkt auf.

> [!WARNING]
>
> Das ist kein Probelauf. Ein Test kann echte Termine anlegen, Nachrichten
> senden oder Daten im verbundenen System ändern.

Spätere Änderungen an einem Tool laufen über `update_tool`. Nur Tools vom Typ
`external:api` lassen sich löschen (`delete_tool`); Integrationstools
verwaltest du im Dashboard.

Weiter: [Überwachen und verbessern](https://aipro.placetel.de/docs/de/mcp/monitoring.md) anhand echter Anrufe.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.