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

# API-Verbindungen

> Machen Sie jede HTTP-API zu einer Funktion, die Ihr Agent während eines Gesprächs aufrufen kann – fügen Sie einen cURL-Befehl ein und lassen Sie den Assistenten den Rest erledigen.

API-Verbindungen sind benutzerdefinierte HTTP-Funktionen, die Ihre Agenten während eines Gesprächs aufrufen können — eine Bestellung nachschlagen, ein Ticket erstellen oder den Kontostatus aus Ihrem eigenen Backend abrufen. Sie definieren den Endpunkt einmal unter **Verbindungen → APIs** (`/dashboard/api-connections`); Agenten, denen die Verbindung zugewiesen 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="Auf Neue API-Verbindung klicken">
    Der Dialog wird im Assistenten geöffnet. Fügen Sie einen Beispielbefehl
    **cURL**, eine **OpenAPI/Swagger-Spezifikation**, einen
    **Postman-Export**, ein **TypeScript-Interface** oder ein
    **Zod-Schema** in das Feld ein.
  </Step>

  <Step title="Auf Analysieren klicken">
    ThunderPhone leitet die gesamte Verbindung aus Ihrer Eingabe ab — URL,
    Methode, Header und ein Parameterschema, das aus den gefundenen
    Abfrageparametern und dem Request-Body erstellt wird. Die eingefügten
    Header (einschließlich Authentifizierungs-Header) werden in die
    Endpunktkonfiguration übernommen.
  </Step>

  <Step title="Die hervorgehobenen Felder bestätigen">
    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 werden soll — die Beschreibung liest
    das Modell.
  </Step>

  <Step title="Validieren & Speichern">
    Beim Speichern wird zunächst eine Live-Testanfrage an Ihren Endpunkt
    gesendet. Wenn die Anfrage fehlschlägt, wird die Verbindung nicht
    gespeichert — korrigieren Sie die URL, Authentifizierungs-Header oder
    den Body und versuchen Sie es erneut. Bei Erfolg wird die Verbindung
    mit einem **Validiert**-Badge gespeichert.
  </Step>
</Steps>

Wenn der Assistent in Ihrer Eingabe keine Request-URL finden kann, wird er Sie darauf hinweisen — 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?
Assistent ausprobieren →**, um zurückzugehen). Der manuelle Builder enthält zwei Editoren:

* **Visuell** — Formularfelder für den Anzeigenamen, Funktionsnamen, die Request-
  **URL**, die **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 Roh-JSON zum direkten Einfügen oder
  Feinabstimmen einer Toolspezifikation.

Ein Bereich **Testanfrage** (optional) ermöglicht es Ihnen, die konfigurierte Anfrage
vor dem Speichern auszuführen, und zeigt Status, Latenz und eine Antwortvorschau an.
**Validieren & Speichern** führt diesen Test immer aus und speichert nur bei Erfolg.

<Tip>
  Geben Sie Parametern Beschreibungen in Alltagssprache („E-Mail-Adresse des Kunden,
  z. B. [jane@example.com](mailto:jane@example.com)“). Der Agent wählt Argumente anhand dieser
  Beschreibungen in Echtzeit während des Anrufs 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 startet als
  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.

## An einen Agenten anhängen

Fügen Sie die Verbindung in der API-Verbindungen-Sektion 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 die API" icon="code" href="/de/guides/build-tool-integration">
    Erstellen und verwalten Sie dieselben Verbindungen programmgesteuert.
  </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 zur Verfügung.
  </Card>

  <Card title="Referenz der Integrations-API" icon="book" href="/api-reference/integrations">
    Jedes Feld der Integrationsressource.
  </Card>
</CardGroup>
