REST API · B2B · Strukturierte Ausgaben

Cultivation-Beratung als
klar definierte Produktschnittstelle.

Die SteerMind API bringt strukturierte fachliche Einordnung in Apps, Hardwareprodukte, Portale und Supportsysteme. Ihre Anwendung übergibt den relevanten Fallkontext und entscheidet, wie die Antwort dargestellt wird.

  • Serverseitige API-Key-Authentifizierung pro Integration
  • Text, Grow-Kontext und optional images in einem Request
  • Strukturierte Felder für Einordnung, Schritte, Monitoring und Unsicherheit
  • Rate-Limits, Kontingente, Request-IDs und Nutzungsanalyse
# Serverseitiger Request
POST /v1/chat
X-API-Key: sk_app_<kid>.<secret>
Content-Type: application/json

{
  "messages": [{
    "role": "user",
    "content": "Bitte ordne diesen Fall strukturiert ein."
  }],
  "context": {"channel": "partner_app"},
  "lang": "de"
}
REST API
Serverseitiger API-Key
Strukturiertes JSON
Zentral gepflegte Fachbasis

API-Vertrag

Klare Endpunkte und ein eindeutiges Credential-Modell.

B2B-Integrationen verwenden den direkten Chat-Endpunkt mit serverseitig verwahrtem API-Key. Die fachliche Wissensbasis wird zentral gepflegt; Keys und Kontingente kennzeichnen die technische Integration.

POST /v1/chat

Text- und multimodale Beratung. Optionale Bilder werden im Feld images mitgegeben.

POST /v1/feedback

Erfasst Qualitätsfeedback zur jeweiligen Antwort und unterstützt die systematische Qualitätsauswertung.

GET /v1/usage

Zeigt Verbrauch, Limits und Abrechnungsperiode der technischen Integration.

Vorhersehbares Fehlerhandling

Der aktuelle Partnervertrag nutzt nicht-streamende Antworten. Clients behandeln temporäre Fehler kontrolliert und begrenzen Wiederholungsversuche.

Antwortmodell

Strukturierte Daten statt unkontrolliertem Chattext.

direct_answer

Kurze Einordnung des aktuellen Falls.

step_sequence[]

Priorisierte nächste Schritte mit Begründung.

parameter_targets[]

Ziel- oder Referenzfelder, soweit sie für den Fall relevant sind.

monitoring_plan

Checkpoints und Kriterien für Beobachtung oder Eskalation.

citations[]

Quellen- und Relevanzinformationen für nachvollziehbare Ausgaben.

uncertainties

Fehlende Informationen und Unsicherheiten bleiben für Produkt und Nutzer sichtbar.

Integration

Erst einen realen Datenpfad validieren, dann ausrollen.

Pilot

  • Separater Sandbox-Key und begrenztes Kontingent
  • Ein klar abgegrenzter Use Case
  • Nur die benötigten Eingaben und Ausgabefelder
  • Strukturierte Qualitäts- und Fehlerauswertung

Produktion

  • Rotierbare Live-Keys pro Integration
  • Vertragliche Limits und Nutzungsreporting
  • Zentral gepflegte fachliche Wissensbasis
  • AVV, Datenaufbewahrung und Löschprozesse

Häufige Fragen

Vor dem Pilot oder der Integration.

Welcher Endpunkt wird produktiv verwendet?

B2B-Anwendungen senden strukturierte Anfragen an POST /v1/chat. Optionale Bilder werden im Chat-Payload übertragen; Zugangsdaten bleiben serverseitig.

Wie wird die Wissensbasis der API gepflegt?

Die fachliche Wissensbasis wird zentral gepflegt. API-Keys, Kontingente und Nutzung kennzeichnen die technische Integration, erzeugen aber keinen separaten Wissenskorpus.

Unterstützt die API strukturierte Antworten?

Ja. Antworten können Einordnung, priorisierte Schritte, Monitoring, Quellen und Unsicherheiten als parsierbare Daten für Produktoberflächen ausgeben.

API-Pilot

Einen echten Produktworkflow mit der SteerMind API prüfen.

Der 30-Tage-Pilot bewertet einen definierten Datenpfad, technische Einbindung, Antwortqualität, Latenz und Fehlerhandling unter realistischen Bedingungen.