KI-Aktionen

KI-Aktionen (oder „Tools“) erweitern die generativen KI-Benutzeroberflächen von branchly auf Basis eines „Agentic RAG“-Modells, bei dem der Agent – angetrieben von einem Large Language Model – verschiedene Werkzeuge nutzt, um Nutzeranfragen zu erfüllen und Fragen effektiv zu beantworten.

Einer der wesentlichen Vorteile dieses Ansatzes ist der Verzicht auf komplexe Workflow-Builder. Stattdessen werden Fähigkeiten in natürlicher Sprache definiert, sodass der Agent das am besten geeignete Tool zur Erledigung der Aufgabe selbst auswählt.

Das Standard-Tool – das Wissensbasis-Tool – überführt unseren bewährten RAG-Prozess in ein Tool-Format. Dieses Werkzeug nutzt semantische Suche und Reranking, um die relevantesten Inhalte innerhalb der Wissensbasis zur Generierung präziser Antworten zu ermitteln.

Indem das Abrufen aus der Wissensbasis als Tool definiert wird, können zusätzliche Werkzeuge für andere Zwecke als die reine Wissensabfrage eingesetzt werden – was die Fähigkeiten des generativen KI-Chats in den Bereich der Prozessautomatisierung erweitert. Tools können Aktionen ausführen und auf Ereignisse reagieren, wie z. B. das Abrufen von Live-Informationen über eine REST-API, das Anstoßen von Hintergrundereignissen oder das Ausführen spezifischer Prozesse. Tools sind besonders nützlich, wenn du dynamisch auf externe Informationen zugreifen möchtest, ohne diese Daten zuvor in deine Wissensbasis synchronisieren zu müssen.

Bitte beachte: Während Tools primär für Benutzeroberflächen mit generativer KI konzipiert sind (Chat-Widget, Chat, Suche, Formular und API-Embed), sind bestimmte Tools – darunter Formulare – auch mit dem Navigator kompatibel. Welches Tool in welchem Interface verfügbar ist – und welcher interne Agent es ausführt –, ist unten unter Verfügbarkeit von Tools und Benutzeroberflächen detailliert beschrieben.

Tool-Ausführungen und -Ergebnisse können über Insights und Konversationen überwacht werden.

Tool-Statusanzeige

Während der KI-Agent eine Anfrage verarbeitet, zeigt die Benutzeroberfläche eine Statusanzeige, die deutlich macht, welche KI-Aktion gerade ausgeführt wird. Die in dieser Anzeige angezeigten Bezeichnungen sind lokalisiert, sodass sie in der Sprache des Besuchers erscheinen und nicht als unübersetzte technische Begriffe. Status-Updates erscheinen in Echtzeit während der KI-Aufrufe und bieten Nutzern transparentes, verständliches Feedback zu laufenden Aktionen im Chat, Chat-Widget und bei Formularen.

Verfügbare Tools

Allgemeine Parameter

Tools müssen in den Anwendungseinstellungen für die Verwendung aktiviert werden.

Es ist möglich, mehrere Tools desselben Typs innerhalb deiner Anwendung zu erstellen und zu nutzen. Jedes Tool muss eindeutig benannt sein und einen klaren Zweck oder Anwendungskontext erfüllen.

Name: Der Name des Tools sollte sorgfältig gewählt werden, um seine Funktion widerzuspiegeln, darf keine Leerzeichen enthalten und ist auf maximal 64 Zeichen begrenzt. Jeder Tool-Name muss anwendungsweit eindeutig sein.
Aktiv (Active): Dieser boolesche Parameter gibt an, ob das Tool derzeit aktiv und für den Agenten nutzbar ist.
Beschreibung (Description): Diese sollte eine klare Erklärung der Szenarien liefern, in denen das Tool ausgeführt werden soll. Die Genauigkeit und Spezifität der Beschreibung sind entscheidend, damit der Agent das Tool situationsgerecht erkennt und auswählt.
Agent-Typ (Agent type): Der interne Agent, der das Tool ausführt, abhängig davon, aus welchem Interface die Anfrage stammt:
- chat_routing — der Routing-Agent im Chat, Chat-Widget und API-Embed. Er entscheidet für jede Anfrage, welches Tool aufgerufen werden soll, und kann jeden Tool-Typ nutzen.
- search_answer — der Antwort-Agent im Such-Interface und im Navigator. Führt derzeit ausschließlich das Wissensbasis-Tool aus.
- form_answer — der Formular-Agent im Formular-Interface. Er beantwortet Nutzeranfragen mithilfe von Informationsabfrage-Tools (Wissensbasis, Node-Lookup, Websuche, Webseiten-Reader, Wetter, Venus Social Knowledge Graph, Regiondo, MCP-Server, API).
- form_routing — der Formular-Routing-Agent im Formular-Interface. Er wählt das passende Formular aus, wenn der Besucher eine Anfrage einreichen möchte, anstatt eine direkte Antwort zu erhalten; er führt ausschließlich das Formular-Tool aus.
- web_mcp — führt Informationsabfrage-Tools im Auftrag von im Browser des Besuchers integrierten KI-Agenten über das WebMCP-Interface aus (Wissensbasis, Node-Lookup, Kontaktinformationen, Websuche, Webseiten-Reader, Wetter, MCP-Server, API).
Ob ein Tool in einem bestimmten Interface ausgeführt werden kann, ergibt sich aus seinen Agent-Typen – siehe Verfügbarkeit von Tools und Benutzeroberflächen unten.

Wissensbasis

Dieses Tool überführt unseren RAG-Prozess in ein Werkzeug, das individuell konfiguriert werden kann, um den Retrieval-Prozess an deine spezifischen Anforderungen anzupassen. Alle Parameter sind optional.

Retrieval-Methode (Retrieval method): Wähle zwischen den Methoden default und parent_context.
- default: Unsere standardmäßige semantische Suche.
- parent_context: Nutzt semantische Suche und führt anschließend ein Reranking durch, um die relevantesten übergeordneten Dokumente (Parent Documents) zu finden und diese anstelle einzelner Textabschnitte (Chunks) zurückzugeben.
Retrieval-Formatierung (Retrieval Formatting): Bestimme, wie Ergebnisse innerhalb des an das LLM gesendeten Prompts formatiert werden sollen:
- Chunks with Source: Text eines Chunks inklusive Quellenangabe (z. B. eine Website-URL zur Quellenanzeige am Ende).
- Grouped Chunks: Gruppiert Chunk-Texte nach ihrer Node-ID, wobei die relevantesten Ergebnisse oben stehen. Enthält node_title und source für zusätzlichen Kontext.
- Numbered Chunks with Source: Optimierung von Chunks with Source, damit das LLM Texte noch präziser referenzieren kann.
- Numbered Chunks with Custom Metadata: Stellt zusätzlich die benutzerdefinierten Metadaten jedes Nodes als Kontext bereit.
- Numbered Chunks with Page Metadata: Verwendet die Metadaten der gecrawlten Webseite für zusätzlichen Kontext.
Rerank: Ein boolescher Wert, der festlegt, ob der Reranker zur Verbesserung der Relevanz von Suchergebnissen eingesetzt werden soll.
Dokumentenlimit (Rerank): Bestimmt die maximale Anzahl der zurückgegebenen Dokumente, wenn der Reranker aktiv ist.
Dokumentenlimit (default): Bestimmt das Limit für zurückgegebene Dokumente ohne Reranker.
Datenquellen-ID (Data Source ID): Filtert Nodes bestimmter Datenquellen.
Datenquellentyp (Data Source Type): Filtert Nodes bestimmter Datenquellentypen.
Nodes-Filter: Eine Liste von Node-IDs, um Suchergebnisse einzugrenzen.
Labels-Filter: Eine Liste von Labels, nach denen Nodes gefiltert werden können. Dies ist nützlich, um bestimmte Node-Typen auszuschließen – etwa Kontakt-Nodes, die du über ein anderes Tool abdecken möchtest.
Quellen-Filter (Sources Filter): Filtert die Suchergebnisse nach bestimmten Quellen.
URL-Präfix-Filter (URL Prefix Filter): Wenn aktiviert, kann die KI eine Wissensbasis-Suche optional auf Seiten beschränken, deren URL mit einem bestimmten Präfix beginnt – beispielsweise einer Domain oder einem Verzeichnispfad wie deinem Blog –, sodass Antworten ausschließlich aus diesem Teil deiner Inhalte bezogen werden. Die KI kann den Suchbereich auf diese Weise nur eingrenzen, niemals erweitern.

Formular

Ein Formular eignet sich hervorragend, um strukturierte Informationen deiner Nutzer zu erfassen. Das Formular-Tool kann so konfiguriert werden, dass es für alle unsere Benutzeroberflächen funktioniert. Über den Button „Vorschau“ (Preview) kannst du dir das Formular vorab ansehen. Beachte, dass Name und Description essenziell sind, damit das Formular-Tool vom KI-Agenten ausgeführt werden kann (siehe Abschnitt oben).

Formularoptionen

Formulartitel: Lege einen Titel für dein Formular fest, der ganz oben erscheint.
Absende-Button: Passe den Text auf dem Absende-Button an.
Bestätigungsnachricht (Submission Message): Verfasse eine Dankesnachricht oder Bestätigung, die Nutzer nach dem Absenden des Formulars sehen.
Datenschutz: Wenn dein Formular sensible Daten erfasst, kannst du einen Datenschutzhinweis hinterlegen, dem Nutzer zustimmen müssen, um das Formular absenden zu können. Aktiviere dazu einfach diese Option und hinterlege den gewünschten Text (als HTML) – eine entsprechende Checkbox wird dem Formular automatisch hinzugefügt.
Benachrichtigungs-E-Mail: Gib eine E-Mail-Adresse ein, um Benachrichtigungen zu erhalten, sobald jemand das Formular absendet. Lass das Feld leer, wenn du keine E-Mail-Benachrichtigungen wünschst oder Webhooks nutzt, um Übermittlungen an dein System weiterzuleiten.
Echtzeit-Streaming: Antworten des Formular-Agenten werden in Echtzeit gestreamt, sodass Nutzer Teilantworten bereits während der Generierung sehen und nicht auf das vollständige Ergebnis warten müssen.

Feldtypen

Hier ist eine kurze Übersicht über die Feldtypen, die du deinem Formular hinzufügen kannst:

Textfeld (Text Field)
- Zur Erfassung allgemeiner Texteingaben wie Namen oder kurzer Angaben.
- Optionen: Wähle zwischen den Formaten Text, E-Mail oder Telefon.
Textbereich (Text Area Field)
- Zur Erfassung ausführlicher Beschreibungen oder Kommentare des Nutzers.
Checkbox
- Für Ja/Nein-Fragen oder zur Bestätigung von Geschäftsbedingungen.
Dropdown-Menü
- Ideal für eine Liste vordefinierter Auswahlmöglichkeiten.
- Optionen: Füge beliebig viele Optionen hinzu, aus denen Nutzer wählen können.
Zahlenfeld (Number Field)
- Optimal für numerische Daten wie Alter oder Mengenangaben.
- Optionen: Lege bei Bedarf einen Mindestwert fest.
Datumsauswahl (Date Picker)
- Ermöglicht Nutzern die Auswahl eines Datums – praktisch für Buchungen oder Termine.
Uhrzeitauswahl (Time Picker)
- Ermöglicht Nutzern die Auswahl einer Uhrzeit – praktisch für Buchungen oder Termine.

Überwachung

Verfolge die Ausführung und Ergebnisse von Formularen über unseren Bereich „Konversationen“.

Nutzung mit dem Navigator

Um Formulare mit dem Navigator zu nutzen, musst du einen neuen Node in der Wissensbasis vom Typ tool erstellen und das konfigurierte Formular mit diesem Tool-Node verknüpfen. Beachte, dass vom Nutzer eingegebene Parameter im Formular nicht vorausgefüllt werden (da hierfür der KI-Agent erforderlich wäre).

Calendly

Mit dem Calendly-Tool kann der KI-Agent im Namen des Kunden direkt innerhalb des Chat-Interfaces Termine vereinbaren.

Einrichtung: Bevor du dieses Tool aktivierst, musst du dein Calendly-Konto im Tab Integrationen der Dashboard-Einstellungen verknüpfen. Das Tool kann erst aktiviert werden, wenn eine gültige Calendly-Verbindung erfolgreich eingerichtet und verifiziert wurde.
Funktionsweise: Wenn der Nutzer darum bittet, ein Meeting oder ein Telefonat zu vereinbaren, ruft der KI-Agent freie Terminfenster aus Calendly ab, zeigt sie im Chat an und bucht den gewählten Termin.
Sicherheit & Wartung: Die Integration unterstützt sichere OAuth-Token-Rotation und die automatische Deaktivierung des Calendly-Tools, falls die Integrationsverbindung entfernt wird.

Webseiten-Reader

Das Webseiten-Reader-Tool (Web Page Reader) ist für den Zugriff auf spezifische Webseiten gedacht – insbesondere dann, wenn du aufwändige Integrationen wie OpenAPI vermeiden möchtest. Ein typischer Anwendungsfall ist der Zugriff auf Inhalte dynamischer Webseiten.

URL (erforderlich): Die exakte URL der Webseite, auf die das Tool zugreifen und die es auslesen soll.
Target-Selektor (optional): Gibt nur Elemente innerhalb dieses CSS-Selektors zurück. Dient dazu, den Fokus auf einen bestimmten Bereich der Seite zu legen.
Wait-for-Selektor (optional): Wartet darauf, dass ein bestimmtes Element (definiert per CSS-Selektor) erscheint, bevor das Ergebnis zurückgegeben wird.

Websuche

Dieses Tool ermöglicht es dem Agenten, das Web anhand von Begriffen zu durchsuchen, die vom Nutzer bereitgestellt oder vom Agenten abgeleitet wurden.

Limit (optional): Bestimmt die maximale Anzahl der Suchergebnisse (bis zu 5). Du kannst bei Bedarf ein niedrigeres Limit festlegen.

Model Context Protocol (MCP) Server

Der Model Context Protocol (MCP) Server ist ein leistungsstarkes Werkzeug in unserem Framework für KI-Aktionen. Er ermöglicht es dem branchly-KI-Agenten, durch die Anbindung externer Systeme ein noch breiteres Aufgabenspektrum abzudecken. Ein MCP-Server kann mehrere Tools bereitstellen und eigene Logik enthalten, die außerhalb der branchly-Plattform ausgeführt wird. Dies erlaubt maßgeschneidertes Verhalten und einen Bring-Your-Own-Tools-Ansatz. Der KI-Agent greift auf den MCP-Server zu und kann so beliebige Aktionen ausführen – wie das Abrufen von Live-Informationen aus REST-APIs, das Auslösen von Hintergrundereignissen oder die Automatisierung spezifischer Workflows.

MCP-Server-URL (erforderlich): Eine gültige MCP-URL. Der Server muss das moderne Streamable-http-Protokoll oder SSE unterstützen.
Header: Optionale Header, die an den Server übergeben werden. Beispiel: {"Authorization": "Bearer DEIN_API_SCHLUESSEL"}
Bild-URL: Optionaler Link zu einem Bild. Dieses Bild dient ausschließlich Anzeigezwecken und hat keinen Einfluss auf die Backend-Funktionalität.

Wir bieten einige vorgefertigte MCP-Server an, die du selbst aktivieren kannst: DHL-Sendungsverfolgung, Airbnb-Unterkunftssuche, destination.one, Venus Social Knowledge Graph. Weitere Server (wie Shopify) befinden sich in aktiver Entwicklung.

Vorgefertigte MCP-Server

Mehrere vorgefertigte MCP-Server stehen bereit, um mit dem KI-Agenten deiner Anwendung verbunden zu werden. Die Server Venus Social Knowledge Graph, DHL und destination.one werden von branchly selbst entwickelt und gewartet. Darüber hinaus sind weitere Server wie Infomaxx und Partnersysteme verfügbar.

Da diese Server eine anwendungsspezifische Konfiguration erfordern, kontaktiere uns bitte, um Informationen zur Integration und zum Zugriff zu erhalten.

Zu den verfügbaren vorgefertigten MCP-Servern gehören:

Venus Social Knowledge Graph — POIs, Events und Tourismusinhalte (entwickelt von branchly). Siehe das Venus Social Knowledge Graph-Tool für Details.
DHL — Sendungsverfolgung (entwickelt von branchly).
destination.one — Tourismus- und Eventdaten (entwickelt von branchly).
Infomaxx — zusätzliche Datenintegrationen.
Airbnb listing search — Suche nach Airbnb-Unterkünften.
Weitere Server (z. B. Shopify) befinden sich in aktiver Entwicklung.

Externe Systeme über die vorgefertigten Server hinaus lassen sich problemlos über unser API-Tool oder eigene MCP-Server anbinden. Typische Beispiele sind Shopware, Shopify, n8n Workflows, HubSpot, Salesforce, Zendesk, Feratel, micado.cc und mein.toubiz – jedes System, das eine REST-API oder eine MCP-kompatible Schnittstelle bereitstellt, kann auf diese Weise angebunden werden.

API (REST)

Mit dem API-Tool kannst du externe REST-APIs in deine branchly-Anwendung integrieren. Der KI-Agent kann diese APIs basierend auf Nutzeranfragen dynamisch aufrufen. Das macht das Tool ideal für den Abruf von Echtzeitdaten, das Auslösen von Aktionen in externen Systemen oder die Integration von Drittanbieterdiensten ohne komplexe Workflow-Builder.

Funktionsweise

Der KI-Agent erfasst die erforderlichen Parameter im Gespräch mit dem Nutzer und erstellt bzw. führt die API-Anfrage anschließend an deinem konfigurierten Endpunkt aus. Die Antworten werden verarbeitet und dem Nutzer in natürlicher Dialogform präsentiert.

Konfigurationsoptionen

Grundeinstellungen

HTTP-Methode: Wähle die HTTP-Methode für die API-Anfrage (GET, POST, PUT, PATCH, DELETE).
URL (erforderlich): Die Endpunkt-URL der API. Du kannst Parameter-Platzhalter in der Schreibweise {{parameter_name}} einfügen, um dynamische URLs zu erstellen.
- Beispiel: https://api.example.com/users/{{user_id}}/orders/{{order_id}}
Timeout: Timeout der Anfrage in Sekunden (1–30 Sekunden). Der Standardwert stellt sicher, dass API-Aufrufe nicht unbegrenzt blockieren.
Body Content Type: Bestimme den Inhaltstyp für den Request-Body (typischerweise application/json für JSON-Payloads).
Response Path: JSON-Pfad zum Extrahieren spezifischer Daten aus der API-Antwort. Beispiel: data.result.items

Query-Parameter

Definiere Abfrageparameter, die an die URL angehängt werden (z. B. ?key=value&filter=active).

Key: Der Name des Query-Parameters.
Value: Der Wert des Query-Parameters. Kann Parameter-Platzhalter in der Schreibweise {{parameter_name}} enthalten.
- Beispiel: filter={{status}}&limit={{max_results}}

Header

Definiere HTTP-Header für Authentifizierung, Content Negotiation oder andere Zwecke.

Header Name: Der Name des HTTP-Headers (z. B. Authorization, Content-Type, X-API-Key).
Header Value: Der Wert für den Header. Kann Parameter-Platzhalter in der Schreibweise {{parameter_name}} enthalten.
- Beispiel: Bearer {{api_token}}

Anstelle statischer Header kannst du die Authentifizierung von branchly verwalten lassen: Binde unter Einstellungen → Integrationen eine Token Endpoint-Integration an und wähle sie anschließend unter Authentifizierungs-Integration aus. branchly meldet sich mit den gespeicherten Zugangsdaten am konfigurierten Endpunkt an und fügt das resultierende Bearer-Token automatisch in jede Anfrage ein – Tokens werden zwischengespeichert und rechtzeitig vor Ablauf aktualisiert.

Request-Body

Definiere den Request-Body als JSON für POST-, PUT- oder PATCH-Anfragen. Verwende Parameter-Platzhalter, um dynamische Werte einzufügen, die von Nutzern erfasst wurden.

Body (JSON): Gib eine gültige JSON-Struktur ein. Verwende die Notation {{parameter_name}}, um Parameter zu referenzieren.
- Beispiel:

{
  "user_id": "{{user_id}}",
  "action": "{{action_type}}",
  "metadata": {
    "timestamp": "{{timestamp}}",
    "source": "branchly"
  }
}

Parameter

Definiere Parameter, die der KI-Agent während der Konversation von Nutzern erfassen soll. Diese Parameter können in deiner gesamten API-Konfiguration mithilfe der Notation {{parameter_name}} in URLs, Headern, Query-Parametern oder im Request-Body referenziert werden.

Parameter Name (erforderlich): Ein eindeutiger Bezeichner für den Parameter (z. B. user_id, order_number, search_query). Verwende snake_case oder camelCase ohne Leerzeichen.
Parameter Type: Der Datentyp des Parameters:
- string: Textwerte
- number: Numerische Werte
- boolean: Wahr/Falsch-Werte
- array: Liste von Werten
- object: Strukturierte Daten
Parameter Description (erforderlich): Eine präzise Beschreibung, die dem KI-Agenten hilft zu verstehen, wann und wie dieser Parameter vom Nutzer erfasst werden soll. Sei spezifisch bezüglich des erwarteten Formats und Zwecks.
- Beispiel: „Die vom Kunden angegebene eindeutige Bestellnummer, typischerweise ein 6- bis 8-stelliger numerischer Wert“
Required: Schalter, ob dieser Parameter zwingend erfasst werden muss, bevor der API-Aufruf ausgeführt werden kann.

Best Practices

Verwende sprechende Parameternamen, die deren Zweck eindeutig kennzeichnen.
Verfasse detaillierte Parameterbeschreibungen, damit der KI-Agent die richtigen Informationen erfasst.
Markiere nur essenzielle Parameter als erforderlich, um unnötige Reibungspunkte für den Nutzer zu vermeiden.
Teste deine API-Konfiguration mit verschiedenen Szenarien, um eine zuverlässige Parametererfassung sicherzustellen.
Nutze Name und Beschreibung des Tools (siehe Allgemeine Parameter), um klar zu definieren, wann die KI diese API aufrufen soll.

Typische Anwendungsfälle

Bestellstatus-Abfragen: Echtzeit-Bestellinformationen aus deinem E-Commerce-System abrufen
Kundenkonto-Abfragen: Kontodetails, Abonnementstatus oder Rechnungsinformationen bereitstellen
Bestandsprüfungen: Aktuelle Produktverfügbarkeit aus deinem Warenwirtschaftssystem prüfen
Terminbuchungen: Termine in deinem Planungssystem erstellen oder ändern
Support-Ticket-Erstellung: Tickets automatisch in deinem Helpdesk-System anlegen

Node-Lookup

Mit dem Node-Lookup-Tool kannst du gezielt Informationen aus bestimmten Nodes der Wissensbasis abrufen. Der Agent nutzt Name und Beschreibung der Nodes, um zu entscheiden, wann dieses Tool ausgeführt werden soll. Dies ist besonders nützlich, wenn du eine präzise Kontrolle über die Reaktion des Agenten auf ein bestimmtes Thema benötigst.

Nodes (erforderlich): Die Nodes, die aus der Wissensbasis zurückgegeben werden sollen.

Wetter

Nutze dieses Tool, um aktuelle Informationen über das gegenwärtige und künftige Wetter für einen bestimmten Ort abzurufen. Der Standort wird vom Nutzer genannt oder kann über die Tool-Beschreibung fest vorgegeben werden (z. B. wenn du diese Funktion nur für einen bestimmten Ort anbieten möchtest).

Google Maps Wegbeschreibung

Mit dem Google Maps Directions-Tool kann der KI-Agent Routen- und Navigationsoptionen direkt im Chat-Interface bereitstellen.

Funktionsweise: Wenn ein Nutzer nach einer Wegbeschreibung oder Routendetails fragt, formatiert der KI-Agent eine Routenanfrage anhand von Koordinaten oder Adressangaben.
Methoden:
1. Google Maps Direction Link (kostenlos): Erstellt einen klickbaren externen Link (https://www.google.com/maps/dir/?api=1...), der die Route in Google Maps öffnet. Diese Methode ist kostenlos und erfordert keinen API-Schlüssel.
2. Google Maps Embed (Iframe): Bettet eine interaktive Karte über die Google Maps Embed API direkt im Chatfenster ein (https://www.google.com/maps/embed/v1/directions...). Hierfür muss ein GOOGLE_MAPS_API_KEY in deiner Anwendungsumgebung hinterlegt sein.
Parameter:
- origin (erforderlich): Startadresse oder Breiten-/Längenkoordinaten.
- destination (erforderlich): Zieladresse oder Breiten-/Längenkoordinaten.
- travelmode / mode (optional): Das Fortbewegungsmittel (driving, walking, bicycling oder transit).

Nutze die Venus Social Knowledge Graph API, um auf POIs, Veranstaltungen usw. für Tourismusunternehmen zuzugreifen. Von der Venus-API zurückgegebene Entitäten können Frontend-Events zugeordnet werden, die dem Nutzer angezeigt werden.

Projects (erforderlich): Ein oder mehrere Projekte, getrennt durch Kommas.
Channels (erforderlich): Ein oder mehrere Kanäle, getrennt durch Kommas.
Entity Types: Derzeit werden nur Veranstaltungen (Events) unterstützt.
Domain (erforderlich): Website-Domain, auf die für Details verlinkt werden soll.
Frontend Event: Ordne die Pfade der Informationen, die du anzeigen möchtest, den Elementen des Events mittels Mustache-Syntax zu. Derzeit unterstützen wir folgende Events:
- Carousel

Regiondo

Nutze die Regiondo-API, um auf anstehende Veranstaltungen und Produkte zuzugreifen. Von der API zurückgegebene Entitäten können Frontend-Events zugeordnet werden, die dem Nutzer angezeigt werden.

Public Key (erforderlich): Public Key deines Regiondo-Shops.
Secret Key (erforderlich): Secret Key deines Regiondo-Shops. Wichtig: Der „Live“-Modus muss aktiviert sein, um Produkte abrufen zu können.
Frontend Event: Ordne die Pfade der Informationen, die du anzeigen möchtest, den Elementen des Events mittels Mustache-Syntax zu. Derzeit unterstützen wir folgende Events:
- Carousel

BayernCloud

Nutze die API von https://bayerncloud.digital/, um auf POI-Informationen für Tourismusunternehmen zuzugreifen.

Dieses Tool ist als vordefinierte API-Tool-Vorlage realisiert. Bitte kontaktiere uns, um es für deine Anwendung zu aktivieren.

Holidu

Nutze die Holidu-API für die Whitelabel-Unterkunftssuche von Tourismusunternehmen.

Dieses Tool ist als vordefinierte API-Tool-Vorlage realisiert. Bitte kontaktiere uns, um es für deine Anwendung zu aktivieren.

E-Mail senden (veraltet)

Veraltet. Verwende stattdessen Formular.

Wenn ein Nutzer den Wunsch äußert, per E-Mail kontaktiert zu werden, wird dieses Tool ausgelöst, um diese Kommunikation zu ermöglichen. Es erfordert die E-Mail-Adresse des Nutzers als Teil der Nachricht, um den Prozess zu starten.

Sender Email (erforderlich): Deine ausgewählte E-Mail-Adresse, mit der du mit dem Nutzer kommunizieren möchtest.

Verfügbarkeit von Tools und Benutzeroberflächen

Welche Tools ein KI-Agent nutzen kann, hängt von der jeweiligen Benutzeroberfläche ab. Die folgende Tabelle zeigt alle Tools, die internen Agent-Typen, die sie ausführen, sowie deren Verfügbarkeit pro Interface.

Legende: ✅ verfügbar · ❌ nicht verfügbar · — nicht zutreffend · veralt. = veraltet

Tool	Agent-Typen	Chat / Chat-Widget	Suche	Formular	Navigator	API-Embed	WebMCP
Wissensbasis	`chat_routing`, `search_answer`, `form_answer`, `web_mcp`	✅	✅	✅	✅	✅	✅
Formular	`chat_routing`, `form_routing`	✅	✅ (als Kontakt)	✅	✅ (als Node)	❌	❌
Webseiten-Reader	`chat_routing`, `form_answer`, `web_mcp`	✅	—	✅	—	✅	✅
MCP-Server	`chat_routing`, `form_answer`, `web_mcp`	✅	—	✅	—	✅	✅
API	`chat_routing`, `form_answer`, `web_mcp`	✅	—	✅	—	✅ (keine Events)	✅
Buttons	`chat_routing`	✅	—	—	—	❌	❌
Websuche	`chat_routing`, `form_answer`, `web_mcp`	✅	—	✅	—	✅	✅
Node-Lookup	`chat_routing`, `form_answer`, `web_mcp`	✅	—	✅	—	✅	✅
Wetter	`chat_routing`, `form_answer`, `web_mcp`	✅	—	✅	—	✅	✅
Venus Social Knowledge Graph	`chat_routing`, `form_answer`	✅	—	✅	—	✅	❌
Regiondo	`chat_routing`, `form_answer`	✅	—	✅	—	✅ (keine Events)	❌
Google Maps Link	`chat_routing`	✅	—	—	—	❌	❌
Google Maps Embed	`chat_routing`	✅	—	—	—	❌	❌
Calendly	`chat_routing`	✅	—	—	—	❌	❌

Hinweise zur Tabelle:

Chat / Chat-Widget — jedes Tool ist verfügbar (ausgeführt durch chat_routing).
Suche — nur das Wissensbasis-Tool (ausgeführt durch search_answer). Das Formular-Tool kann als separate „Kontakt“-Option im Interface konfiguriert werden (zusätzlich zu den Suchergebnissen).
Formular — Informationsabfrage-Tools werden von form_answer ausgeführt (Wissensbasis, Node-Lookup, Websuche, Webseiten-Reader, Wetter, Venus Social Knowledge Graph, Regiondo, MCP-Server, API), plus ein oder mehrere Formular-Tools über form_routing.
Navigator — nur das Wissensbasis-Tool (ausgeführt durch search_answer). Das Formular-Tool kann über einen tool-Node in der Wissensbasis verknüpft werden (siehe Abschnitt „Formular“ oben).
API-Embed (eingeschränkte Kanäle wie WhatsApp oder Slack) — alle Tools außer Formular, Buttons, Google Maps Link, Google Maps Embed und Calendly, da deren UI-Elemente dort nicht dargestellt werden können.
WebMCP — Browser-KI-Agenten können Informationsabfrage-Tools aufrufen (Wissensbasis, Node-Lookup, Websuche, Webseiten-Reader, Wetter, MCP-Server, API).