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

# HTTP-Tool

> Erstelle, konfiguriere, teste und ordne ein HTTP-Request-Tool zu, damit dein Assistent während eines Chats Live-Daten abrufen oder Aktionen ausführen kann.

Ein HTTP-Tool ist ein HTTP-Request, den der Assistent während einer Konversation aufrufen kann. Du definierst die Anfrage – Methode, URL, Header und Parameter – und der Assistent füllt die Parameter aus und ruft sie auf, wenn die Frage eines Shoppers passt. Ein typisches Beispiel ist das Nachschlagen des Bestellstatus aus deinem Backend und das Antworten mit dem Ergebnis.

<Note>
  HTTP-Tools werden auf Organisations-Ebene konfiguriert und anschließend den Assistenten zugeordnet, die sie nutzen sollen. Um API-Keys und OAuth aus der Anfrage herauszuhalten, richte zuerst [Geheimnisse](/de/user-guide/settings/secrets) und [Auth-Verbindungen](/de/user-guide/settings/auth-connections) ein.
</Note>

## Tool erstellen

<Steps>
  <Step title="Tools öffnen">
    Gehe in der Plattform zu **Tools** und wähle **Neues Tool**. Wähle **HTTP Request** oder starte mit einer Vorlage wie *Sendungsverfolgung* und passe sie an.
  </Step>

  <Step title="Tool benennen und beschreiben">
    Gib dem Tool unter **Konfiguration** einen klaren **Namen** (zum Beispiel `Bestellstatus abfragen`) und eine **Beschreibung**, wann es verwendet werden soll. Die Beschreibung hilft dem Assistenten zu entscheiden, wann das Tool relevant ist – sei also präzise.
  </Step>

  <Step title="Parameter definieren">
    Füge unter **Parameter** die Eingaben hinzu, die die Anfrage benötigt (etwa `order_number`). Verwende Namen in Kleinbuchstaben im `snake_case`-Format. Lege für jeden Parameter einen **Datentyp** und einen **Werttyp** fest: entweder einen **Konstanten Wert**, der bei jedem Aufruf gleich bleibt, oder einen Wert, den der Assistent aus dem Gespräch ausfüllt. Bei vom Assistenten ausgefüllten Werten kannst du außerdem beschreiben, wie er sie ermitteln soll.
  </Step>

  <Step title="HTTP-Request konfigurieren">
    Lege unter **HTTP-Request** fest:

    * **Methode** – `GET`, `POST`, `PUT`, `PATCH` oder `DELETE`.
    * **URL** – der aufzurufende Endpunkt. Nutze `{parameter_name}`-Platzhalter, um Parameter einzusetzen, z. B. `https://api.example.com/orders/{order_number}`.
    * **JSON-Body** (bei `POST`, `PUT` und `PATCH`) – eine JSON-Vorlage, die ebenfalls `{parameter_name}`-Platzhalter nutzen kann.
    * **Authentifizierung** – hänge eine [Auth-Verbindung](/de/user-guide/settings/auth-connections) an, statt Anmeldedaten in die Anfrage zu schreiben.
    * **Header** (optional) – zusätzliche Request-Header als Name/Wert-Paare.

    Du kannst auch den Request-Timeout anpassen (die maximale Wartezeit auf die Antwort der externen API).
  </Step>

  <Step title="Antwortfelder auswählen (optional)">
    Lege unter **Antwortfelder** fest, welche Felder aus der JSON-Response an den Assistenten weitergegeben werden. Ohne Auswahl erhält der Assistent die gesamte Response.
  </Step>

  <Step title="Tool testen">
    Wähle **Tool testen**, gib Beispiel-Parameterwerte ein und führe es aus.

    <Check>
      Die Anfrage liefert den erwarteten Status und die erwarteten Daten zurück. Korrigiere URL, Header oder Parameter, bis die Test-Antwort stimmt.
    </Check>

    <Warning>
      Ein Test sendet die echte Anfrage an deinen Endpunkt. Teste gegen einen sicheren Endpunkt und vermeide Tools, die unbeabsichtigte Schreibvorgänge ausführen.
    </Warning>
  </Step>

  <Step title="Einem Assistenten zuordnen">
    Speichere das Tool, öffne dann den Assistenten, der es nutzen soll, und ordne das Tool unter dessen **Tools** zu. Der Assistent kann es nun während Chats aufrufen, wann immer die Frage des Shoppers zur Beschreibung des Tools passt.
  </Step>
</Steps>

## Sicherheit

Füge Geheimnisse niemals direkt in die Header oder die URL eines Tools ein:

* Speichere API-Keys und andere sensible Werte als **Geheimnisse**, damit sie verschlüsselt aufbewahrt und nie im Klartext offengelegt werden. Siehe [Einstellungen › Geheimnisse](/de/user-guide/settings/secrets).
* Nutze eine **Auth-Verbindung**, wenn das Tool eine Authentifizierung benötigt – Bearer, Basic, einen eigenen Header oder OAuth –, um gegen einen Drittanbieter-Service zu agieren. Siehe [Einstellungen › Auth-Verbindungen](/de/user-guide/settings/auth-connections).

<Warning>
  Teste ein Tool immer, bevor du es zuordnest. Ein zugeordnetes Tool kann während laufender Chats automatisch aufgerufen werden – stelle also sicher, dass sich der Endpunkt wie erwartet verhält und nie unbeabsichtigte Schreibvorgänge ausführt.
</Warning>

## Verfügbarkeit

Ob Tools verfügbar sind und wie viele HTTP-Tools du anlegen kannst, hängt von deinem Plan ab. Wenn du das Limit erreichst, lösche ein nicht mehr benötigtes Tool oder upgrade deinen Plan.

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Geheimnisse" icon="key" href="/de/user-guide/settings/secrets">
    Speichere API-Keys, die deine Tools referenzieren, sicher.
  </Card>

  <Card title="E-Mail-Tool" icon="envelope" href="/de/user-guide/tools/email-tool">
    Lass den Assistenten E-Mails von einem verifizierten Absender senden.
  </Card>
</CardGroup>