API-Aktionen erfordern technisches Verständnis für die Einrichtung von Servern oder Schnittstellen.
API-Aktionen ermöglichen es Ihnen, externe Systeme und Services mit Ihren Workflows zu verbinden, indem Sie HTTP-Anfragen an deren Endpunkte senden. Sie ermöglichen es Ihnen, Daten programmatisch an Drittanbieter-Anwendungen, Datenbanken oder eigene Server zu senden oder von diesen abzurufen. Sie können die Anfragemethode (GET, PATCH, POST, PUT, DELETE), Header, Authentifizierung und Body-Parameter entsprechend den Anforderungen der API konfigurieren. API-Aktionen sind besonders nützlich, wenn keine MCP-Integration verfügbar ist oder wenn Sie direkte Kontrolle über die HTTP-Kommunikation benötigen. Einmal konfiguriert, können diese Aktionen automatisch innerhalb Ihrer Workflows oder durch KI-Agenten ausgelöst werden, um Aufgaben zu automatisieren und Daten plattformübergreifend zu synchronisieren.
Hinweise!
Die Qualität Ihrer Daten ist wirklich wichtig! Wenn Sie der KI qualitativ minderwertige Informationen zur Verfügung stellen, erhalten Sie auch minderwertige Ergebnisse zurück (nach dem Prinzip „garbage in, garbage out”)
Jedes KI-Modell arbeitet mit Context Limits, also einer Limitierung der Datenmenge, die es von externen Systemen z.B. per API oder über einen MCP Server zur Verfügung gestellt wird.
Um die bestmögliche Antwortqualität zu erhalten, ist es essentiell, die Informationen so stark wie möglich vorzufiltern. Das Ziel ist, dass das KI-Modell ausschließlich exakt die Informationen erhält, die für die Beantwortung genau dieser einen Nachricht benötigt werden.
Ansonsten wird das KI-Modell mit ungefilterten Informationen, und damit auch einer unnötig großen Datenmenge “vollgeladen”, in der Hoffnung, dass die KI daraus eine sinnvolle Antwort erstellt, und das möglichst auch noch rasend schnell. Dies ist nicht realistisch.
Nutzen Sie daher bestmöglich die Übergabemöglichkeiten von Parametern sowohl auf Basis der Eingaben des Kontakts, als auch bei der Rückgabe von Daten per API.
Geben Sie Ihrer API-Aktion einen internen Namen und versehen Sie Ihren KI-Agenten mit Anweisungen, wann diese Aktion ausgelöst werden soll.
Fügen Sie die vorgesehene Endpunkt-URL und Methode hinzu.
Konfigurieren Sie Header, Body und Platzhalter, falls erforderlich.
Beachten Sie, dass Sie Ihre neue API-Aktion für jeden AI Agent aktivieren müssen, der darauf Zugriff haben soll – im Tab „Actions" auf der Einrichtungsseite Ihres AI Agents.