RAGO-X API- und Integrationsübersicht

Beispielabläufe

Dokumentenbasierte Antworten in vorhandene Tools integrieren.

• Interne Suche
• Kundensupport
• Produktdokumentation
• Portal oder Chat

Vor Umsetzung bestätigen

Betriebsvertrag der API prüfen.

• Authentifizierung
• Schemas
• Rate- und Credit-Limits
• Fehler und Wiederholungen
• Quellenformat
• Versionierung

Öffentlicher Umfang

Die Landingpage bestätigt die API, veröffentlicht aber keine vollständige Referenz.

1. Cabinet und API-Schlüssel vorbereiten

Wählen Sie unter Entwickler → API-Schlüsselverwaltung nur die benötigten Cabinets aus. Der Schlüssel wird nach dem Erstellen einmal angezeigt; speichern Sie ihn auf Ihrem Integrationsserver. Prüfen Sie Basis-URL und aktuelles Anfrageformat im API-Nutzungsleitfaden des Entwicklermenüs. Die Landingpage ist nicht der API-Server.

2. Annahme und Abschluss unterscheiden

Rufen Sie die erlaubten Cabinets ab, wählen Sie eines und senden Sie eine Frage. Verbinden Sie sich über die zurückgegebene task_id mit dem SSE-Stream und verwenden Sie denselben API-Schlüssel. Ein angenommener Auftrag ist noch keine fertige Antwort. Zeigen Sie Verarbeitung, Abschluss und Fehler getrennt an und prüfen Sie die Schritte mit den cURL-Beispielen im Leitfaden.

3. Nutzerrechte und Gespräche trennen

Die Cabinet-Freigaben eines API-Schlüssels ersetzen keine Prüfung der Rechte einzelner Nutzer. Ihr Backend muss den Zugriff auf das gewählte Cabinet prüfen und Nutzer, Cabinet und Gespräch zuordnen. Ersetzen Sie die feste session_id des Beispiels durch einen Wert je tatsächlichem Gespräch; teilen Sie kein Gespräch zwischen mehreren Nutzern.

4. Vor der Freigabe testen

Vergleichen Sie Antworten und zurückgegebene Quellen für typische Fragen. Testen Sie auch unzulässige Cabinet-Anfragen und Stream-Abbrüche. Puffern Sie Netzwerkdaten bis zu einer vollständigen SSE-Ereignisgrenze. Richten Sie Wiederholungen nach dem aktuellen API-Leitfaden aus, statt bei jeder Trennung automatisch eine neue Frage zu senden.