KI-Profile verwalten
Sie können Ihre KI-Profile über das Package DBMS_CLOUD_AI erstellen und verwalten.
Siehe:
AI-Profile mit DBMS_CLOUD_AI konfigurieren
Autonomous AI Database verwendet KI-Profile, um den Zugriff auf ein LLM zu erleichtern und zu konfigurieren und um SQL basierend auf Eingabeaufforderungen in natürlicher Sprache zu generieren, auszuführen und zu erläutern. Es erleichtert auch die Retrieval Augmented Generation mit Einbettungsmodellen und Vektorindizes und ermöglicht das Chatten mit dem LLM.
KI-Profile umfassen Datenbankobjekte, die das Ziel für Abfragen in natürlicher Sprache sind. Metadaten, die von diesen Zielen verwendet werden, können Datenbanktabellennamen, Spaltennamen, Spaltendatentypen und Kommentare enthalten. Sie erstellen und konfigurieren AI-Profile mit den Prozeduren DBMS_CLOUD_AI.CREATE_PROFILE und DBMS_CLOUD_AI.SET_PROFILE.
Neben der Angabe von Tabellen und Ansichten im AI-Profil können Sie auch Tabellen angeben, die externen Tabellen zugeordnet sind, einschließlich der Tabellen, die unter Externe Daten mit Data Catalog abfragen beschrieben werden. Auf diese Weise können Sie Daten nicht nur innerhalb der Datenbank abfragen, sondern auch Daten, die im Objektspeicher eines Data Lakes gespeichert sind.
Voraussetzungen für KI-Auswahl ausführen
Bevor Sie Select AI verwenden, finden Sie hier die Schritte zum Aktivieren von DBMS_CLOUD_AI.
Für die Verwendung von DBMS_CLOUD_AI sind Folgendes erforderlich:
-
Zugriff auf einen Oracle Cloud Infrastructure-Cloud-Account und auf eine Autonomous AI Database-Instanz.
-
Ein kostenpflichtiges API-Konto eines unterstützten KI-Anbieters, eines von:
KI-Provider API-Schlüssel OpenAI Informationen zum Abrufen Ihrer API-Schlüssel finden Sie unter OpenAI verwenden. OpenAI-kompatible Provider Informationen zum Abrufen Ihrer API-Schlüssel finden Sie unter OpenAI-kompatible Provider verwenden und unter provider_endpoint.Cohere Informationen zum Abrufen Ihrer Secret-API-Schlüssel finden Sie unter Cohere verwenden. Azure OpenAI-Service Weitere Informationen zur Konfiguration von Azure OpenAI Service finden Sie unter Azure OpenAI Service verwenden. OCI Generative AI Siehe OCI Generative AI verwenden. Google Informationen zum Abrufen Ihrer API-Schlüssel finden Sie unter Google verwenden.
Informationen zur Gemini Enterprise Agent Platform finden Sie unter Google Cloud-Authentifizierung für Gemini Enterprise Agent Platform einrichten.Anthrop Informationen zum Abrufen Ihrer API-Schlüssel finden Sie unter Anthropic verwenden. Hugging Face Informationen zum Abrufen Ihrer API-Schlüssel finden Sie unter Hugging Face verwenden. AWS Informationen zum Abrufen Ihrer API-Schlüssel und Modell-ID finden Sie unter AWS verwenden. -
Netzwerk-ACL-Berechtigungen für den Zugriff auf Ihren externen KI-Provider.
Hinweis
Hinweis: Netzwerk-ACL-Berechtigungen sind für OCI Generative AI nicht erforderlich. -
Zugangsdaten, die Zugriff auf den AI-Provider ermöglichen.
Berechtigungen für ausgewählte KI erteilen
Um Select AI zu verwenden, muss der Administrator die Berechtigung EXECUTE für das Package DBMS_CLOUD_AI erteilen. Erfahren Sie mehr über zusätzliche Berechtigungen, die für Select AI und die zugehörigen Features erforderlich sind.
So konfigurieren Sie DBMS_CLOUD_AI:
-
Erteilen Sie dem Benutzer, der Select AI verwenden möchte, die Berechtigung
EXECUTEfür das PackageDBMS_CLOUD_AI.Standardmäßig verfügt nur der Systemadministrator über die Berechtigung
EXECUTE. Der Administrator kann anderen Benutzern die BerechtigungEXECUTEerteilen. -
Erteilen Sie dem Benutzer, der Select AI mit RAG verwenden möchte, die Berechtigung
EXECUTEfürDBMS_CLOUD_PIPELINE.Hinweis
Hinweis: Wenn der Benutzer bereits über die RolleDWROLEverfügt, ist diese Berechtigung enthalten, und es ist keine zusätzliche Berechtigung erforderlich. -
Erteilen Sie dem Benutzer, der Select AI verwenden möchte, und dem AI-Providerendpunkt Netzwerk-ACL-Zugriff.
Der Systemadministrator kann Netzwerk-ACL-Zugriff gewähren. Weitere Informationen finden Sie unter Prozedur APPEND_HOST_ACE.
-
Erstellen Sie Zugangsdaten, um den Zugriff auf Ihren AI-Provider zu ermöglichen.
Weitere Informationen finden Sie unter Prozedur CREATE_CREDENTIAL.
-
Erteilen Sie dem Benutzer, der Select AI mit RAG verwenden möchte, Quotas im Tablespace, um den Speicherplatz in einem bestimmten Tablespace zu verwalten.
Beispiele für Berechtigungen zum Ausführen von Select AI
Sehen Sie sich Beispiele für Berechtigungen an, die für die Verwendung von Select AI und der zugehörigen Features erforderlich sind.
Im folgenden Beispiel wird ADB_USER die Berechtigung EXECUTE erteilt:
GRANT execute on DBMS_CLOUD_AI to ADB_USER;Im folgenden Beispiel wird die Berechtigung EXECUTE für das Package DBMS_CLOUD_PIPELINE erteilt, das für RAG erforderlich ist:
GRANT EXECUTE on DBMS_CLOUD_PIPELINE to ADB_USER;Um die Berechtigungen zu prüfen, die einem Benutzer für die Packages DBMS_CLOUD_AI und DBMS_CLOUD_PIPELINE erteilt wurden, kann ein Administrator Folgendes ausführen:
SELECT table_name AS package_name, privilege
FROM DBA_TAB_PRIVS
WHERE grantee = '<username>'
AND (table_name = 'DBMS_CLOUD_PIPELINE'
OR table_name = 'DBMS_CLOUD_AI');Im folgenden Beispiel wird ADB_USER die Berechtigung zur Verwendung des Endpunkts api.openai.com erteilt.
Hinweis
Hinweis: Dieses Verfahren gilt nicht für OCI Generative AI.
BEGIN
DBMS_NETWORK_ACL_ADMIN.APPEND_HOST_ACE(
host => 'api.openai.com',
ace => xs$ace_type(privilege_list => xs$name_list('http'),
principal_name => 'ADB_USER',
principal_type => xs_acl.ptype_db)
);
END;
/Die Parameter sind:
-
host: Der Host, der der Name oder die IP-Adresse des Hosts sein kann. Sie können eine Domain oder ein IP-Subnetz mit einem Platzhalter angeben. Beim Host- oder Domainnamen wird die Groß-/Kleinschreibung nicht beachtet.KI-Provider Host OpenAI api.openai.com OpenAI-kompatible Provider Zum Beispiel für Fireworks AI, verwenden api.fireworks.ai Cohere api.cohere.ai Azure OpenAI-Service <azure_resource_name>.openai.azure.com. Weitere Informationen zuazure_resource_namefinden Sie unter Profilattribute.Google generativelanguage.googleapis.com Gemini Enterprise Agent-Plattform Verwenden Sie für den regionalen Endpunkt <region>-aiplatform.googleapis.com.
Bei Anwendungen, die in mehreren Google Cloud-Regionen bereitgestellt werden, sollten Sie unbedingt den globalen Endpunkt verwenden:aiplatform.googleapis.com.</br> Verwenden Sieoauth2.googleapis.com, um Tokenendpunkte für die Aktualisierung von GCP OAuth2 zuzulassen.Anthrop api.anthropic.com Hugging Face api-inference.huggingface AWS bedrock-runtime.us-east-1.amazonaws.com -
ace: Die Access Control-Einträge (ACE). Der TypXS$ACE_TYPEwird angegeben, um jeden ACE-Eintrag für die ACL zu erstellen. Weitere Informationen finden Sie unter ACLs und ACEs erstellen.
Im folgenden Beispiel werden Zugangsdaten erstellt, um den Zugriff auf OpenAI zu ermöglichen.
EXEC
DBMS_CLOUD.CREATE_CREDENTIAL(
credential_name => 'OPENAI_CRED',
username => 'OPENAI',
password => '<your_api_token>');Die Parameter sind:
-
credential_name: Der Name der zu speichernden Zugangsdaten. Der Parametercredential_namemuss den Benennungskonventionen von Oracle-Objekten entsprechen. -
username: Die Argumenteusernameundpasswordgeben gemeinsam Ihre AI-Providerzugangsdaten an.usernameist ein benutzerdefinierter Benutzername. -
password: Die Argumenteusernameundpasswordgeben gemeinsam Ihre AI-Providerzugangsdaten an.Die
passwordist Ihr Secret-API-Schlüssel des KI-Providers und hängt vom Provider ab:KI-Provider API-Schlüssel OpenAI Informationen zum Abrufen Ihrer API-Schlüssel finden Sie unter OpenAI verwenden. OpenAI-kompatible Provider Informationen zum Abrufen Ihrer API-Schlüssel und provider_endpointfinden Sie unter OpenAI-kompatible Provider verwenden.Cohere Informationen zum Abrufen Ihrer API-Schlüssel finden Sie unter Cohere verwenden. Azure OpenAI-Service Informationen zum Abrufen Ihrer API-Schlüssel und zum Konfigurieren des Service finden Sie unter Azure OpenAI Service verwenden.
Hinweis
Wenn Sie den Azure OpenAI Service-Principal zur Authentifizierung verwenden, können Sie die ProzedurDBMS_CLOUD.CREATE_CREDENTIALüberspringen. Ein Beispiel für die Authentifizierung mit dem Azure OpenAI Service-Principal finden Sie unter Beispiele für die Verwendung von Select AI.OCI Generative AI Siehe OCI Generative AI verwenden, um API-Signaturschlüssel zu generieren. - Google
- Gemini Enterprise Agent Platform </br>Informationen zum Generieren Ihrer API-Schlüssel finden Sie unter Google verwenden.
Informationen zum Einrichten von OAuth und Verwenden der Gemini Enterprise Agent Platform finden Sie unter Google Cloud-Authentifizierung für Gemini Enterprise Agent Platform einrichten.Anthrop Informationen zum Generieren Ihrer API-Schlüssel finden Sie unter Anthropic verwenden. Hugging Face Informationen zum Generieren Ihrer API-Schlüssel finden Sie unter Hugging Face verwenden. AWS Informationen zum Abrufen Ihrer API-Schlüssel und Modell-ID finden Sie unter AWS verwenden.
Im folgenden Beispiel wird der ADB_USER Quotas für den Tablespace erteilt, um Select AI mit RAG zu verwenden:
ALTER USER ADB_USER QUOTA 1T ON <tablespace_name>;Um die Tablespace Quota zu prüfen, die einem Benutzer erteilt wurde, führen Sie Folgendes aus:
SELECT TABLESPACE_NAME, BYTES, MAX_BYTES
FROM DBA_TS_QUOTAS
WHERE USERNAME = '<username>' AND
TABLESPACE_NAME LIKE 'DATA%';Die Parameter sind:
-
TABLESPACE_NAME: Der Tablespace, dem die Quota zugewiesen ist. In der autonomen KI-Datenbank werden Tablespaces automatisch verwaltet und haben das PräfixDATA. -
BYTES: Der Speicherplatz, der derzeit vom Benutzer im Tablespace belegt wird. -
MAX_BYTES: Die maximal zugewiesene Quota (in Byte). WennMAX_BYTES-1 ist, bedeutet dies, dass der Benutzer eine unbegrenzte Quota für den Tablespace hat. Der Datenbankbenutzer, der den Vektorindex erstellt, mussMAX_BYTESausreichend größer als Byte haben, um den Vektorindex aufzunehmen, oderMAX_BYTESmuss -1 für unbegrenzte Quota sein.
Ausgewählte KI zur Verwendung unterstützter KI-Provider konfigurieren
Erfahren Sie, wie Sie Ihren KI-Providern die Verwendung mit Select AI ermöglichen.
Anthropic verwenden
Um zu ermöglichen, dass Anthropic Developer Console SQL- und Textantworten auf Ihre Eingabeaufforderungen in natürlicher Sprache generiert, rufen Sie API-Schlüssel aus Ihrem kostenpflichtigen Anthropic Developer Console-Konto ab.
-
Gehen Sie zu Anthropic Developer Console.
-
Registrieren Sie sich für ein Konto, wenn Sie noch keines haben.
-
Nachdem Sie sich angemeldet haben, navigieren Sie zum API-Abschnitt oder Dashboard.
-
Suchen Sie nach einer Option zum Generieren oder Anzeigen von API-Schlüsseln.
-
Klicken Sie auf diese Option, um einen neuen API-Schlüssel zu erstellen.
-
Kopieren Sie den generierten API-Schlüssel, und speichern Sie ihn.
Die Claude API ist ein kostenpflichtiger Service. Sie müssen Ihrem Konto Guthaben hinzufügen, bevor Sie den API-Schlüssel verwenden können.
AWS verwenden
Um AWS zu aktivieren, rufen Sie Ihren API-Schlüssel und Ihre Modell-ID ab.
Rufen Sie Ihren API-Schlüssel ab, und verwenden Sie ihn, um Zugangsdaten über DBMS_CLOUD.CREATE_CREDENTIAL zu erstellen.
Führen Sie den folgenden Prozess aus, um Ihren API-Schlüssel und Modellnamen abzurufen:
-
Melden Sie sich für ein AWS-Konto an, wenn Sie noch keines haben.
-
Erstellen Sie Ihre Zugriffstasten und Secret Keys in der AWS Bedrock-Konsole.
-
Kopieren Sie die generierten Schlüssel, und speichern Sie sie.
-
Fordern Sie Zugriff auf ihre Basismodelle an. Siehe Auf Amazon Bedrock-Grundlagenmodelle zugreifen.
-
Rufen Sie die Modell-ID ab. Sie benötigen die Modell-ID in der Prozedur
DBMS_CLOUD_AI.CREATE_PROFILE. Die Modell-ID hängt von den verwendeten Ressourcen ab. Wenn Sie verwenden:-
ein Basismodell, geben Sie die Modell-ID oder den zugehörigen ARN (Amazon Resource Names) an. Eine Liste der Modell-IDs für Basismodelle finden Sie unter Amazon Bedrock-Basismodell-IDs.
-
ein Inferenzprofil, geben Sie die Inferenzprofil-ID oder deren ARN an. Eine Liste der Inferenzprofil-IDs finden Sie unter Unterstützte Regionen und Modelle für regionsübergreifende Inferenz.
-
ein bereitgestelltes Modell, geben Sie die ARN des bereitgestellten Durchsatzes an. Weitere Informationen finden Sie unter Inferenz mit einem bereitgestellten Durchsatz ausführen.
-
ein benutzerdefiniertes Modell, den bereitgestellten Durchsatz dafür erwerben. Geben Sie dann die ARN des resultierenden bereitgestellten Modells an. Weitere Informationen finden Sie unter Benutzerdefiniertes Modell in Amazon Bedrock verwenden.
-
ein Amazon Bedrock Marketplace-Modell, geben Sie die ID oder die ARN des von Ihnen erstellten Marketplace-Endpunkts an (siehe Amazon Bedrock Marketplace).
-
Hinweis
Hinweis: Das importierte Modell wird mit der Bedrock Converse API nicht unterstützt.
Informationen zur Verwendung von AWS als Provider finden Sie unter Beispiel: KI mit AWS auswählen.
Azure OpenAI Service verwenden
Damit Azure OpenAI Service SQL- und Textantworten auf Ihre Eingabeaufforderungen in natürlicher Sprache generieren kann, konfigurieren und gewähren Sie Zugriff auf den KI-Provider.
Um Azure OpenAI Service zu verwenden, führen Sie die folgenden Schritte aus:
-
Rufen Sie Ihre Secret-API-Schlüssel ab. Ihre API-Schlüssel finden Sie im Abschnitt "Resource Management" Ihres Azure-Portals. Klicken Sie auf der Seite "Azure OpenAI-Serviceressource" auf Schlüssel und Endpunkt. Sie können entweder KEY1 oder KEY2 kopieren.
-
Erstellen Sie eine Azure OpenAI Service-Ressource, und stellen Sie ein Modell bereit: Erstellen und Bereitstellen einer Azure OpenAI Service-Ressource.
Tipp:
-
Notieren Sie sich den Ressourcennamen und den Deployment-Namen, da diese Parameter zur Bereitstellung von Netzwerkzugriffsberechtigungen und zum Erstellen Ihres Azure OpenAI Service-Profils mit der Prozedur
DBMS_CLOUD_AI.CREATE_PROFILEverwendet werden. -
Informationen zu Ratenlimits für Token pro Minute in einem Modell finden Sie unter Quotas und Limits für Azure OpenAI Service.
-
-
Zugriff auf Azure OpenAI Service zulassen:
-
Sie können Ihren Secret API-Schlüssel verwenden, um den Zugriff auf Azure OpenAI Service zu ermöglichen. Weitere Informationen finden Sie im Beispiel unter Beispiele für die Verwendung von Select AI.
-
Service-Principal kann auf Azure OpenAI Service zugreifen und dem Service-Principal die erforderlichen Berechtigungen erteilen: Azure Service-Principal für den Zugriff auf Azure-Ressourcen verwenden und Rollenbasierte Zugriffskontrolle für Azure OpenAI Service. Weitere Informationen finden Sie im Beispiel unter Beispiele für die Verwendung von Select AI.
-
Cohere verwenden
Um Cohere zu ermöglichen, SQL- und Textantworten auf Ihre Eingabeaufforderungen in natürlicher Sprache zu generieren, rufen Sie API-Schlüssel von Ihrem Cohere-Konto ab.
-
Melden Sie sich mit Ihren Zugangsdaten auf der Cohere-Website an. Das Cohere Dashboard wird standardmäßig angezeigt.
-
Klicken Sie alternativ auf Dashboard.
-
Klicken Sie in der linken Navigationsleiste auf API-Schlüssel. Kopieren Sie den Standard-API-Schlüssel, oder erstellen Sie einen anderen Schlüssel. Weitere Informationen dazu finden Sie in API-Schlüssel.
Google verwenden
Um Google AI Studio zu ermöglichen, SQL- und Textantworten auf Ihre Eingabeaufforderungen in natürlicher Sprache zu generieren, rufen Sie API-Schlüssel von Ihrem kostenpflichtigen Google AI Studio-Konto ab.
-
Gehen Sie zu Google AI Studio.
-
Klicken Sie auf "Bei Google AI Studio anmelden".
-
Klicken Sie im Prompt-Fenster auf API-Schlüssel abrufen.
-
Wählen Sie auf der nächsten Seite alle gültigen Optionen aus.
-
Klicken Sie auf "API-Schlüssel erstellen".
-
Klicken Sie auf API-Schlüssel in neuem Projekt erstellen.
Auf dem Bildschirm wird der Fortschritt angezeigt und ein API-Schlüssel generiert. Kopieren Sie den Schlüssel, und speichern Sie ihn.
Google Cloud-Authentifizierung für Gemini Enterprise Agent Platform einrichten
Gemini Enterprise Agent Platform verwendet die Google Cloud OAuth 2.0-Authentifizierung. Bevor Sie ein Select AI-Profil für die Google Gemini Enterprise Agent Platform konfigurieren, richten Sie ein Google Cloud-Projekt ein, und rufen Sie die für das Profil erforderlichen OAuth 2.0-Zugangsdaten ab.
Informationen zur aktuellen Produktterminologie von Google finden Sie unter Gemini Enterprise Agent Platform – Namensänderungen.
Google Cloud-Projekt einrichten
-
Melden Sie sich bei der Google Cloud-Konsole an.
-
Erstellen Sie ein Google Cloud-Projekt, oder wählen Sie ein vorhandenes Projekt aus.
Informationen zum Einrichten einer Projekt- und Entwicklungsumgebung finden Sie unter Projekt und Entwicklungsumgebung einrichten.
Allgemeine Informationen zum Erstellen und Verwalten von Google Cloud-Projekten finden Sie unter Projekte erstellen und verwalten.
-
Notieren Sie sich die Projekt-ID.
Google Cloud weist jedem Projekt eine eindeutige Projekt-ID zu. Geben Sie diesen Wert für das Attribut
vertexai_project_idan, wenn Sie das Profil "AI auswählen" erstellen. Weitere Informationen finden Sie unter Profilattribute. -
Aktivieren Sie die Gemini Enterprise Agent Platform API für das Projekt, und stellen Sie sicher, dass Ihr Google-Konto über die erforderlichen Berechtigungen verfügt.
-
Wählen Sie eine Google Cloud-Region aus, die den gewünschten Endpunkt und die gewünschten Modelle unterstützt.
Hinweis
Hinweis: Die Option "KI auswählen" unterstützt veröffentlichte Google Gemini-Modelle, die diegenerateContent-API für die Inhaltsgenerierung verwenden, und veröffentlichte Google Gemini-Einbettungsmodelle, die dieembedContent-API für die Einbettungsgenerierung verwenden. Select AI unterstützt keine anderen Modelle, die über Gemini Enterprise Agent Platform verfügbar sind und verschiedene Inferenz-APIs verwenden, einschließlich Models as a Service (MaaS), Partnermodelle und offene Modelle. Eine Liste der Modelle, die für Gemini Enterprise Agent Platform unterstützt werden, finden Sie unter Model Garden on Gemini Enterprise Agent Platform.Notieren Sie sich die Regions-ID, wie
us-central1. Geben Sie diesen Wert für das Attributregionan, wenn Sie das Profil "AI auswählen" erstellen. Weitere Informationen finden Sie unter Profilattribute.Informationen zu unterstützten Standorten finden Sie unter Gemini Enterprise Agent Platform-Standorte.
OAuth 2.0-Zugangsdaten mit Google Cloud Shell abrufen
Mit Google Cloud Shell können Sie Application Default Credentials (ADC) generieren und die Zugangsdatenwerte OAuth 2.0 abrufen, die Select AI erfordert.
Hinweis
Hinweis: Cloud Shell authentifiziert die aktive Google Cloud-Session automatisch. In dieser Prozedur führen Sie gcloud auth application-default login speziell aus, um eine ADC-Zugangsdatendatei zu erstellen, die die Werte OAuth 2.0 enthält, die für die Datenbankzugangsdaten erforderlich sind.
-
Öffnen Sie Cloud Shell für Ihr Google Cloud-Projekt.
Cloud Shell enthält die Google Cloud-CLI und verwendet automatisch das aktive Google Cloud-Projekt.
Informationen zur Cloud Shell-Autorisierung finden Sie unter Autorisierung mit Cloud Shell.
-
Führen Sie in Cloud Shell den folgenden Befehl aus:
gcloud auth application-default login -
Befolgen Sie die Anweisungen zur Authentifizierung.
Melden Sie sich mit dem Google-Konto an, das Zugriff auf das Google Cloud-Projekt hat, und autorisieren Sie den angeforderten Zugriff.
-
Nachdem Sie die Authentifizierung abgeschlossen haben, erstellt Google eine JSON-Datei für die Standardzugangsdaten der Anwendung.
Google speichert die Datei im folgenden Standardspeicherort:
Linux und macOS
$HOME/.config/gcloud/application_default_credentials.jsonFenster
%APPDATA%\gcloud\application_default_credentials.json -
Öffnen Sie die ADC-Datei, und rufen Sie die folgenden OAuth 2.0-Werte ab:
refresh_tokenclient_idclient_secret
Verwenden Sie diese Werte, wenn Sie die Datenbankzugangsdaten für das AI-Profil "Select" erstellen. Weitere Informationen finden Sie unter Berechtigungen für ausgewählte KI erteilen.
Weitere Informationen über den Befehl und ADC finden Sie unter:
Hinweis
Hinweis: Halten Sie die ADC-Datei und die Zugangsdatenwerte OAuth 2.0 vertraulich. Geben Sie die Zugangsdaten nicht frei, schreiben Sie sie in die Quellkontrolle fest, oder nehmen Sie sie in Logs oder Dokumentation auf.
Google Cloud-Sitzungssteuerung
Ein Google Cloud-Organisationsadministrator kann eine Session-Control-Policy konfigurieren, bei der Benutzer sich regelmäßig erneut authentifizieren müssen. Wenn die Organisation diese Policy auf das Google-Konto anwendet, das mit den Zugangsdaten OAuth 2.0 verknüpft ist, kann das Aktualisierungstoken nicht mehr funktionieren, wenn die konfigurierte Session abläuft.
Google kann dann einen invalid_grant-Fehler mit einem invalid_rapt-Fehlersubtyp zurückgeben.
Um sich erneut zu authentifizieren, führen Sie den folgenden Befehl erneut aus:
gcloud auth application-default loginNachdem Google die aktualisierten Zugangsdaten generiert hat, verwenden Sie DBMS_CLOUD.UPDATE_CREDENTIAL, um die gespeicherte refresh_token zu aktualisieren. Weitere Informationen finden Sie unter Prozedur UPDATE_CREDENTIAL.
Die Session-Control-Richtlinie der Google Cloud-Organisation bestimmt dieses Verhalten. Der normale Ablauf des Refresh-Token OAuth führt nicht zu dieser Einschränkung.
Weitere Informationen finden Sie unter Sitzungskontroll-Policys für Google Cloud Platform-Organisationen.
Umarmungsgesicht verwenden
Damit Hugging Face als Ihr KI-Anbieter SQL- und Textantworten auf Ihre Eingabeaufforderungen in natürlicher Sprache generieren kann, rufen Sie API-Schlüssel von Ihrem kostenpflichtigen Hugging Face-Konto ab.
-
Gehen Sie zu Hugging Face.
-
Registrieren Sie sich für ein Konto, wenn Sie noch keines haben.
-
Navigieren Sie zu Ihren Kontoeinstellungen.
-
Suchen Sie im Navigationsmenü die Zugriffstoken.
-
Klicken Sie auf diese Option, um einen neuen API-Schlüssel zu erstellen.
-
Kopieren Sie den generierten API-Schlüssel, und speichern Sie ihn.
OCI Generative AI verwenden
Um zu ermöglichen, dass OCI Generative AI SQL- und Textantworten auf Ihre Eingabeaufforderungen in natürlicher Sprache generiert, generieren Sie einen API-Signaturschlüssel.
Verwenden Sie die Konsole oder Befehlszeile, um einen API-Signaturschlüssel für jede Oracle AI Database-Instanz zu generieren. Siehe So generieren Sie den API-Signaturschlüssel.
Verwenden Sie OpenAI
Um zu ermöglichen, dass OpenAI SQL- und Textantworten auf Ihre Eingabeaufforderungen in natürlicher Sprache generiert, rufen Sie API-Schlüssel aus Ihrem kostenpflichtigen OpenAI-Account ab.
Sie finden Ihren Secret API-Schlüssel in Ihrem Profil-Dashboard unter API-Schlüssel.
OpenAI-kompatible Provider verwenden
Um Provider zu aktivieren, die mit OpenAI kompatibel sind, rufen Sie Ihren API-Schlüssel ab.
OpenAI-kompatible Provider verwenden die Bearer-Authentifizierung. Rufen Sie Ihren API-Schlüssel ab, und verwenden Sie ihn, um Zugangsdaten über DBMS_CLOUD.CREATE_CREDENTIAL zu erstellen. Beispielsweise ist Fireworks AI ein OpenAI-kompatibler Anbieter.
Befolgen Sie den Prozess, um Ihren Fireworks AI-API-Schlüssel, die Basispfad-URL des Modells und den Modellnamen abzurufen:
-
Melden Sie sich für ein Fireworks AI-Konto an, wenn Sie noch keines haben.
-
Erstellen Sie einen API-Schlüssel über die Fireworks AI-Konsole.
-
Kopieren Sie den generierten API-Schlüssel, und speichern Sie ihn.
-
Rufen Sie den Providerendpunkt ab, den Sie in der Prozedur
DBMS_CLOUD_AI.CREATE_PROFILEbenötigen:-
Wählen Sie eines der verfügbaren Modelle aus, indem Sie auf die verfügbaren Modelle klicken.
-
Scrollen Sie zum API-Beispiel, und rufen Sie den Pfad der OpenAI-kompatiblen Basis-URL ab.
Für das Modell
Llama 3.2 3B Instructlautet die Basispfad-URL:https://api.fireworks.ai/inference/v1/chat/completions. Schließen Sie für den Parameterprovider_endpoint/v1/chat/completionsaus. Dieprovider_endpointfür das genannte Modell lautethttps://api.fireworks.ai/inference.
Hinweis
Hinweis: Einige Provider benötigen möglicherweise ein Präfix für den Modellnamen. Das korrekte Format finden Sie in der Dokumentation des AI-Providers. -
-
Kopieren Sie den Modellnamen aus demselben API-Beispiel. Sie benötigen den Modellnamen in der Prozedur
DBMS_CLOUD_AI.CREATE_PROFILE. Beispiel:accounts/fireworks/models/llama-v3p2-3b-instruct.
Informationen zur Verwendung von Firework AI als OpenAI-kompatiblen Provider finden Sie unter Beispiel: AI mit OpenAI-kompatiblen Providern auswählen.
AI-Profil erstellen und festlegen
Beschreibt die Schritte zum Erstellen und Aktivieren eines AI-Profils.
Verwenden Sie DBMS_CLOUD_AI.CREATE_PROFILE, um ein AI-Profil zu erstellen. Führen Sie DBMS_CLOUD_AI.SET_PROFILE aus, um das AI-Profil zu aktivieren, sodass Sie SELECT AI mit einer Eingabeaufforderung in natürlicher Sprache verwenden können.
Hinweis:
Sie müssen DBMS_CLOUD_AI.SET_PROFILE in jeder neuen zustandsbehafteten Datenbanksession (Verbindung) ausführen, bevor Sie SELECT AI verwenden. Wenn Sie eine zustandslose Verbindung verwenden, müssen Sie die Funktion DBMS_CLOUD_AI.GENERATE verwenden, mit der Sie den Profilnamen bei jedem Aufruf angeben können.
Wenn Sie den öffentlichen Endpunkt für einen unterstützten KI-Provider verwenden, müssen Sie nicht provider_endpoint angeben. "AI auswählen" verwendet den entsprechenden öffentlichen Endpunkt. Geben Sie provider_endpoint an, wenn Sie einen privaten Endpunkt oder einen Endpunkt für einen anderen Provider verwenden, der eine API implementiert, die mit einem Provider kompatibel ist, den Select AI unterstützt.
Das folgende Beispiel mit dem OpenAI-Provider erstellt ein AI-Profil mit dem Namen OPENAI und legt das OPENAI-Profil für die aktuelle Benutzersession fest.
-- Create AI profile
--BEGIN
DBMS_CLOUD_AI.CREATE_PROFILE(
profile_name => 'OPENAI',
attributes =>'{"provider": "openai",
"credential_name": "OPENAI_CRED",
"object_list": [{"owner": "SH", "name": "customers"},
{"owner": "SH", "name": "sales"},
{"owner": "SH", "name": "products"},
{"owner": "SH", "name": "countries"}]
}');
END;
/
PL/SQL procedure successfully completed.
--
-- Enable AI profile in current session
--
EXEC DBMS_CLOUD_AI.set_profile('OPENAI');
PL/SQL procedure successfully completed.Hinweis:
Sie können auch vordefinierte Vorlagennotizbücher in der Oracle Machine Learning-UI (OML) verwenden, um KI-Profile zu erstellen und zu konfigurieren. Navigieren Sie in der Oracle Machine Learning-Benutzeroberfläche zu Vorlagen, und gehen Sie zu Beispiele. Filtern Sie Notizbücher mit dem Schlüsselwort SelectAI, um mit SQL- und Python-APIs auf Setupbeispiele zuzugreifen.
Weitere Informationen zu folgenden Themen finden Sie in den Vorlagen-Notizbüchern SelectAI4Py -0- Voraussetzungen und Setup und SelectAI4SQL -0- Voraussetzungen und Setup:
-
Erstellung von Cloud-Authentifizierungszugangsdaten für OCI GenAI-Services
-
Erstellung eines KI-Profils für Chat, NL2SQL und Synthetic Data Generation (SDG)
-
Erstellung eines AI-Profils für RAG