Creare un profilo AI

Passi per creare un profilo AI

Per aprire Impostazioni di Data Studio, andare a qualsiasi strumento e fare clic sull'icona a forma di ingranaggio contrassegnata da Impostazioni nel riquadro di navigazione a sinistra.

In Impostazioni di Data Studio andare alla scheda Profilo AI.
Fare clic su Convalida per verificare che il servizio AI generativa sia accessibile e che il profilo AI funzioni correttamente.
Fare clic sul pulsante più (+) accanto al nome del profilo AI e selezionare una modalità.
- Crea un profilo AI essenziale: per creare un profilo AI di base con funzioni limitate.
- Crea profilo AI NL2SQL: consente di utilizzare le liste di oggetti dei metadati delle tabelle per la generazione delle query.
- Crea profilo AI RAG: per utilizzare l'indice vettoriale per la ricerca semantica su dati non strutturati.
Viene visualizzata la pagina Crea profilo AI e vengono fornite le impostazioni per la modalità specifica.
Specificare le Impostazioni servizio obbligatorie per il profilo AI.
- Nome profilo: immettere un nome per il profilo AI. Impossibile modificare il nome dopo la creazione del profilo.
- Provider AI: selezionare il provider di servizi AI:
  - OCI
  - AI aperta
  - Servizio OpenAI di Azure
  - Cohere
  - Google
  - Antropico
  - Hugging Face
  Impossibile modificare il provider AI dopo la creazione del profilo.
- Credenziale: selezionare la credenziale per accedere alle API del provider di servizi API. Questi vengono memorizzati nel database e consentono di connettersi in modo sicuro AI provider di servizi AI esterni.
- Area OCI: la posizione del cluster AI generativa che si desidera utilizzare.
  
  Ogni region OCI supporta diversi LLM, ad esempio us-chicago-1, uk-london-1 e ap-osaka-1 offre molti LLM, mentre altri ne hanno meno. Nella pagina vengono visualizzati i modelli disponibili nell'area selezionata. Se un modello AI non viene visualizzato, è possibile passare da un'area all'altra per aggiornare l'elenco dei modelli.
  
  Questo campo è disponibile solo se si seleziona OCI come provider AI. Per ulteriori informazioni, vedere Aree con intelligenza artificiale generativa, Modelli di base pre-addestrati nell'intelligenza artificiale generativa.
- Modello AI: selezionare il modello AI che si desidera utilizzare per generare le risposte. I modelli AI disponibili per l'uso dipendono dal provider AI selezionato.
È possibile utilizzare il pulsante di attivazione/disattivazione Mostra codice per visualizzare l'istruzione SQL generata automaticamente per le impostazioni selezionate.
In Impostazioni avanzate è possibile fornire attributi aggiuntivi.
- Impostazioni servizio
  
  Fornire le impostazioni per i servizi cloud che il profilo AI può utilizzare. Impostazioni servizio è disponibile solo per OCI e Azure OpenAI Service. A seconda del provider AI selezionato, nella pagina vengono visualizzate le impostazioni del servizio corrispondenti:
  
  Se si seleziona OCI come provider AI, è possibile configurare quanto riportato di seguito.
  - Formato API OCI: selezionare il formato che l'API può utilizzare per inviare e ricevere i dati. Questo attributo si applica AI modelli di chat AI generativa OCI. I valori sono Nessuno, Cohere, Generico.
  - ID compartimento OCI: specificare l'OCID del compartimento a cui si desidera accedere per utilizzare il servizio OCI Generative AI. L'impostazione predefinita è l'ID compartimento del pluggable database (PDB).
  - ID endpoint OCI: indica l'OCID dell'endpoint in un cluster AI dedicato. Specificare questo campo per utilizzare un endpoint dedicato anziché un modello on-demand su un'infrastruttura condivisa.
  Se si seleziona Azure OpenAI Service come provider AI, è possibile configurare quanto segue:
  - Nome risorsa Azure: immettere un nome per l'istanza della risorsa Azure OpenAI Service. Fa parte dell'URL dell'endpoint per l'accesso al servizio. Ad esempio:
```
https://[your-resource-name].openai.azure.com/
```
  - Nome distribuzione di Azure: immettere un nome per il modello di lingua che si desidera distribuire all'interno della risorsa OpenAI di Azure.
  - Nome distribuzione incorporamento di Azure: specificare un nome per il modello di incorporamento distribuito, ad esempio text-embedding-ada-002, text-embedding-3-large e così via. Questo viene utilizzato principalmente per creare una rappresentazione vettoriale del testo.
  Per ulteriori informazioni, vedere Abilità di incorporamento di Azure OpenAI - Ricerca AI di Azure | Microsoft Learn.
- Impostazioni di generazione
  
  Fornire le impostazioni per i servizi AI generativa che il profilo AI può utilizzare.
  
  È possibile configurare il comportamento e i limiti del modello AI a cui si accede tramite il profilo AI. Consente la personalizzazione per scenari diversi, come chat AI generativa, generazione SQL o query in linguaggio naturale in Autonomous AI Database.
  - Conversazione: indica in genere se il profilo AI supporta il contesto conversazionale, consentendo al modello di mantenere il contesto su più interazioni o scambi di prompt, utile per applicazioni AI in stile chat.
  - Valori con distinzione tra maiuscole e minuscole: questa impostazione indica se i valori o i parametri di input devono essere considerati con distinzione tra maiuscole e minuscole dall'elaborazione AI. Abilitare questa opzione per applicare il caso esatto per gli input e i valori dei parametri.
  - Temperatura: si tratta di un parametro del dispositivo di scorrimento che controlla la casualità nelle risposte AI. Una temperatura più bassa (ad esempio, 0,2) rende la produzione più focalizzata e deterministica, mentre una temperatura più alta (ad esempio, 0,8) produce una generazione di testo più creativa e diversificata.
  - Arresta token: si tratta di sequenze di token che indicano al modello AI dove interrompere la generazione di ulteriori output di testo. Quando il modello genera uno di questi token, si arresta. Ciò consente di controllare la lunghezza della risposta e di prevenire il testo finale indesiderato.
  - Numero massimo di token: definisce il numero massimo di token che il modello AI può generare in risposta a un prompt. Limita la lunghezza dell'output generato per evitare risposte eccessivamente lunghe o costose.
  - Lingua di destinazione: selezionare la lingua utilizzata dal provider AI per rispondere.
  - Lingua di origine: selezionare la lingua accettata dal provider AI nel testo di input.

Se è stato selezionato Profilo AI essenziale, fare clic su Crea profilo AI per creare un profilo AI di base.

Impostazioni NL2SQL

Per creare un profilo AI NL2SQL, specificare i seguenti metadati tabella.

Modalità elenco oggetti: selezionare una delle opzioni riportate di seguito.
- Tutto: questa opzione invia i metadati per tutte le tabelle negli schemi specificati all'LLM in modo che possa generare l'istruzione SQL rispetto a una qualsiasi di esse.
- Automatico: questa opzione consente di selezionare AI per scegliere automaticamente un subset di tabelle pertinenti eseguendo la ricerca vettoriale sui metadati dello schema, in modo che vengano utilizzate solo le tabelle più probabili per un determinato prompt.
- Tabelle selezionate: questa opzione limita i metadati solo alle tabelle specifiche elencate nel profilo AI, pertanto la generazione SQL è limitata a tali tabelle.
- Nessuno: questa opzione non invia metadati di tabella da una lista di oggetti, pertanto l'intelligenza artificiale non può generare SQL su tabelle o fare affidamento su altre configurazioni che non utilizzano una lista di oggetti esplicita.
Elenco oggetti: specificare gli oggetti di database che l'LLM può utilizzare.

Se si seleziona questa opzione, viene visualizzata un'altra opzione Applica elenco oggetti. Abilitare questa opzione per limitare l'LLM alla generazione di query SQL utilizzando solo gli oggetti menzionati nell'elenco di oggetti.
Annotazioni: abilitare questa opzione per consentire all'intelligenza artificiale di fornire metadati aggiuntivi sugli oggetti di database durante la generazione dei risultati, ad esempio descrizioni di colonne o tag.
Commenti: abilitare questa opzione per consentire all'intelligenza artificiale di utilizzare i commenti di tabella e colonna del dizionario dati per comprendere meglio i dati.
Vincoli: abilitare questo controllo per consentire all'intelligenza artificiale di accedere alle informazioni su chiavi primarie, chiavi esterne e altri vincoli e comprendere la relazione tra tabelle per migliorare l'accuratezza delle query.

Se è stata selezionata la modalità NL2SQL, fare clic su Crea profilo AI per creare il profilo AI per NL2SQL.

Impostazioni RAG

Per un profilo AI RAG, specificare quanto segue:

Indice vettoriale: selezionare l'indice vettoriale da utilizzare per memorizzare e cercare le integrazioni nei documenti. Ciò consente all'intelligenza artificiale di utilizzare i vettori nel database e di trovare una risposta accurata per la query. Per ulteriori informazioni, vedere Crea indice vettoriale.
Modello di incorporamento: specifica il modello di incorporamento utilizzato per convertire il testo in rappresentazioni vettoriali memorizzate in tale indice, assicurando che il funzionamento della ricerca semantica corrisponda al modello configurato per la RAG.
Abilita origini: abilitare questa opzione per includere i collegamenti ai documenti di origine o i nomi file che hanno contribuito al risultato RAG.
Abilita offset di origine: abilitare questa opzione per includere gli offset di inizio e fine nel testo convertito del documento nel risultato RAG.
Abilita URI di origine personalizzato: abilitare questa opzione per specificare un URI di origine personalizzato da visualizzare nel risultato RAG anziché nell'URL di storage degli oggetti.

Se è stata selezionata la modalità RAG, fare clic su Crea profilo AI per creare il profilo AI per la RAG.

Vedere anche:

Gestisci profili AI

Documentazione dell'infrastruttura Oracle Cloud

Creare un profilo AI