Licensed to be used in conjunction with basebox, only.
// start
Entwickler / Integrator
Sie binden basebox in Software und Fachsysteme ein: über die OpenAI-kompatible API, die REST-API, MCP-Server und eigene Konnektoren. Ihr Bereich ist Entwickler.
Was Sie brauchen – und was nicht
Für die Arbeit mit der API brauchen Sie genau zwei Dinge: einen API-Schlüssel, den ein Administrator Ihrer Organisation ausstellt, und die Basis-URL Ihrer basebox-Umgebung. Kubernetes, Helm, GPU-Treiber und Inferenz-Konfiguration gehören zum Platform Operator – Sie müssen nichts davon kennen, um zu integrieren.
Typische Aufgaben
| Aufgabe | Einstiegsseite |
|---|---|
| In wenigen Minuten zur ersten Chat-Completion | Quickstart |
Token und X-Realm-Header richtig setzen |
Authentifizierung |
| Bestehende OpenAI-Clients und -Tools anbinden | OpenAI-kompatible API · Benutzerhandbuch |
| Editor oder Coding-Agent verbinden | IDE-Integration · OpenClaw-Integration |
| Antworten streamen, Reasoning-Inhalte verarbeiten | Streaming |
| Fehler sauber behandeln | Fehlerbehandlung |
| Die REST-API-Endpunkte nachschlagen | REST API · Endpunkte |
| Verstehen, wie der Assistent Werkzeuge aufruft | MCP-Übersicht · MCP-Client |
| Einen eigenen MCP-Server anbinden | MCP-Server anbinden |
| Einen Konnektor bauen, der zu basebox passt | Konnektoren entwickeln |
Zwei Dinge, die Sie über basebox wissen sollten
Berechtigungen bleiben beim Quellsystem. Wenn der Assistent über einen Konnektor auf ein externes System zugreift, tut er das mit den Zugangsdaten des jeweiligen Nutzers. basebox kopiert oder erweitert keine Rechte. Der vollständige Ablauf steht unter Autorisierungsablauf – lesen Sie ihn, bevor Sie einen Konnektor entwerfen.
Werkzeugergebnisse sind Daten, keine Anweisungen. basebox rahmt alles, was aus einem Konnektor oder der Websuche zurückkommt, als Daten ein. Bauen Sie Ihre Konnektoren so, dass sie strukturierte, begrenzte Ergebnisse liefern – siehe Lesezugriff.
Abgrenzung zu den anderen Rollen
- Den API-Schlüssel stellt ein Administrator aus; Sie verwalten ihn nicht in der Oberfläche.
- Ob ein selbst gebauter MCP-Server im Cluster läuft und wie er dort bereitgestellt wird, entscheidet der Platform Operator – siehe MCP-Konnektoren mit Helm bereitstellen.
- Welche Konnektoren Nutzern im Chat tatsächlich zur Verfügung stehen, steuert der Administrator je Organisation und je App.
Cloud oder Server – was ändert sich für Sie?
Wenig. Die Basis-URL und der Wert des X-Realm-Headers unterscheiden sich (Cloud: Subdomain Ihrer Organisation; Server: in der Regel primary). Auf einem Server muss die REST-API außerdem per AISRV_ENABLE_REST_API aktiviert sein. Details unter Authentifizierung.