Zum Inhalt springen

Konfiguration von Providern

Beim Anlegen eines neuen Providers müssen technische Parameter definiert werden, die den Zugriff regeln.

Ontheia unterstützt zwei Provider-Typen:

  • HTTP API: Standard-REST-API mit API-Schlüssel (OpenAI, Anthropic, Ollama, usw.).
  • CLI: Lokales Kommandozeilenwerkzeug ohne API-Schlüssel (Gemini CLI, Claude CLI).

Für die vollständige CLI-Provider-Konfiguration siehe CLI-Provider.

  • Provider-ID (Slug): Eine eindeutige technische Kennung (z. B. openai-prod).
  • Anzeigename: Der Name, der in den Agenten-Einstellungen erscheint.
  • Basis-URL: Der Root-Endpunkt der API (z. B. https://api.openai.com).

Ontheia unterstützt vier Arten der Authentifizierung:

  • Bearer Token: Standard für OpenAI/Anthropic (Authorization: Bearer <key>).
  • Custom Header: Für APIs mit speziellen Schlüsseln (z. B. X-API-Key).
  • Query-Parameter: Der Schlüssel wird an die URL angehängt (z. B. ?api_key=<key>).
  • Keine Authentifizierung: Ideal für lokale Instanzen (z. B. Ollama im internen Netzwerk).

Wie bei den MCP-Servern wird dringend empfohlen, das Secret-Ref-Pattern zu nutzen:

  • Geben Sie statt des Keys secret:NAME_DES_KEYS an.
  • Der Host-Service löst dies sicher über seine Umgebungsvariablen auf.
  • In der UI werden diese Werte grundsätzlich maskiert angezeigt.

Was passiert, wenn Sie den Key direkt eintragen? Er wird im Klartext in der Datenbank gespeichert. Ontheia gibt ihn nicht mehr über die API heraus — das Formularfeld bleibt beim Bearbeiten leer und ein leeres Feld lässt den gespeicherten Key unverändert. Zum Ersetzen einen neuen Wert eintragen; zum Entfernen den Provider auf CLI umstellen oder den Key gezielt leeren. Verschlüsselt ist der Wert in der Datenbank nicht — dafür ist die secret:-Referenz da.

Jedem Modell kann eine Fähigkeit zugeordnet werden:

FähigkeitBeschreibung
chatSprachmodell für Chat und Aufgaben (Standard)
embeddingVektorgenerierung für semantische Suche
ttsText-zu-Sprache
sttSprache-zu-Text
imageBildgenerierung