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

# Benutzerdefinierte Tools

> Entdecken und lernen Sie, wie Sie die leistungsstarken Tools für Ihren Chatbot verwenden.

## Benutzerdefiniertes Tool (API)

Mit diesem Tool können Sie Ihren Bot so einrichten, dass er jeden API-Endpunkt nach Ihren Wünschen verwendet.

<Frame>
  <img src="https://mintcdn.com/doko/pKbjWpjWFDIh-Q-V/images/custom-tool.png?fit=max&auto=format&n=pKbjWpjWFDIh-Q-V&q=85&s=be623f53227a51ebf29ca7404822ef66" alt="custom-tool" width="1784" height="140" data-path="images/custom-tool.png" />
</Frame>

### Tool einrichten

<Steps>
  <Step title="Neues Tool erstellen">
    Klicken Sie auf die Schaltfläche "Tool erstellen", um mit der Konfiguration Ihres benutzerdefinierten Tools zu beginnen.

    <Frame>
      <img src="https://mintcdn.com/doko/pKbjWpjWFDIh-Q-V/images/create-tool.png?fit=max&auto=format&n=pKbjWpjWFDIh-Q-V&q=85&s=15a2d9922bd7a205463b3383ada0e331" alt="create-tool" width="1230" height="1558" data-path="images/create-tool.png" />
    </Frame>
  </Step>

  <Step title="Grundinformationen konfigurieren">
    Vervollständigen Sie die Hauptfelder Ihres Tools:

    * **Name**: Geben Sie Ihrem Tool einen beschreibenden Namen
    * **Methode**: Wählen Sie die HTTP-Methode (GET, POST, PUT, DELETE)
    * **Beschreibung**: Erklären Sie, was dieses Tool tut, damit der Chatbot weiß, wann er es verwenden soll
    * **URL**: Geben Sie die URL Ihres API-Endpunkts ein
  </Step>

  <Step title="Body konfigurieren (für POST, PUT, DELETE)">
    Wenn Sie POST, PUT oder DELETE ausgewählt haben, können Sie die Felder des Request-Bodys konfigurieren:

    Für jedes Body-Feld können Sie konfigurieren:

    * **Name**: Der Name des Felds (z. B. userData, user\_data, items)
    * **Typ**: Der Datentyp (String, Number, Boolean, etc.)
    * **Ist ein Array**: Aktivieren Sie diese Option, wenn das Feld ein Array sein soll
    * **Beschreibung**: Erklären Sie, welche Informationen dieses Feld enthält

    Konfigurationsbeispiele:

    * Einfaches Feld: `name` (String) - Zum Senden eines Benutzernamens
    * Array-Feld: `products` (String, Ist ein Array ✓) - Zum Senden einer Produktliste
    * Numerisches Feld: `quantity` (Number) - Zum Senden von Mengen
    * Boolean-Feld: `active` (Boolean) - Zum Anzeigen, ob ein Benutzer aktiv ist
    * Objekt-Feld: `address` (Object) - Zum Senden einer vollständigen Adresse eines Benutzers

    <Note>Der Body ist nur für POST-, PUT- und DELETE-Methoden erforderlich. GET verwendet keinen Body.</Note>
  </Step>

  <Step title="Parameter hinzufügen (Optional)">
    Wenn Ihre API Abfrageparameter erfordert, klicken Sie auf "Parameter hinzufügen" und konfigurieren Sie:

    * Parametername
    * Datentyp
    * Ob er erforderlich oder optional ist
      <Note>Parameter werden als Abfragezeichenfolgen in der URL gesendet</Note>
  </Step>

  <Step title="Header konfigurieren (Optional)">
    Für APIs, die Authentifizierung oder spezifische Header erfordern, klicken Sie auf "Header hinzufügen":

    * Header-Name (z. B. Authorization, Content-Type)
    * Header-Wert (z. B. Bearer-Token, application/json)
      <Warning>Bewahren Sie Ihre Tokens und API-Schlüssel sicher auf. Teilen Sie diese Informationen nicht.</Warning>
  </Step>

  <Step title="Tool speichern">
    Sobald die Konfiguration abgeschlossen ist, klicken Sie auf "Tool erstellen", um Ihr benutzerdefiniertes Tool zu speichern und zu aktivieren.
  </Step>
</Steps>

### Verwendungsbeispiele

<Accordion title="Wetter-API">
  **Name**: Wetterabfrage\
  **Methode**: GET\
  **URL**: `https://api.openweathermap.org/data/2.5/weather`\
  **Parameter**:

  * `q` (Stadt)
  * `appid` (Ihr API-Schlüssel)
  * `units` (metrisch)
</Accordion>

<Accordion title="Inventar-API">
  **Name**: Bestandsabfrage\
  **Methode**: GET\
  **URL**: `https://your-api.com/inventory/check`\
  **Header**:

  * `Authorization`: `Bearer your-token`
  * `Content-Type`: `application/json`
</Accordion>

<Tip>
  Ihr Chatbot weiß automatisch, wann er dieses Tool verwenden soll, basierend auf der von Ihnen bereitgestellten Beschreibung. Seien Sie spezifisch darüber, wann und wie es verwendet werden soll.
</Tip>