Aktionen

Live-Daten während des Anrufs abrufen

Lassen Sie den Agenten Ihr System nach einer Bestellung, einem Lagerbestand oder einem Konto fragen, während der Anrufer wartet.

Mit API Tool RAG fragt der Agent mitten im Gespräch Live-Daten bei Ihrem System ab — den Status einer Bestellung, den Bestand eines Produkts, die Angaben zu einem Konto — und antwortet damit. Wann er das Tool aufruft, entscheidet der Agent anhand Ihrer Beschreibung.

Einrichten

1. Das Tool hinzufügen

   Öffnen Sie den Agenten → Aktionen → Tool anlegen → CRM & Dienste → API Tool RAG.

2. Beschreiben und auf Ihren Endpunkt richten

   Feld	Was Sie eintragen
   Name	z. B. Bestellabfrage
   Allgemeine Bedingung	Wann es genutzt wird, z. B. der Kunde fragt nach dem Status einer Bestellung
   API-Endpunkt-URL	z. B. https://api.yourshop.com/orders/{order_id} — {placeholders} werden mit den Werten gefüllt, die der Agent sammelt
   HTTP-Methode	GET, POST, PUT, DELETE oder PATCH
   Ausführungsnachricht	Was der Agent sagt, während er wartet, z. B. Einen Moment, ich prüfe Ihre Bestellung
   Anfrage-Timeout (ms)	Wie lange auf Ihre Antwort gewartet wird; standardmäßig 5000
   Header, Abfrageparameter	Optionale feste Werte, z. B. Ihr API-Schlüssel

3. Festlegen, was der Agent erfragen muss

   Parameter-Schema (JSON) listet die Werte auf, die der Agent vom Anrufer erfragt und sendet — siehe unten. Fehlt ein Pflichtwert, fragt der Agent zuerst danach.

tipp

Füllen Sie immer die Ausführungsnachricht aus — Stille, während die Anfrage läuft, klingt nach einem abgebrochenen Anruf.

Das Parameter-Schema

Es ist nicht der Request-Body selbst, sondern ein JSON Schema der zu erfragenden Werte. Wo sie landen:

Fall	Wohin der Wert geht
Die URL enthält {name}	In die URL
GET, DELETE	Der Rest als ?key=value
POST, PUT, PATCH	Der Rest als JSON-Body

Eine Bestellabfrage per Nummer:

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "description": "Die Bestellnummer, nach der der Kunde fragt, meist 6 bis 10 Ziffern. Frag nach, wenn sie fehlt."
    }
  },
  "required": ["order_id"]
}

Eine Reservierung mit mehreren Werten:

{
  "type": "object",
  "properties": {
    "product_id": { "type": "string", "description": "Produkt-ID aus einer vorherigen Suche." },
    "quantity": { "type": "integer", "minimum": 1, "maximum": 10, "description": "Wie viele. Standard 1." },
    "delivery_method": { "type": "string", "enum": ["pickup", "home_delivery", "locker"], "description": "Wie der Kunde die Ware erhalten möchte." },
    "customer_email": { "type": "string", "format": "email", "description": "E-Mail für die Bestätigung. Frag nach, wenn sie fehlt." }
  },
  "required": ["product_id", "delivery_method", "customer_email"]
}

Ein statischer Endpunkt, z. B. Öffnungszeiten: { "type": "object", "properties": {} }.

Gute Schemas für Sprache:

• Halten Sie es flach: 3–5 Werte.
• Schreiben Sie zu jedem Wert eine description mit Beispielen — sie leiten den Agenten am besten.
• Verwenden Sie enum für feste Auswahlmöglichkeiten: Der Agent ordnet „das blaue“ blue zu.
• Markieren Sie einen Wert nur dann als required, wenn die Anfrage ohne ihn nicht funktioniert.
• Verwenden Sie Namen in snake_case, die den {placeholders} in der URL entsprechen.

Anwendungsfälle

• Bestellstatus — „Wo ist meine Bestellung 482913?“
• Verfügbarkeit — Lagerbestand oder einen freien Tisch in Ihrem eigenen System prüfen.
• Kontofragen — Guthaben, Vertragsende, offene Tickets.

Häufige Probleme

Problem	Was Sie prüfen sollten
Der Agent ruft es nie auf	Lassen Sie die Allgemeine Bedingung das Anliegen benennen
Ihr Endpunkt erhält leere Werte	Die Namen im Schema müssen exakt den {placeholders} entsprechen
Der Agent sagt, er konnte es nicht prüfen	Ihr Endpunkt hat länger als das Timeout gebraucht oder mit einem Fehler geantwortet

Verwandte Themen

• Den Anrufer kennen, bevor der Anruf beginnt — Daten vor der Begrüßung
• MCP-Server — viele Tools von einem Server