Documentazione dell'infrastruttura Oracle Cloud

Gestisci profili AI

È possibile creare e gestire i profili AI tramite il pacchetto DBMS_CLOUD_AI.

Vedere anche:

Usa Select AI per l'interazione del linguaggio naturale con il database

Argomento padre: Utilizzare Seleziona intelligenza artificiale per l'interazione in linguaggio naturale con il database

Utilizzare DBMS_CLOUD_AI per configurare i profili AI

Autonomous Database utilizza i profili AI per facilitare e configurare l'accesso a un LLM e per impostare la generazione, l'esecuzione e la spiegazione di SQL in base AI prompt del linguaggio naturale. Inoltre facilita il recupero della generazione aumentata utilizzando modelli di incorporamento e indici vettoriali e consente di chattare con l'LLM.

I profili AI includono oggetti di database che sono la destinazione per le query in linguaggio naturale. I metadati utilizzati da queste destinazioni possono includere i nomi delle tabelle di database, i nomi delle colonne, i tipi di dati delle colonne e i commenti. È possibile creare e configurare profili AI utilizzando le procedure DBMS_CLOUD_AI.CREATE_PROFILE e DBMS_CLOUD_AI.SET_PROFILE.

Oltre a specificare tabelle e viste nel profilo AI, è anche possibile specificare tabelle mappate con tabelle esterne, incluse quelle descritte in Query di dati esterni con Data Catalog. Ciò consente di eseguire query sui dati non solo all'interno del database, ma anche sui dati memorizzati nell'area di memorizzazione degli oggetti di un data lake.

Argomento padre: Gestisci profili AI

Esegui prerequisiti per selezione AI

Prima di utilizzare Select AI, ecco i passi per abilitare DBMS_CLOUD_AI.

Per utilizzare DBMS_CLOUD_AI è necessario quanto segue:

  • Accesso a un account cloud Oracle Cloud Infrastructure e a un'istanza di Autonomous Database.
  • Account API a pagamento di un provider AI supportato, uno dei seguenti:
    Provider AI Chiavi API

    OpenAI

    Per ottenere le chiavi API, vedere Usa OpenAI.

    Provider compatibili con OpenAI

    Consulta la sezione Usa provider compatibili con OpenAI per ottenere le tue API key e provider_endpoint.

    Cohere

    Per ottenere le chiavi API segrete, consulta Use Cohere.

    Servizio OpenAI di Azure

    		 Per ulteriori informazioni sulla configurazione del servizio OpenAI di Azure, vedere Utilizzare il servizio OpenAI di Azure.

    AI generativa OCI

    Vedere Usa OCI Generative AI.

    Google

    Per ottenere le chiavi API, vedere Usa Google.

    Antropico

    Per ottenere le chiavi API, vedere Use Anthropic.

    Hugging Face

    Consulta la sezione Usa Hugging Face per ottenere le chiavi API.

    AWS

    Consulta Usa AWS per ottenere le chiavi API e l'ID modello.

  • Privilegi ACL di rete per accedere al provider AI esterno.
    Nota

    I privilegi ACL di rete non sono necessari per OCI Generative AI.
  • Credenziale che fornisce l'accesso al provider AI.

Argomento padre: Gestisci profili AI

Concedi privilegi per selezione AI

Per utilizzare Select AI, l'amministratore deve concedere il privilegio EXECUTE sul pacchetto DBMS_CLOUD_AI. Informazioni sui privilegi aggiuntivi necessari per Select AI e le relative funzioni.

Per configurare DBMS_CLOUD_AI:

  1. Concedere il privilegio EXECUTE nel pacchetto DBMS_CLOUD_AI all'utente che desidera utilizzare Select AI.

    Per impostazione predefinita, solo l'amministratore del sistema dispone del privilegio EXECUTE. L'amministratore può concedere il privilegio EXECUTE ad altri utenti.

  2. Concedere il privilegio EXECUTE su DBMS_CLOUD_PIPELINE all'utente che desidera utilizzare Seleziona AI con RAG.

    Nota

    Se l'utente dispone già del ruolo DWROLE, questo privilegio viene incluso e non è richiesta alcuna concessione aggiuntiva.

  3. Concedere l'accesso ACL di rete all'utente che desidera utilizzare Select AI e per l'endpoint del provider AI.

    L'amministratore di sistema può concedere l'accesso all'ACL di rete. Per ulteriori informazioni, vedere APPEND_HOST_ACE Procedure.

  4. Creare una credenziale per abilitare l'accesso al provider AI.

    Per ulteriori informazioni, vedere CREATE_CREDENTIAL Procedure.

  5. Concedere quote nella tablespace per gestire la quantità di spazio in una tablespace specifica all'utente che desidera utilizzare Seleziona AI con RAG.

Argomento padre: Gestisci profili AI

Esempi di privilegi per l'esecuzione di Select AI

Esaminare gli esempi di privilegi necessari per utilizzare Select AI e le relative funzioni.

L'esempio seguente concede il privilegio EXECUTE a ADB_USER:
GRANT execute on DBMS_CLOUD_AI to ADB_USER;

L'esempio seguente concede il privilegio EXECUTE per il pacchetto DBMS_CLOUD_PIPELINE richiesto per RAG: 

GRANT EXECUTE on DBMS_CLOUD_PIPELINE to ADB_USER;

Per controllare i privilegi concessi a un utente per i pacchetti DBMS_CLOUD_AI e DBMS_CLOUD_PIPELINE, un amministratore può eseguire le operazioni riportate di seguito. 

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');
L'esempio seguente concede a ADB_USER il privilegio di utilizzare l'endpoint api.openai.com.
Nota

Questa procedura non è applicabile all'AI generativa OCI. 
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;
/

Di seguito sono riportati i parametri disponibili.

  • host: l'host, che può essere il nome o l'indirizzo IP dell'host. È possibile utilizzare un carattere jolly per specificare un dominio o una subnet IP. Il nome host o dominio non fa distinzione tra maiuscole e minuscole.

    Provider AI Host

    OpenAI

    api.openai.com

    Provider compatibili con OpenAI

    Ad esempio, per Fireworks AI, utilizzare api.fireworks.ai

    Cohere

    api.cohere.ai

    Servizio OpenAI di Azure

    <azure_resource_name>.openai.azure.com

    Per ulteriori informazioni su azure_resource_name, vedere Attributi profilo.

    Google

    generativelanguage.googleapis.com

    Antropico

    api.anthropic.com

    Hugging Face

    api-inference.huggingface.co

    AWS

    bedrock-runtime.us-east-1.amazonaws.com

  • ace: le voci di controllo dell'accesso (ACE). Il tipo XS$ACE_TYPE viene fornito per creare ogni voce ACE per l'ACL. Per ulteriori dettagli, vedere Creazione di ACL e ACE.

Nell'esempio seguente viene creata una credenziale per abilitare l'accesso a OpenAI. 


EXEC 
DBMS_CLOUD.CREATE_CREDENTIAL(
credential_name   => 'OPENAI_CRED', 
username          =>  'OPENAI', 
password          =>  '<your_api_token>');

Di seguito sono riportati i parametri disponibili.

  • credential_name: il nome della credenziale da memorizzare. Il parametro credential_name deve essere conforme alle convenzioni di denominazione degli oggetti Oracle.

  • username: gli argomenti username e password specificano insieme le credenziali del provider AI.

    username è un nome utente specificato dall'utente.

  • password: gli argomenti username e password specificano insieme le credenziali del provider AI.

    password è la chiave API segreta del provider AI e dipende dal provider:

    Provider AI Chiavi API

    OpenAI

    Per ottenere le chiavi API, vedere Usa OpenAI.

    Provider compatibili con OpenAI

    Consulta la sezione Usa provider compatibili con OpenAI per ottenere le tue API key e provider_endpoint.

    Cohere

    Consulta la sezione Usa Cohere per ottenere le tue chiavi API.

    Servizio OpenAI di Azure

    Vedere Usa servizio OpenAI di Azure per ottenere le chiavi API e configurare il servizio.

    Nota

    Se si utilizza il principal del servizio OpenAI di Azure per l'autenticazione, è possibile saltare la procedura DBMS_CLOUD.CREATE_CREDENTIAL. Per un esempio di autenticazione utilizzando il principal del servizio Azure OpenAI, vedere Esempi di utilizzo di Select AI.

    AI generativa OCI

    Vedere Usa OCI Generative AI per generare chiavi di firma API.

    Google

    Vedere Usa Google per generare le chiavi API.

    Antropico

    Per generare le chiavi API, vedere Use Anthropic.

    Hugging Face

    Per generare le chiavi API, vedere Use Hugging Face.

    AWS

    Consulta Usa AWS per ottenere le chiavi API e l'ID modello.

Nell'esempio seguente vengono concesse quote sulla tablespace a ADB_USER per l'utilizzo di Select AI with RAG: 

ALTER USER ADB_USER QUOTA 1T ON <tablespace_name>;

Per controllare la quota di tablespace concessa a un utente, eseguire le operazioni riportate di seguito.

SELECT TABLESPACE_NAME, BYTES, MAX_BYTES 
FROM DBA_TS_QUOTAS 
WHERE USERNAME = '<username>' AND
      TABLESPACE_NAME LIKE 'DATA%';

Di seguito sono riportati i parametri disponibili.

  • TABLESPACE_NAME: la tablespace a cui è assegnata la quota. In Autonomous Database, le tablespace vengono gestite automaticamente e dispongono di DATA come prefisso.
  • BYTES: la quantità di spazio attualmente utilizzata dall'utente nella tablespace.
  • MAX_BYTES: la quota massima assegnata (in byte). Se MAX_BYTES è -1, significa che l'utente dispone di una quota illimitata sulla tablespace. L'utente del database che crea l'indice vettoriale deve avere una dimensione di MAX_BYTES sufficiente per contenere l'indice vettoriale oppure MAX_BYTES deve essere -1 per una quota illimitata.

Argomento padre: Gestisci profili AI

Configurare Select AI per utilizzare i provider AI supportati

Scopri come consentire AI provider AI di utilizzare Select AI.

  • Usa antropico
    Per consentire ad Anthropic Developer Console di generare risposte SQL e di testo ai prompt del linguaggio naturale, ottenere le chiavi API dall'account a pagamento Anthropic Developer Console.
  • Usa AWS
    Per abilitare AWS, ottieni la chiave API e l'ID modello.
  • Utilizzare il servizio OpenAI di Azure
    Per abilitare il servizio OpenAI di Azure per generare risposte SQL e di testo AI prompt del linguaggio naturale, configurare e fornire l'accesso al provider AI.
  • Usa Cohere
    Per consentire a Cohere di generare risposte SQL e di testo ai prompt del linguaggio naturale, ottenere le chiavi API dall'account a pagamento Cohere.
  • Usa Google
    Per consentire a Google AI Studio di generare risposte SQL e di testo AI prompt del linguaggio naturale, ottenere le chiavi API dall'account a pagamento di Google AI Studio.
  • Usa Hugging Face
    Per abilitare Hugging Face come provider AI per generare risposte SQL e di testo AI prompt del linguaggio naturale, ottieni le chiavi API dal tuo account a pagamento Hugging Face.
  • Usa OCI Generative AI
    Per consentire a OCI Generative AI di generare risposte SQL e di testo AI prompt del linguaggio naturale, generare una chiave di firma API.
  • Utilizzare OpenAI
    Per abilitare OpenAI per generare risposte SQL e di testo ai prompt in linguaggio naturale, ottenere le chiavi API dall'account a pagamento OpenAI.
  • Usa provider compatibili con OpenAI
    Per abilitare i provider compatibili con OpenAI, ottieni la tua API key.

Argomento padre: Gestisci profili AI

Usa antropico

Per consentire a Anthropic Developer Console di generare risposte SQL e di testo ai prompt del linguaggio naturale, ottenere API key dall'account a pagamento Anthropic Developer Console.

  1. Passare a Anthropic Developer Console.
  2. Registrati per un account se non ne hai già uno.
  3. Una volta eseguito il login, passare alla sezione API o al dashboard.
  4. Cercare un'opzione per generare o visualizzare le chiavi API.
  5. Fare clic per creare una nuova chiave API.
  6. Copiare la chiave API generata e salvarla.
    L'API Claude è un servizio a pagamento. Per poter utilizzare la chiave API, dovrai aggiungere crediti al tuo account.

Usa AWS

Per abilitare AWS, ottenere la chiave API e l'ID modello.

Ottenere la chiave API e utilizzarla per creare le credenziali tramite DBMS_CLOUD.CREATE_CREDENTIAL.

Seguire questo processo per ottenere la chiave API e il nome del modello:

  1. Registrati per un account AWS se non ne hai già uno.
  2. Creare le chiavi di accesso e le chiavi segrete da AWS Bedrock Console.
  3. Copiare le chiavi generate e salvarle.
  4. Richiedi l'accesso ai loro modelli di base. Vedere Accedi ai modelli di base di Amazon Bedrock.
  5. Ottenere l'ID modello. È necessario disporre dell'ID modello nella procedura DBMS_CLOUD_AI.CREATE_PROFILE. L'ID modello dipende dalle risorse utilizzate. Se si utilizza:
    Nota

    Il modello importato non è supportato con l'API Bedrock Converse.
Per utilizzare AWS come provider, vedere Esempio: selezionare AI con AWS.

Utilizzare il servizio OpenAI di Azure

Per consentire al servizio OpenAI di Azure di generare risposte SQL e di testo AI prompt in linguaggio naturale, configurare e fornire l'accesso al provider AI.

Per utilizzare Azure OpenAI Service, effettuare le operazioni riportate di seguito.
  1. Ottieni le tue chiavi API segrete. È possibile trovare le chiavi API nella sezione Resource Management del portale di Azure. Nella pagina Risorsa servizio OpenAI di Azure fare clic su Chiavi ed endpoint. È possibile copiare KEY1 o KEY2.
  2. Creare una risorsa di Azure OpenAI Service e distribuire un modello: Creare e distribuire una risorsa di Azure OpenAI Service.

    Suggerimento:

    • Prendere nota del nome della risorsa e del nome di distribuzione poiché tali parametri vengono utilizzati per fornire l'autorizzazione di accesso alla rete e per creare il profilo del servizio OpenAI di Azure utilizzando la procedura DBMS_CLOUD_AI.CREATE_PROFILE.
    • Per informazioni sui limiti di frequenza per il token al minuto in un modello, vedere Quote e limiti del servizio OpenAI di Azure.
  3. Consenti accesso al servizio OpenAI di Azure:

Usa Cohere

Per consentire a Cohere di generare risposte SQL e di testo ai prompt del linguaggio naturale, ottenere le chiavi API dall'account a pagamento Cohere.

  1. Accedi al sito web di Cohere con le tue credenziali. Il dashboard Cohere viene visualizzato per impostazione predefinita.

  2. In alternativa, fare clic su Dashboard.

  3. Fare clic su API Keys nella navigazione a sinistra. Copiare la chiave API predefinita o crearne un'altra. Per ulteriori informazioni, vedere API-chiavi.

Usa Google

Per consentire a Google AI Studio di generare risposte SQL e di testo AI prompt del linguaggio naturale, ottenere le chiavi API dall'account a pagamento di Google AI Studio.

  1. Vai a Google AI Studio.
  2. Fare clic su Accedi a Google AI Studio.
  3. Fare clic su Recupera chiave API nella schermata del prompt.
  4. Selezionare tutte le opzioni applicabili nella pagina successiva.
  5. Fare clic su Crea chiave API.
  6. Fare clic su Crea chiave API nel nuovo progetto.
    La schermata visualizza lo stato di avanzamento e genera una chiave API. Copiare la chiave e salvarla.

Usa faccina abbracciante

Per abilitare Hugging Face come provider AI per generare risposte SQL e di testo AI prompt del linguaggio naturale, ottieni le chiavi API dal tuo account a pagamento Hugging Face.

  1. Passare a Hugging Face.
  2. Registrati per un account se non ne hai già uno.
  3. Passare alle impostazioni dell'account.
  4. Nel menu di navigazione individuare Token di accesso.
  5. Fare clic per creare una nuova chiave API.
  6. Copiare la chiave API generata e salvarla.

Usa AI generativa OCI

Per consentire a OCI Generative AI di generare risposte SQL e di testo AI prompt del linguaggio naturale, generare una chiave di firma API.

Utilizzare la console o la riga di comando per generare una chiave di firma API per qualsiasi istanza di Oracle Database. Vedere Come generare una chiave di firma API.

Usa OpenAI

Per abilitare OpenAI per generare risposte SQL e di testo ai prompt in linguaggio naturale, ottenere le chiavi API dall'account a pagamento OpenAI.

La chiave API segreta può essere trovata dal dashboard del profilo nelle chiavi API.

Usa provider compatibili con OpenAI

Per abilitare i provider compatibili con OpenAI, ottenere la chiave API.

I provider compatibili con OpenAI utilizzano l'autenticazione bearer. Ottenere la chiave API e utilizzarla per creare le credenziali tramite DBMS_CLOUD.CREATE_CREDENTIAL. Ad esempio, Fireworks AI è un provider compatibile con OpenAI.

Seguire il processo per ottenere la chiave API AI Fireworks, l'URL del percorso di base del modello e il nome del modello:

  1. Registrati per un account Fireworks AI se non ne hai già uno.
  2. Crea una chiave API dalla console AI di Fireworks.
  3. Copiare la chiave API generata e salvarla.
  4. Ottenere l'endpoint del provider richiesto nella procedura DBMS_CLOUD_AI.CREATE_PROFILE:
    1. Selezionare uno dei modelli disponibili facendo clic sui modelli disponibili.
    2. Scorrere fino all'esempio API e ottenere il percorso URL di base compatibile con OpenAI.
      Per il modello Llama 3.2 3B Instruct, l'URL del percorso di base è: https://api.fireworks.ai/inference/v1/chat/completions. Per il parametro provider_endpoint, escludere /v1/chat/completions. Il provider_endpoint per il modello menzionato è https://api.fireworks.ai/inference.
      Nota

      Alcuni provider potrebbero richiedere un prefisso per il nome del modello, fare riferimento alla documentazione del provider AI per il formato corretto.
  5. Copiare il nome del modello dallo stesso esempio API. È necessario specificare il nome del modello nella procedura DBMS_CLOUD_AI.CREATE_PROFILE. Ad esempio, accounts/fireworks/models/llama-v3p2-3b-instruct.
Per utilizzare Firework AI come provider compatibile con OpenAI, vedere Esempio: selezione di AI con OpenAI-Compatible Providers.

Creare e impostare un profilo AI

Descrive i passi per creare e abilitare un profilo AI.

Utilizzare DBMS_CLOUD_AI.CREATE_PROFILE per creare un profilo AI. Eseguire DBMS_CLOUD_AI.SET_PROFILE per abilitare il profilo AI in modo da poter utilizzare SELECT AI con un prompt in linguaggio naturale.

Nota

È necessario eseguire DBMS_CLOUD_AI.SET_PROFILE in ogni nuova sessione (connessione) di database con conservazione dello stato prima di utilizzare SELECT AI. Se si utilizza una connessione senza conservazione dello stato, è necessario utilizzare la funzione DBMS_CLOUD_AI.GENERATE che consente di specificare il nome del profilo in ogni richiamo.

L'esempio seguente con il provider OpenAI crea un profilo AI denominato OPENAI e imposta il profilo OPENAI per la sessione utente corrente. 

-- 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.

Argomento padre: Gestisci profili AI