AI Agents stellen Server-zu-Server-HTTP-Anfragen an Ihr Backend-System. Die Anfragen werden eingeleitet, wenn ein Benutzerpfad in seinem Dialog einen Integrationsknoten auslöst. Die zurückgegebenen Daten werden gespeichert und können während der AI Agent-Sitzung abgerufen werden.
Technische Anforderungen Ihrer Backend-API
API-Typen
Ihre API muss eine der folgenden Architekturen aufweisen:
- REST
- GraphQL
Antwort
Ihre API-Antwort muss den allgemeinen Anforderungen entsprechen:
- API-Antwort innerhalb von 30 Sekunden
- Rückgabe vorzugsweise im JSON-Format
Authentifizierung
Aufseiten von AI Agents ist die Identifizierung anhand der folgenden Informationen möglich:
- API-Schlüssel
- Inhaber-Token
- Temporäres Token
- Standardauthentifizierung
- OAuth 2.0
- IP-Safelists/Zulassungsliste
Selbst-Checkliste
Die folgende Selbst-Checkliste enthält Fragen und Informationen, die Ihnen beim Aufbau einer robusten API helfen sollen:
- Ist die API „durchsuchbar“ mit Daten, die einem typischen Benutzer bekannt sind oder die von Ihrem CRM übermittelt werden?
- Enthalten die Daten in der API-Antwort Informationen, die Ihrem Anwendungsfall gerecht werden?
- Wenn Ihr Anwendungsfall Daten aus mehreren Systemen erfordert, können Sie diese in einer Zwischenschicht konsolidieren?
- Ist bekannt, wann die API die HTTP-Statuscodes 200, 400 und 404 ausgibt?
- Was gibt die API zurück, wenn die Eingabe ungültig oder falsch ist?
- Legt Ihr System ein API-Ratenlimit fest?
- Wie lange braucht Ihr System, um eine Antwort zu senden?
Bitte halten Sie Folgendes bereit:
• Dokumentation: Auth, Query/Body und Antwortschema der API-Anfrage
• (Optional: eine Postman Collection)
• Testdaten für die häufigsten Ergebnisse.
Weitere Informationen zum Onboarding-Plan finden Sie im vorherigen Beitrag Angepasste Integration – Vorbereitung.