Documentazione dell'infrastruttura Oracle Cloud

Utilizzare la parola chiave AI per immettere i prompt

Utilizzare AI come parola chiave in un'istruzione SELECT per interagire con il database utilizzando i prompt in linguaggio naturale.

La parola chiave AI in un'istruzione SELECT indica al motore di esecuzione SQL di utilizzare l'LLM identificato nel profilo AI attivo per elaborare il linguaggio naturale e generare SQL.

È possibile utilizzare la parola chiave AI in una query con i client Oracle, ad esempio SQL Developer, OML Notebooks e strumenti di terze parti, per interagire con il database in linguaggio naturale.

Nota

Non è possibile eseguire le istruzioni PL/SQL, DDL o DML utilizzando la parola chiave AI.

Sintassi

La sintassi per l'esecuzione del prompt AI è la seguente:
SELECT AI action natural_language_prompt

Parametri

Di seguito sono riportati i parametri disponibili per il parametro action.
Parametro descrizione;

runsql

Esegue il comando SQL di base per il prompt del linguaggio naturale. Questa è l'azione predefinita ed è facoltativa specificare questo parametro.

showsql

Visualizza l'istruzione SQL per un prompt in linguaggio naturale.

explainsql

Spiega l'istruzione SQL generata dal prompt in un linguaggio naturale. Questa opzione invia l'istruzione SQL generata al provider AI per produrre una spiegazione del linguaggio naturale.

narrate

Invia il risultato della query SQL eseguita dal database all'LLM per generare una descrizione in linguaggio naturale del risultato.

Quando nel profilo AI viene specificato un indice vettoriale per abilitare RAG, il sistema utilizza il modello di trasformatore (o trasformatore predefinito) specificato per creare un'incorporamento vettoriale dal prompt per la ricerca della somiglianza semantica nell'area di memorizzazione vettoriale. Il sistema aggiunge quindi il contenuto recuperato dall'archivio vettoriale al prompt utente e lo invia all'LLM per generare una risposta basata su queste informazioni.

Se non si desidera che i dati di tabella o i documenti di ricerca vettoriali vengano inviati a un LLM, un utente con privilegi di amministratore può disabilitare tale accesso per tutti gli utenti del database specificato. Questa operazione disabilita l'azione narrate.

chat

Passa il prompt utente direttamente all'LLM per generare una risposta fornita all'utente. Se conversation nella funzione DBMS_CLOUD_AI.CREATE_PROFILE è impostato su true, questa opzione include il contenuto delle interazioni o dei prompt precedenti, inclusi potenzialmente i metadati dello schema.

Note per uso

  • La parola chiave AI per Seleziona AI non è supportata in Database Actions o nel servizio APEX. È possibile utilizzare solo la funzione DBMS_CLOUD_AI.GENERATE.

    Non utilizzare DBMS_CLOUD_AI.SET_PROFILE in Database Actions o APEX Service. In alternativa, impostare il profilo AI nell'argomento profile_name di DBMS_CLOUD_AI.GENERATE.

  • La parola chiave AI è supportata solo in un'istruzione SELECT.

  • Non è possibile eseguire istruzioni PL/SQL, DDL o DML utilizzando la parola chiave AI.

  • La sequenza è SELECT seguita da AI. Per queste parole chiave non viene applicata la distinzione tra casi. Dopo aver impostato il profilo AI utilizzando DBMS_CLOUD_AI.SET_PROFILE e l'azione facoltativa, il testo dopo SELECT AI è un prompt in linguaggio naturale. Se un profilo AI non è impostato, SELECT AI segnala il seguente errore durante l'esecuzione di un'istruzione SELECT AI: 

    ORA-00923: FROM keyword not found where expected
00923. 00000 -  "FROM keyword not found where expected"

  • Si applicano regole speciali per l'uso dei caratteri in base alle linee guida Oracle. Ad esempio, utilizzare le virgolette singole due volte se si utilizza un apostrofo in una frase.

    select ai how many customers in SF don''t own their own home

  • I LLM sono soggetti alle allucinazioni e i risultati non sono sempre corretti:

    • È possibile che SELECT AI non sia in grado di eseguire la query SQL generata per un prompt specifico del linguaggio naturale.

    • È possibile che SELECT AI non sia in grado di generare una query SQL per un prompt specifico del linguaggio naturale.

    • È possibile che l'LLM non generi una query SQL che produca un risultato corretto dato il prompt del linguaggio naturale.

    In tale scenario, SELECT AI può rispondere con informazioni per agevolare la generazione di istruzioni SQL valide.

  • Per ottenere risultati migliori con il linguaggio naturale per la generazione SQL, utilizzare viste di database o tabelle con nomi di colonna contestuali oppure aggiungere commenti di colonna per spiegare i valori memorizzati nelle colonne.

  • Utilizzare l'azione explainsql, come in SELECT AI explainsql, per ottenere una spiegazione più dettagliata dell'istruzione SQL rispetto a SELECT AI showsql.

  • Per accedere alle viste DBA o USER, vedere DBMS_CLOUD_AI Views.