Skip to main content
GoModel ruft Oracle Generative AI über den OpenAI-kompatiblen Inferenz-Endpunkt von Oracle auf. Für die Einrichtung benötigen Sie eine OCI-IAM-Richtlinie für generativeaiapikey, eine regionsspezifische Base-URL und eine konfigurierte Modellliste (/models von Oracle ist beim API-Key-Ablauf nicht zuverlässig verfügbar).

1. Die OCI-Richtlinie hinzufügen

Diese Richtlinie auf Tenancy-Ebene genügt zum Testen. In der Produktion schränken Sie sie auf ein Compartment, einen API-Key oder ein bestimmtes Modell ein.

2. Konfigurieren

ORACLE_MODELS ist eine kommagetrennte Liste (Leerzeichen werden entfernt). Das Verhalten folgt der globalen Einstellung CONFIGURED_PROVIDER_MODELS_MODE – fallback (Standardwert) verwendet die Liste, wenn /models von Oracle nicht verfügbar oder leer ist; allowlist stellt nur konfigurierte Modelle bereit und überspringt den Upstream-Aufruf. Oder in config.yaml:
Sind beide gesetzt, überschreibt ORACLE_MODELS die YAML-Angabe models: für den entsprechenden Provider.

3. GoModel starten

4. Überprüfen

GET /v1/models gibt Modelle wie openai.gpt-oss-120b mit owned_by: "oracle" zurück. Die Responses API funktioniert auf dieselbe Weise.
Verwenden Sie ein ausreichend hohes max_tokens-Budget. Einige Reasoning-Modelle bei Oracle können kurze Completions für Reasoning-Inhalte aufbrauchen, bevor sie den endgültigen Assistant-Text ausgeben.

Mehrere Oracle-Provider

Verwenden Sie Umgebungsvariablen mit Suffix, um eine zweite Oracle-Instanz zu registrieren:
Damit wird der Provider oracle-us registriert. Greifen Sie nur dann zu YAML, wenn die generierten Namen nicht passen oder Sie Ausfallsicherheits-Einstellungen pro Provider überschreiben möchten.

Noch nicht integriert

  • Native, OCI-basierte automatische Modellerkennung (würde ORACLE_MODELS / YAML models: überflüssig machen).
  • Zuverlässige Nutzung des OpenAI-kompatiblen Endpunkts /models von Oracle beim API-Key-Ablauf.

Fehlerbehebung

  • 404 Authorization failed or requested resource not found – fehlende OCI-Richtlinie, falsche Region oder Modell für das Konto nicht verfügbar.
  • model registry has no models – setzen Sie ORACLE_MODELS oder YAML models:.
  • OCI CLI funktioniert, aber Bearer-Requests an Oracle schlagen fehl – unterschiedliche Authentifizierungsabläufe. Die OCI CLI verwendet API-Signaturschlüssel; die Inferenz von Oracle Generative AI verwendet den Bearer-API-Key von Generative AI.

Referenzen

Zuletzt geändert am 24. Oktober 2026