Sintesi
Inserimento il tuo primo agente con Oracle AI Database Private Agent Factory da distribuzione in OCI fino a un test che trasforma un PDF in un articolo del blog. In questo tour connettiamo la piattaforma con Oracle Autonomous AI Database 26ai e creiamo modelli utilizzando OCI Generative AI.
Stiamo preparando il Confronto, autorizzazioni, l'utente del database e il portafoglio di connessione. Abbiamo quindi impostato la rete VCN e implementare l'applicazione da OCI Marketplace su una macchina virtuale OCI Compute.
Continuiamo con la creazione dell'utente iniziale, il test di connessione Autonomous e la configurazione di un modello generativo e di un modello di incorporazione. Abbiamo esaminato l'autenticazione endpoint e API Chiave da OCI per configurare le connessioni e salvare le impostazioni del modello.
Infine, esploriamo i modelli e l'ambiente visivo di Agent Builder. A da un modello, esaminiamo il prompt, selezioniamo il LLM e testiamo un flusso che genera un articolo del blog dal contenuto di un PDF. Confrontiamo quindi il risultato con il documento originale per rivedere come si utilizzano le informazioni di input.
Inizio
Presentazione del tour Oracle AI Database Private Agent Factory: visualizzare la piattaforma a OCI, connettersi con Autonomous e preparare un primo agente che converte un contenuto PDF in un articolo del blog.
Documentazione, condivisione e politiche
Il percorso parte dalla documentazione di installazione di OCI Marketplace e dalla scelta di un compartment per raggruppare le risorse dell'esempio. Viene poi creata una policy nella radice della tenancy con le autorizzazioni per lavorare in quel compartment. Il relatore descrive esplicitamente questa policy ampia come configurazione di prova. Il passaggio prepara l'accesso per creare il database, la rete e l'istanza dell'applicazione.
Creazione di Oracle Autonomous AI Database
In Oracle Autonomous AI Database si seleziona il compartment del laboratorio e si avvia la creazione dell'istanza. Il percorso mostra le opzioni del carico di lavoro, sceglie la versione 26ai e regola la capacità di calcolo prima di impostare la password dell'amministratore. Dopo l'avvio, si attende il completamento del provisioning. Il database deve essere disponibile per preparare l'utente da Database Actions.
Utente e privilegio in Database Actions
Da Database Actions si apre SQL e si copia lo script dei prerequisiti di installazione. I segnaposto del nome utente e della password vengono sostituiti con i valori che utilizzerà Private Agent Factory. Si eseguono quindi le istruzioni per creare l'accesso e assegnare i privilegi.
La dimostrazione controlla l'output dell'esecuzione: l'editor non accetta l'istruzione EXIT, mentre le istruzioni precedenti sono state eseguite. Si verificano la creazione dell'utente e l'assegnazione delle autorizzazioni prima di usare queste credenziali nella procedura guidata di connessione.
Scarica il portafoglio Autonomous
Dalle opzioni di connessione di Autonomous si scarica il wallet come file ZIP e si imposta la password che lo protegge. Il relatore chiarisce che questa può essere diversa dalla password dell'amministratore del database. Il file verrà poi usato con l'utente applicativo del database e la relativa password per provare la connessione da Private Agent Factory.
Creazione della rete VCN
Si apre Virtual Cloud Network, si seleziona il compartment del laboratorio e si usa la procedura guidata per creare la VCN. Si assegna un nome alla rete e se ne conferma il provisioning. Quando è disponibile, si esamina la configurazione di sicurezza. Questa VCN verrà selezionata durante la creazione dello stack di Marketplace per collocare l'istanza dell'applicazione nella rete preparata.
Regole di rete e porto d'ingresso
Nella configurazione di sicurezza della VCN si aggiungono le regole delle porte usate dal laboratorio. Il percorso identifica la porta 8080 e la porta di connessione del database, inserendo le relative informazioni di rete. Questa preparazione collega l'accesso all'applicazione alla connettività verso Autonomous. Prima di passare a Marketplace si verifica che le regole dell'esempio siano registrate nella rete.
Distribuzione da OCI Marketplace
Nel catalogo delle applicazioni di OCI Marketplace si cerca Oracle AI Database Private Agent Factory e si avvia la creazione dello stack. Si esaminano la versione, la regione, il compartment, la VCN e la sottorete pubblica scelti per la dimostrazione. Si seleziona anche la macchina virtuale; il relatore cita le opzioni E5 Flex ed E6.
Dopo aver applicato lo stack e atteso il completamento della distribuzione, si consulta l'output. Il collegamento ottenuto apre nel browser la procedura guidata di installazione, in cui verranno configurati l'utente iniziale e le connessioni.
utente iniziale e connessione con Autonomous
La procedura guidata inizia creando l'utente di accesso alla piattaforma con email e password. Si configura poi la connessione ad Autonomous: si carica il wallet e si inseriscono l'utente del database preparato in precedenza e la relativa password. Sono credenziali distinte, una per la piattaforma e l'altra per il database.
Si esegue il test di connessione e si continua quando l'esito è positivo. Durante l'installazione si esamina il log delle attività sul database e sull'applicazione fino all'abilitazione del passaggio successivo.
Configurazione LLM in OCI Generative AI
Si avvia la registrazione del modello generativo che utilizzerà la piattaforma. Nella console di OCI Generative AI si apre la chat e si sceglie un modello della famiglia Meta Llama. L'endpoint viene ricavato dall'esempio di codice della console, mentre l'identificatore del compartment viene copiato dalla relativa pagina dei dettagli in OCI. Questi valori preparano la configurazione del provider, completata poi con i dati di autenticazione.
Autenticazione API Chiave da OCI
Dal profilo OCI si prepara una API Key e si aggiunge il relativo file di chiave alla configurazione del modello. Il modulo raccoglie l'identificatore dell'utente, fingerprint, tenancy e regione, oltre all'endpoint e al compartment già definiti. Con questi dati si prova la connessione. Il percorso ne verifica l'esito prima di salvare la connessione che utilizzerà il modello generativo.
configurazione del modello embeddings
Si aggiunge una configurazione di embeddings separata da quella del modello generativo. L'esempio riutilizza l'endpoint di OCI Generative AI, il compartment e i dati di autenticazione: utente, fingerprint, tenancy e file di API Key. Si esegue un altro test di connessione e si controllano i messaggi che confermano la registrazione.
Con entrambe le configurazioni pronte, si completa l'installazione e si accede con l'utente della piattaforma. Il modello generativo e quello di embeddings sono così disponibili per i passaggi successivi.
Modelli, Agent Builder e gestione dei modelli
Dopo l'accesso si esplorano le viste principali di Private Agent Factory: template per diverse attività, base di conoscenza, Agent Builder e gestione dei modelli. I template sono riferimenti per creare altri progetti, mentre l'editor visuale permette di organizzare componenti e connessioni.
Si mostra anche che è possibile registrare altri LLM e riutilizzare i dati di accesso configurati durante l'installazione. Il percorso collega quindi la preparazione dell'infrastruttura alla scelta dei modelli e alla progettazione dell'agente che verrà provato in seguito.
Registra un altro modello LLM
Si registra un ulteriore LLM dalle opzioni di gestione dei modelli, inserendo nuovamente i dati di accesso richiesti dalla piattaforma. L'esempio rende disponibile più di un modello per configurare un agente. Si torna poi all'editor visuale, dove i componenti vengono collegati per definire il flusso e i suoi strumenti.
Template per convertire un PDF in blog
Si seleziona un template che trasforma il contenuto di un PDF in un articolo di blog. In Agent Builder si esamina il prompt che definisce la trasformazione, si sceglie il LLM e si usa il documento di input preparato nell'esempio. Dopo aver salvato la configurazione, il flusso è pronto per l'esecuzione nell'ambiente di prova.
Esecuzione dell'agente e revisione del risultato
Si invia un input di prova per eseguire l'agente con l'attività definita nel prompt. L'output ha il formato di un articolo di blog, secondo il template selezionato. Si apre poi il PDF originale e si confronta il contenuto con il testo generato. Questa verifica mostra come il flusso usa le informazioni del documento per eseguire la trasformazione richiesta.
Conclusione
Il relatore conclude la dimostrazione e anticipa prossimi video per approfondire lo strumento e aggiungere altri componenti. Il percorso termina con l'agente del template eseguito e il risultato verificato.