RAG API Reference

Interagieren Sie mit der SmartChat RAG API ueber HTTP-Anfragen. Der Zugriff auf die API erfolgt ueber ein Gateway mit mehreren Backend-Diensten.

Basis-URL & Routing

Anfragen folgen dem Format: <base_url>/<service_path>/<route>

Beispiel: https://api-gateway.ai.t-systems.net/config-manager/redoc

Teil	Wert
Basis-URL	https://api-gateway.ai.t-systems.net
Dienstpfad	config-manager
Route	redoc

Authentifizierung

Erhalten Sie ein Bearer-Token vom Authentifizierungs-Endpunkt und fuegen Sie dann das access_token in alle nachfolgenden Anfragen ein.

curl

# Authenticate
curl --location '<BASE_URL>/api/v1/auth/user' \
  --header 'Content-Type: application/json' \
  --data '{
    "username": "<USERNAME>",
    "password": "<PASSWORD>"
  }'

# Use the token
curl --location '<BASE_URL>/chat-session-manager/api/v1/sessions/' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Python

import requests
import json

base_url = "<BASE_URL>"

# Authenticate
payload = json.dumps({"username": "<USERNAME>", "password": "<PASSWORD>"})
headers = {"Content-Type": "application/json"}
response = requests.post(f"{base_url}/api/v1/auth/user", headers=headers, data=payload)

# Add token to headers
headers["Authorization"] = f"Bearer {response.json()['access_token']}"

# Make authenticated requests
response = requests.get(f"{base_url}/chat-session-manager/api/v1/sessions/", headers=headers)
print(response.json())

Dienste

Dienst	Pfad	Dokumentation	Beschreibung
API Gateway	—	Link	Authentifizierung und Einstiegspunkt
Config Manager	config-manager	Link	Mandanten- und RAG-Konfigurationen
User Manager	user-manager	Link	Benutzer, Rollen und Gruppen
File Manager	file-manager	Link	Dateien, Dateigruppen, Wissensbasen
Ingest Master	ingest-master	Link	Datei-Ingestion-Orchestrierung
Chat Session Manager	chat-session-manager	Link	Sitzungen, Verlauf, Feedback
Query Pipeline	query-pipeline	Link	Chat-Antwortgenerierung