Documentazione dell'infrastruttura Oracle Cloud

Creazione di uno strumento SQL negli agenti AI generativi

Negli agenti di intelligenza artificiale generativa, ogni agente deve disporre di uno o più strumenti. È possibile creare lo strumento di un agente durante o dopo la creazione dell'agente. Per entrambe le opzioni, la creazione di uno strumento ha gli stessi passi. In questa sezione vengono descritti i passi per creare uno strumento SQL.

Prima di creare uno strumento SQL, esaminare le Linee guida degli strumenti SQL per gli agenti di intelligenza artificiale generativa e completare i task necessari.

Creazione di uno strumento SQL

  1. Selezionare Crea strumento, quindi selezionare SQL.
  2. Immettere un nome e una descrizione per questo strumento SQL.
    Una descrizione dello schema di database in questo strumento consente all'agente di comprendere meglio come generare le istruzioni di query SQL.
  3. Per la configurazione dello schema di database di importazione, selezionare una delle seguenti opzioni per fornire lo schema di database da utilizzare per questo strumento. Uno schema è un set di istruzioni SQL che devono includere tabelle, colonne, tipi di dati e relazioni per definire l'organizzazione degli oggetti nel database.
    • In linea: immettere una stringa che contenga le istruzioni SQL. La stringa deve iniziare con una parola chiave SQL valida, ad esempio CREATE e ALTER, oppure con una parentesi di apertura (.
    • Scegli dallo storage degli oggetti: selezionare un compartimento e un bucket. Quindi selezionare il file .sql che contiene le istruzioni SQL.
  4. In Personalizzazione del modello, selezionare una delle seguenti opzioni.
    • Piccolo: selezionare questa opzione per query semplici, ad esempio "Ottieni vendite totali per gennaio 2025". Un modello di piccole dimensioni offre tempi di risposta più rapidi.
    • Grande: selezionare questa opzione per query più complesse, ad esempio "Mostra le vendite medie dei primi 5 prodotti con le migliori prestazioni in Q1 2023 raggruppati per area". Un modello di grandi dimensioni offre maggiore precisione, ma al costo di una latenza più elevata.
  5. In Dialetto, selezionare una delle seguenti opzioni.
    • SQLite: selezionare questa opzione per generare query SQL in linea con le regole di sintassi SQLite. Ad esempio: SELECT * FROM users LIMIT 5;
    • Oracle SQL: selezionare questa opzione per generare query in linea con le regole di sintassi Oracle SQL. Ad esempio: SELECT * FROM users FETCH FIRST 5 ROWS ONLY;

      Questa opzione garantisce che l'istruzione SQL generata sia completamente compatibile con l'ambiente di sintassi ed esecuzione di un Oracle Database.

  6. (Facoltativo) Per Esempi di apprendimento contestuale, selezionare una delle seguenti opzioni per fornire esempi di query in linguaggio naturale che gli utenti potrebbero richiedere nel contesto dello schema fornito e delle query SQL previste da generare.
    • In linea: immettere una stringa che contenga domande di esempio in linguaggio naturale e le query SQL previste.

      Ad esempio:

      Question: Show all employees who were born in CA.
Oracle SQL: SELECT * FROM Employees WHERE BIRTHSTATE = 'CA';
    • Scegli dallo storage degli oggetti: selezionare un compartimento e un bucket. Quindi selezionare il file .txt che contiene esempi di domande e risposte nel contesto dello schema di database.
    • Nessuno: nessun esempio da fornire.
  7. (Facoltativo) Per la connessione allo strumento di database, selezionare un compartimento, quindi selezionare una connessione dal menu.

    Una connessione è necessaria solo se si desidera abilitare l'esecuzione SQL o l'autocorrezione durante una sessione di chat.

    Per assicurarsi che la connessione selezionata funzioni, selezionare Test della connessione.

    Nota

    Il test della connessione verifica solo il corretto funzionamento dell'impostazione della connessione al database nel servizio Strumenti di database e l'accesso al database. Il test non convalida l'accesso dell'agente al database. Utilizzare i criteri per assicurarsi che gli agenti AI generativi possano accedere al database.
    Suggerimento

    Se non si desidera utilizzare una connessione su questo strumento dopo averne selezionato una, selezionare x alla fine del menu per rimuovere la connessione.
  8. (Facoltativo) Per Abilita esecuzione SQL, selezionare per attivare o disattivare l'esecuzione SQL.

    Quando l'esecuzione SQL è abilitata, l'agente genera l'istruzione di query SQL, esegue la query e invia la risposta all'utente durante la sessione di chat. Vengono generate ed eseguite solo query SELECT tra cui join, più condizioni e aggregazione. Se l'esecuzione non riesce, l'agente restituisce un errore di esecuzione del database con il codice ORA (ad esempio, ORA-00933) insieme alla query SQL generata.

    Suggerimento

    Per memorizzare i risultati che superano le 100 righe in un bucket di storage degli oggetti, selezionare Abilita storage di risultati di output di grandi dimensioni nell'endpoint dell'agente.
  9. (Facoltativo) Per Abilita correzione SQL, selezionare per attivare o disattivare l'autocorrezione.

    Abilitare l'autocorrezione per correggere la query se viene restituito un errore durante l'esecuzione. Non abilitare l'autocorrezione per un'esecuzione più rapida su query più semplici.

  10. (Facoltativo) Per le istruzioni personalizzate, immettere il testo che richiede all'agente un comportamento più specifico.

    Ad esempio:

    Always use aggregators such as COUNT, SUM, AVG, MIN, MAX in Oracle SQL queries that contain GROUP BY.

  11. (Facoltativo) Per Descrizione di tabelle e colonne, selezionare una delle seguenti opzioni per fornire descrizioni più dettagliate delle tabelle e delle colonne utilizzate nel database.
    • In linea: immettere una stringa.

      Ad esempio:

      birthYear      Year employee was born
birthMonth     Month employee was born
    • Scegli dallo storage degli oggetti: selezionare un compartimento e un bucket. Quindi selezionare il file .txt contenente il testo descrittivo per le tabelle e le colonne del database.
    • Nessuno: nessuna descrizione da fornire.
  12. Selezionare Crea strumento.
Suggerimento

Eseguire una delle azioni riportate di seguito.

  • Se si sta creando un agente, tornare a Creazione di un agente in agenti AI generativi per creare un altro strumento o un endpoint.
  • Se lo strumento è stato aggiunto a un agente esistente, dopo l'attivazione dello strumento, nella pagina dei dettagli dell'agente selezionare Avvia chat per chattare con l'agente utilizzando questo strumento.
  • Se l'agente è stato creato senza endpoint, quando si è pronti per l'uso dell'agente, creare un endpoint per questo agente.
Nota

Per consentire a un revisore umano di monitorare e modificare una query generata prima di inviarla all'utente, selezionare la funzione facoltativa Abilita umano nel loop nell'endpoint dell'agente.