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

# Agent Tools

> Ein workspace-weiter Katalog eigener Tools und vorgefertigter Connectors, die jeder Assistent aufrufen kann

Assistenten wirken über Tools auf die Welt – Aktionen, die sie während eines Gesprächs ausführen können. Unter **Agent Tools** (`/tools` in der Seitenleiste, unter **Agents**) baust du eigene Tools einmal und verbindest vorgefertigte, sodass jeder Assistent im Workspace sie nutzen kann.

<Note>
  Agent Tools ist workspace-weit: Ein Tool existiert hier einmal und wird beliebig vielen Assistenten zugewiesen. Der eigene **Tools**-Tab eines Assistenten ist die Ansicht je Assistent, in der du Plattformaktionen wie Anrufweiterleitung, SMS und Anruf beenden für genau diesen einen Assistenten ein- oder ausschaltest – siehe [Integrierte Tools](/de/assistants/built-in-tools).
</Note>

## Agent Tools vs. Automatisierungen

Beide sind Wege für einen Assistenten, auf externe Systeme einzuwirken, laufen aber zu unterschiedlichen Zeitpunkten. Ein Tool auf dieser Seite ist etwas, das sich der Assistent selbst live holt, während er bereits mit jemandem spricht – er entscheidet im Moment, dass er etwas nachschlagen oder einen Datensatz anlegen muss. Eine Automatisierung ist eine feste Schrittfolge, die du (oder Milian) im Voraus entwirfst, meist ausgelöst durch ein Hintergrundereignis wie das Ende eines Anrufs.

|                         | Agent Tools (diese Seite)     | Automatisierungen                                  |
| ----------------------- | ----------------------------- | -------------------------------------------------- |
| Läuft                   | Live, mitten im Gespräch      | Meist im Hintergrund, ausgelöst durch ein Ereignis |
| Schritte festgelegt von | Der Assistent, im Bedarfsfall | Du oder Milian, im Voraus                          |

Beide treffen an einer Stelle aufeinander: Eine Automatisierung, die du für den Assistenten aufrufbar machst, erscheint in **Installed** als **Automation-managed**-Tool – hier gelistet, aber bearbeitet wird sie in der Automatisierung selbst. Für Hintergrund-Workflows, die durch Ereignisse wie **On Call Completed** oder einen neuen Kontakt gestartet werden, siehe [Automatisierungen](/de/automations/overview).

## Installed

Die eigenen Tools deines Workspace, gruppiert nach Typ:

* **HTTP API tools** – rufen deinen eigenen HTTP-Endpunkt aus jedem unterstützten Gesprächskanal auf, zum Beispiel `book_appointment → POST https://…`.
* **MCP servers** – verbinden einen externen MCP-Server und erlauben jedes angebotene Tool oder nur ausgewählte.
* **Built-in** – Plattformfunktionen wie Anrufweiterleitung, SMS oder Anruf beenden, einmal hier eingerichtet und über Assistenten hinweg wiederverwendet. Dieselben Aktionen lassen sich stattdessen auch je Assistent konfigurieren – siehe [Integrierte Tools](/de/assistants/built-in-tools).

Jedes Tool wird einmal angelegt und kann mehreren Assistenten zugewiesen werden – wähle bei einem Tool **Assign**, um zu sehen und zu ändern, welche Assistenten es nutzen. Das Bearbeiten eines Tools aktualisiert es überall, wo es zugewiesen ist, und jede Zeile zeigt, wie viele Assistenten es nutzen (oder **Unused**).

Zeilen zeigen außerdem den Zustand des Tools: das Ergebnis des letzten Laufs und eine Warnung, wenn eine Verbindung nicht mehr funktioniert. Ist die Anmeldung eines MCP-Servers abgelaufen, wähle bei diesem Tool **Reauthorize** – die Verbindung wird direkt vor Ort repariert, sodass Zuweisungen, erlaubte Tools und Einstellungen erhalten bleiben.

## Agent Connectors

Der Tab **Agent Connectors** ist ein durchsuchbarer App Store vorgefertigter Integrationen – CRM, Kalender, Telefonie, Automatisierung, Produktivität, Utilities und weitere Apps, filterbar nach Kategorie oder eingeschränkt auf nur MCP –, die sich in wenigen Klicks als aufrufbares Tool an einen Assistenten anhängen lassen, statt ein API-Tool von Hand zu bauen. Verbinde dich je nach App per API-Key oder OAuth-Anmeldung.

## Ausführungsverhalten

Jedes Tool, das ein MCP-Server anbietet, hat im Editor des Servers einen eigenen Abschnitt **Execution behavior**, der steuert, wie dieses Tool während eines Anrufs oder Chats läuft:

* **Allow cancellation** – erlaubt dem Assistenten, einen laufenden Aufruf abzubrechen. Ein Abbruch kann eine bereits vom Tool vorgenommene Änderung auf der Gegenseite nicht rückgängig machen.
* **Duplicate calls** – legt fest, was passiert, wenn der Assistent versucht, dasselbe Tool erneut aufzurufen, während es noch läuft: zulassen, ablehnen, den laufenden Aufruf ersetzen oder den Assistenten vorher bestätigen lassen.
* **Speak progress updates** – liest den Fortschrittstext vor, den der MCP-Server während der Tool-Ausführung sendet. Aktiviere das nur für Server, denen du vertraust, da dieser Text Teil des Gesprächs wird.

## Max tool steps

Jeder Assistent hat eine eigene Einstellung **Max tool steps** in seinem **Tools**-Tab – wie viele Tool-Aufrufe er innerhalb einer einzigen Runde verketten darf, bevor er antworten muss, ohne ein weiteres Tool aufzurufen. Bereich 1–20, Standard 3.

## Tool-Versionen

Jede Änderung an einem Tool wird versioniert. Nutze die API oder MCP, um die Historie eines Tools einzusehen und eine frühere Version wiederherzustellen, falls eine kürzliche Änderung etwas kaputtgemacht hat.

## Tools verwalten

Workspace-Admins legen Tools an, bearbeiten und weisen sie zu. Andere Mitglieder sehen einen Hinweis, dass Tools von Workspace-Admins verwaltet werden.

## Verfügbarkeit

Das Limit **Tools & MCP** deines Plans begrenzt, wie viele Tools der Workspace gleichzeitig installiert haben kann. MCP-Server benötigen zusätzlich das Plan-Feature **Connect AI (MCP)** – ohne dieses wird das Anlegen eines MCP-Tools verweigert. Beides siehst du unter **Settings → Plan**.

## API & MCP

| REST                                                  | MCP-Tool                                     | Scope                                  |
| ----------------------------------------------------- | -------------------------------------------- | -------------------------------------- |
| `GET/POST /api/v1/tools`                              | `list_tools`, `create_tool`                  | `assistants:read` / `assistants:write` |
| `GET/PATCH/DELETE /api/v1/tools/{id}`                 | `get_tool`, `update_tool`, `delete_tool`     | `assistants:read` / `assistants:write` |
| `GET /api/v1/tools/{id}/versions`                     | `list_tool_versions`                         | `assistants:read`                      |
| `POST /api/v1/tools/{id}/versions/{revision}/restore` | `restore_tool_version`                       | `assistants:write`                     |
| `GET /api/v1/tools/{id}/usage`                        | `get_tool_usage`                             | `assistants:read`                      |
| `POST /api/v1/tools/{id}/reauthorize`                 | `reauthorize_tool`                           | `assistants:write`                     |
| `GET/PUT /api/v1/assistants/{id}/tools`               | `get_assistant_tools`, `set_assistant_tools` | `assistants:read` / `assistants:write` |

Details zu Request und Response findest du unter [Tools & Webhooks](/de/api/tools-and-webhooks).

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Integrierte Tools" icon="wrench" href="/de/assistants/built-in-tools">
    Anrufweiterleitung, SMS, E-Mail und andere Plattformaktionen je Assistent aktivieren
  </Card>

  <Card title="Tools & Webhooks" icon="webhook" href="/de/api/tools-and-webhooks">
    Vollständige API- und MCP-Referenz zum Bauen und Zuweisen von Tools
  </Card>
</CardGroup>