1. Prima di iniziare
Questo codelab a tempo libero ti guiderà nella creazione di agenti AI con Vertex AI Agent Builder di Google Cloud. Ogni passaggio evidenzierà una specifica funzionalità di Agent Builder e ne spiegherà lo scopo.
Prerequisiti
- Conoscenza di base dell'IA generativa su Google Cloud
- Una conoscenza di base dei concetti degli agenti IA
Cosa imparerai a fare
- Come creare un semplice agente IA utilizzando Vertex AI Agent Builder
- Come collegare un datastore per collegare l'agente creato
Che cosa ti serve
- Una mente curiosa
- Un computer funzionante e una connessione Wi-Fi affidabile
- Un progetto Google Cloud con fatturazione collegata
2. Progettazione del primo agente IA
Ora è tutto pronto per creare il tuo agente IA. Tuttavia, prima di iniziare a sviluppare, è essenziale definire una visione chiara per il tuo agente. Poniti queste domande chiave:
- Quale problema risolverà? Automatizzerà le attività, fornirà informazioni, offrirà intrattenimento o faciliterà l'esplorazione delle creatività?
- Quali sono le sue funzioni principali? Eseguirà attività o le delegherà? Verrà generato testo o una combinazione di contenuti multimediali diversi?
- Quali sono i suoi limiti? Sarà in grado di fare tutto in autonomia?
- Quale personalità o identità deve avere? Voglio che sia formale, informale, umoristico, utile o informativo?
- Quali sono le metriche di successo? Come misurerai l'efficacia dell'agente?
Per velocizzare la procedura, ecco le risposte alle domande per l'agente di viaggio che creerai oggi:
- Quale problema risolverà?
- Pianificare un viaggio può richiedere molto tempo e risultare complicato. Questa agenzia viaggi aiuterà gli utenti a scoprire destinazioni, pianificare itinerari e prenotare voli e alloggi.
- Quali sono le sue funzioni principali?
- L'agente deve essere in grado di
- rispondere a domande sulle destinazioni, ad esempio i requisiti per i visti
- Pianificare itinerari in linea con i programmi e gli obiettivi degli utenti
- prenotare voli e alloggi
- Quali sono i suoi limiti?
- L'agente potrebbe non essere in grado di rispondere a query complesse per impostazione predefinita
- L'agente non sarà in grado di generare immagini visive
- La conoscenza dell'agente sarà limitata dal modello sottostante
- Quale personalità o identità deve avere?
- L'agente deve essere competente, disponibile ed entusiasta di viaggiare. Deve essere in grado di comunicare informazioni in modo chiaro e conciso.
- Quali sono le metriche di successo?
- Il successo di questo agente potrebbe essere misurato dal grado di soddisfazione degli utenti per i suoi consigli (esplorazione, pianificazione, prenotazione)
3. Creare un agente AI con Vertex AI Agent Builder
Con Vertex AI Agent Builder, è possibile creare agenti IA in pochi passaggi.
Passaggio 1.
- Vai a Vertex AI Agent Builder.
- Dovresti visualizzare la pagina di benvenuto.
- Fai clic sul pulsante CONTINUA E ATTIVA L'API.
Passaggio 2:
- Verrà visualizzata la pagina di creazione dell'app.
- Fai clic sul pulsante CREA UNA NUOVA APP.
Passaggio 3:
- Seleziona Agente nella pagina successiva
Passaggio 4:
- Scegli un Nome visualizzato (ad esempio, Compagnia di viaggio)
- Seleziona globale come Regione.
- Fai clic sul pulsante ACCETTA E CREA
Passaggio 5:
- Scegli un nome agente (ad es. Agente informazioni)
- Aggiungere un obiettivo (ad es. aiutare i clienti a rispondere alle query relative ai viaggi)
- Definisci un'istruzione (ad es.Saluta gli utenti e chiedi loro come puoi aiutarli oggi stesso).
- Premi Salva al termine dell'operazione.
Passaggio 6.
- Seleziona l'agente che hai appena creato (ad es.Agente informazioni).
- Scegli il modello di IA generativa sottostante per il tuo agente (ad es. gemini-1.5-flash)
- Testa l'agente avviando una conversazione con lui (ad es.digita qualcosa nella casella di testo "Inserisci input utente").
Complimenti! Hai appena creato un agente IA utilizzando Vertex AI Agent Builder.
4. Collegamento dei datastore all'agente
Prova a chiedere all'agente come arrivare a Wakanda (ad es. "Qual è il modo migliore per raggiungere Wakanda?"). Riceverai una risposta come questa:
Sebbene questa risposta sia corretta, sarebbe più utile per l'utente se l'agente, anziché limitarsi a dire "Non posso fornire informazioni" e terminare la conversazione, suggerisse luoghi simili. Questo approccio potrebbe potenzialmente portare gli utenti a prenotare effettivamente un viaggio tramite l'agente.
Affinché l'agente possa consigliare luoghi simili, puoi fornire ulteriori informazioni tramite i datastore. Funge da knowledge base aggiuntiva a cui l'agente può fare riferimento se non è in grado di rispondere alle domande degli utenti in base alle sue conoscenze integrate.
La creazione di un datastore è semplice: fai clic sul pulsante + Datastore nella parte inferiore della pagina Nozioni di base sull'agente.
Nella schermata successiva, inserisci le seguenti informazioni:
- Nome dello strumento:Posizione alternativa
- Tipo: datastore
- Descrizione: utilizza questo strumento se la richiesta dell'utente contiene una località che non esiste
e fai clic su Salva al termine. Viene creato uno strumento di datastore per consentire all'agente di comunicare con il datastore, ma devi comunque creare un datastore effettivo contenente le informazioni. A tal fine, fai clic su Crea un datastore.
Potresti visualizzare un popup in cui ti viene chiesto di accettare che i tuoi datastore per Search and Conversation siano disponibili nella regione degli Stati Uniti. Se vuoi procedere, fai clic sul pulsante AGREE.
Per continuare la creazione dei datastore, compila il campo Nome dell'azienda (ad es. Travel Wise) e fai clic su CONTINUA.
Fai clic su CREA DATA STORE e seleziona Cloud Storage.
Una volta completato il passaggio,
- Seleziona Documenti non strutturati (PDF, HTML, TXT e altro).
- Fai clic su FILE.
- Digita ai-workshops/agents/data/wakanda.txt nella cella
- Fai clic sul pulsante CONTINUA.
Se vuoi, ecco i contenuti del file di testo fornito:
Luoghi simili a Wakanda
- Oribi Gorge in Sudafrica: le formazioni rocciose qui ricordano le cascate dei guerrieri in Wakanda.
- Cascate dell'Iguazú: situate al confine tra Argentina e Brasile, queste imponenti cascate sono state una fonte d'ispirazione importante per le cascate del Guerriero.
- Immergiti nella cultura wakanda: leggi i fumetti di Black Panther, guarda i film ed esplora le risorse online per scoprire di più sulla cultura, sulla lingua e sulla tecnologia di Wakanda.
- Visita un parco tematico Disney: anche se non esiste ancora una sezione dedicata a Wakanda, potresti riuscire a incontrare Black Panther a Disneyland o durante una crociera Disney Marvel Day at Sea.
Nella pagina successiva, assegna un nome al datastore (ad es. Wakanda Alternative) e fai clic su CREA.
Come ultimo passaggio, SELEZIONA l'origine dati appena creata e fai clic su CREA.
Se è andato tutto bene, dovresti vedere il datastore creato nella pagina Datastore disponibili.
Se fai clic sul datastore (in questo caso Wakanda Alternative), vedrai ulteriori dettagli, inclusi i documenti inclusi nel datastore:
Torna alla pagina Nozioni di base sull'agente e fai clic su Gestisci tutti gli strumenti 
.
Fai clic sul datastore creato in precedenza.
Nella sezione Datastore saranno disponibili nuove impostazioni. Se non riesci a vedere subito queste nuove impostazioni, significa che il datastore sta ancora importando i dati da Google Cloud Storage. L'operazione dovrebbe richiedere meno di 5 minuti.
- Scegli l'archivio dati da collegare (ad es. Wakanda Alternative)
- Per impedire all'agente di avere allucinazioni, imposta l'impostazione su Molto basso, che applica limitazioni più stringenti all'agente per evitare che inventi cose.
- Al termine delle modifiche, fai clic sul pulsante Salva nella parte superiore della pagina.
Torna alla pagina Informazioni di base degli agenti, controlla il datastore (ad es. Località alternativa) e fai clic sul pulsante Salva nella parte superiore della pagina.
Ci sei quasi. Il passaggio finale consiste nell'includere lo strumento "Località alternativa" nelle istruzioni dell'agente. Aggiungi una riga, - Utilizza ${TOOL: Posizione alternativa} se la richiesta dell'utente contiene una località inesistente, alle istruzioni dell'agente.
Il bordo della casella delle istruzioni potrebbe diventare rosso, ma non è un problema. Procedi con il salvataggio dell'agente facendo clic sul pulsante Salva nella parte superiore della pagina.
Dopo aver salvato la configurazione dell'agente, prova a chiedere di nuovo all'agente come arrivare a Wakanda (ad es. "Qual è il modo migliore per raggiungere Wakanda?"). Riceverai una risposta diversa, ad esempio:
Complimenti! L'agente ora consiglia luoghi utilizzando le informazioni fornite da un file di testo.