External Tools

External Tools sind HTTP-Webhooks, die Sie konfigurieren: Der Sprachagent ruft sie in Echtzeit auf, um Daten abzurufen oder Aktionen in Ihren Systemen (CRM, Geschäftssoftware, individuelle Automatisierungen) auszulösen.

Was sie sind

Ein External Tool ist eine Funktion, die auf Ihrem Server lebt. yourang.ai registriert sie als verfügbares Werkzeug für den KI-Agenten: Sobald das Modell erkennt, dass diese Aktion nötig ist (z. B. Kunde im CRM suchen, Zimmerverfügbarkeit prüfen), sendet es eine HTTP-Anfrage an die von Ihnen konfigurierte URL.

So konfigurieren Sie sie

1. 1

   Öffnen Sie das Tool-Panel des Agenten

   Gehen Sie zu /ai-agents → wählen Sie den Agenten → Tab Tools → External tools.

2. 2

   Name und Beschreibung festlegen

   Der interne Name (tool_name) ist eine technische Kennung (z. B. lookup_customer). Die Beschreibung sagt der KI, wann das Tool zu verwenden ist: klar, konkret, auf die Nutzerabsicht ausgerichtet.

3. 3

   Webhook einrichten

   HTTPS-URL, die die Aufrufe erhält, Methode (GET/POST/PUT), Parameterschema (JSON Schema), das die KI in den Payload übergibt.

4. 4

   Authentifizierung konfigurieren

   Keine, Bearer-Token, API-Key im Header, Basic Auth oder mehrere benutzerdefinierte Header. Anmeldedaten werden verschlüsselt gespeichert.

5. 5

   Mit einem Testanruf prüfen

   Starten Sie den Agenten im Playground und stellen Sie eine Frage, die das Tool auslösen sollte. Das Anrufprotokoll zeigt Request, Response und Zeiten.

Authentifizierung

Keine

Öffentlicher Endpoint, keine Header. In Produktion nicht empfohlen.

API-Key

Wird im gewählten HTTP-Header gesendet (z. B. X-API-Key).

Bearer

Header Authorization: Bearer <Token>.

Basic

Authorization: Basic <base64(user:pass)>.

Benutzerdefinierter Header

Ein oder mehrere beliebige Header (z. B. X-Tenant, X-Signature).

Wann sie zu verwenden sind

• CRM-Lookup. Der Agent sucht einen Kunden per Telefonnummer und passt die Antwort an dessen Daten an.
• Verfügbarkeit im Geschäftssystem. Der Agent fragt das PMS, ob an einem bestimmten Datum freie Zimmer vorhanden sind.
• Ticket-Erstellung. Der Agent registriert eine Beschwerde als Ticket in Ihrem Kundensupport-System.
• Bestellaktualisierung. Der Agent ändert den Status einer bereits in Ihrem E-Commerce bearbeiteten Bestellung.

Beispiel-Anfrage

{
 "phone": "+49 30 12345678",
 "call_id": "cl_abc123",
 "organization_id": "org_xyz"
}

# Erwartete Antwort (200 OK):
{
 "found": true,
 "customer": {
 "name": "Anna Schmidt",
 "tier": "gold",
 "last_order_date": "2026-03-12"
 }
}