Wie füge ich eine eigene API-Quelle hinzu?

Wenn die gewünschte Quelle nicht im Katalog ist, liest der KI-Crawler die Doku und legt die Quelle in unter einer Minute für dich an.

Wann der Crawler glänzt

Der Crawler funktioniert besonders gut bei REST-APIs, die Folgendes veröffentlichen:

• Eine Doku-Seite oder OpenAPI-Spec unter stabiler URL
• Klar gelabelte Endpunkte mit Parameterbeschreibungen
• Beispielantworten oder Sample-Daten

Auch GraphQL-Endpunkte werden unterstützt, sofern eine Schema-Introspection-URL verfügbar ist.

Schritte

1. Klicke links auf Quelle hinzufügen.
2. Füge die URL der Doku-Seite ein (oder OpenAPI-Spec / GraphQL-Schema-URL).
3. Optional: API-Key einfügen, falls die Quelle Authentifizierung verlangt. Wir verschlüsseln und speichern ihn im Account; der Agent nutzt ihn transparent.
4. Klicke Quelle crawlen. Der Live-Fortschritt erscheint rechts — gefundene Endpunkte, geparste Parameter, ausgeführte Sample-Requests.
5. Nach Abschluss erscheint die Quelle unter Quellen mit allen erkannten Endpunkten. Der Agent kann sie sofort abfragen.

Was der Crawler speichert

Pro Endpunkt erfassen wir: HTTP-Methode + Pfad, Parameter mit Beschreibungen, Response-Schema, Rate-Limit-Hinweise und eine kleine Sample-Response. Der Agent nutzt diese Metadaten, um zu entscheiden, welchen Endpunkt er bei einer Frage aufruft.

Wenn er scheitert

Meldet der Crawler keine Endpunkte, fehlen meist strukturierte Informationen — etwa eine handgeschriebene Prosa-Seite ohne Beispiele. Ausweg:

• Probier eine andere URL auf derselben Seite (oft gibt es eine „Reference"- oder „API"-Sub-Seite, die strukturierter ist).
• Füge eine OpenAPI-YAML/JSON-URL direkt ein, falls vorhanden.
• Reiche ein Feedback-Issue ein und wir schauen manuell drauf.