---
title: "API-Verbindungen"
description: "Machen Sie jede HTTP-API zu einer Funktion, die Ihr Agent mitten im Gespräch aufrufen kann: Fügen Sie einen cURL-Befehl ein, und der Assistent erstellt die Tool-Definition, Parameter und Authentifizierung."
---

API-Verbindungen sind benutzerdefinierte HTTP-Funktionen, die Ihre Agenten während eines
Gesprächs aufrufen können — eine Bestellung nachschlagen, ein Ticket erstellen, den Kontostatus
aus Ihrem eigenen Backend abrufen. Sie definieren den Endpunkt einmal unter
**Verbindungen → APIs** (`/dashboard/api-connections`); Agenten, denen die
Verbindung zugeordnet ist, können sie dann aufrufen, wenn das Gespräch
es erfordert.

Es gibt zwei Möglichkeiten, eine Verbindung zu erstellen: Fügen Sie etwas ein, das der Assistent analysieren kann,
oder richten Sie die Verbindung manuell ein.

## Der schnelle Weg: einfügen und analysieren

<Steps>
  <Step title="Klicken Sie auf Neue API-Verbindung">
    Der Dialog wird im Assistenten geöffnet. Fügen Sie einen Beispielbefehl für **cURL**,
    eine **OpenAPI/Swagger-Spezifikation**, einen **Postman-Export**, eine **TypeScript-
    Schnittstelle** oder ein **Zod-Schema** in das Feld ein.
  </Step>
  <Step title="Klicken Sie auf Analysieren">
    ThunderPhone leitet die gesamte Verbindung aus Ihrem eingefügten Inhalt ab — URL,
    Methode, Header und ein Parameterschema, das aus den gefundenen Abfrageparametern
    und dem Request-Body erstellt wird. Eingefügte Header (einschließlich
    Authentifizierungsheader) werden in die Endpunktkonfiguration übernommen.
  </Step>
  <Step title="Bestätigen Sie die hervorgehobenen Felder">
    Die abgeleitete Konfiguration wird mit den zur Überprüfung hervorgehobenen
    geschätzten Feldern geöffnet. Passen Sie Namen, Beschreibungen und Parametertypen an,
    damit der Agent versteht, wann und wie die Funktion aufgerufen wird — die Beschreibung
    wird vom Modell gelesen.
  </Step>
  <Step title="Validieren & Speichern">
    Beim Speichern wird zuerst eine Live-Testanfrage an Ihren Endpunkt ausgeführt. Wenn die
    Anfrage fehlschlägt, wird die Verbindung nicht gespeichert — korrigieren Sie URL,
    Authentifizierungsheader oder Body und versuchen Sie es erneut. Bei Erfolg wird die
    Verbindung mit dem Badge **Validiert** gespeichert.
  </Step>
</Steps>

Wenn der Assistent in Ihrem eingefügten Inhalt keine Anfrage-URL finden kann, wird dies angezeigt —
fügen Sie einen vollständigen `http(s)`-Endpunkt ein und versuchen Sie es erneut.

## Manuelle Einrichtung

Klicken Sie im Assistenten auf **Manuell einrichten →** (oder auf **Soll die KI dies ableiten?
Assistenten ausprobieren →**, um zurückzukehren). Der manuelle Editor enthält zwei Editoren:

- **Visuell** — Formularfelder für Anzeigename, Funktionsname, Anfrage-
  **URL**, **Methode** (`POST`, `GET`, `PUT`, `PATCH`, `DELETE`), benutzerdefinierte
  **Header** und das Parameterschema (**Eigenschaft hinzufügen** für jedes
  Argument, das der Agent bereitstellen kann).
- **JSON** — dieselbe Definition als reines JSON zum direkten Einfügen oder
  Feinabstimmen einer Tool-Spezifikation.

Über ein optionales Panel für **Testanfragen** können Sie die konfigurierte Anfrage
vor dem Speichern ausführen und Status, Latenz sowie eine Antwortvorschau anzeigen.
**Validieren & Speichern** führt diesen Test immer aus und speichert nur bei Erfolg.

Headerwerte sind nur schreibbar. Nach dem Speichern werden sie verschlüsselt und weder im Dashboard noch in der API erneut angezeigt. Wenn Sie eine Verbindung bearbeiten, zeigt ein gespeicherter Header seinen Namen mit Punkten anstelle des Werts sowie den Hinweis **Gespeichert**: Lassen Sie ihn unverändert, um den gespeicherten Wert beizubehalten, oder geben Sie einen neuen Wert ein, um ihn zu ersetzen. Testanfragen und Live-Anrufe verwenden den gespeicherten Wert. **Klonen** kopiert gespeicherte Werte in die neue Verbindung.

<Tip>
  Geben Sie Parametern Beschreibungen in einfacher Sprache ("E-Mail-Adresse des Kunden,
  z. B. jane@example.com"). Der Agent wählt Argumente während des Anrufs in Echtzeit
  anhand dieser Beschreibungen aus.
</Tip>

## Ihre Verbindungen verwalten

Jede Verbindungszeile zeigt ihren Validierungsstatus — **Validiert**,
**Nicht getestet** oder **Fehler** — ihren Funktionsnamen und die Agenten, die sie verwenden.
Über das Aktionsmenü der Zeile können Sie:

- **Bearbeiten** — die Konfiguration erneut öffnen.
- **Klonen** — sie als Ausgangspunkt duplizieren (die Kopie ist zunächst
  nicht getestet).
- **Versionsverlauf** — frühere Versionen anzeigen und eine davon im
  Editor wiederherstellen.
- **Übertragen** — die Verbindung in eine andere Organisation kopieren oder verschieben,
  der Sie angehören. Beim Verschieben wird sie hier entfernt; Agenten, die sie verwendet haben,
  müssen möglicherweise neu konfiguriert werden.
- **Löschen** — dauerhaft; Agenten, die die Verbindung verwenden, müssen
  neu konfiguriert werden.

## Mit einem Agenten verknüpfen

Fügen Sie die Verbindung im Abschnitt für API-Verbindungen des Builders zu einem Agenten hinzu
([Agenten erstellen](/de/guides/build-an-agent)). Die Liste zeigt, welche Agenten
jede Verbindung verwenden, sodass Sie auf einen Blick erkennen können, welche Auswirkungen eine Änderung hat.

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Tool-Integrationen über API" icon="code" href="/de/guides/build-tool-integration">
    Erstellen und verwalten Sie dieselben Verbindungen programmatisch.
  </Card>
  <Card title="Apps verbinden" icon="cable" href="/de/guides/connect-apps">
    Vorgefertigte Verbindungen für Google, Slack, HubSpot, Salesforce und Cal.com.
  </Card>
  <Card title="Einen MCP-Server hinzufügen" icon="server" href="/de/guides/mcp-servers">
    Stellen Sie Ihren Agenten einen vollständigen Tool-Server bereit.
  </Card>
  <Card title="Referenz zur Integrations-API" icon="book" href="/api-reference/integrations">
    Jedes Feld der Integrationsressource.
  </Card>
</CardGroup>