Progetta agenti in Agent Studio

Anteprima

La funzionalità degli agenti di progettazione in Agent Studio è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Relazione con altri termini. La funzionalità degli agenti di progettazione in Agent Studio aiuta i clienti a progettare "agenti AI" come definiti nei Termini specifici dei servizi e pertanto si applicano i Termini specifici dei servizi "Servizi di AI agentica". Quando utilizzi Ricerca Google come strumento in Agent Studio, si applica anche la sezione intitolata "Grounding con Ricerca Google" nei Termini specifici dei servizi, ad eccezione del fatto che il primo riferimento a "Gemini Enterprise o Agentspace" nella sottosezione (iv) della sezione "Servizi di AI agentica" viene sostituito con "Agent Platform Gemini Enterprise". Prima di utilizzare questa funzionalità, assicurati di esaminare i termini di tutti gli altri strumenti utilizzati in Agent Studio e verifica che l'agente sia appropriato per il deployment in Agent Runtime.

Questa pagina fornisce una panoramica su come utilizzare Agent Studio nella Google Cloud console.

Agent Studio è un designer visivo low-code all'interno della Google Cloud console che semplifica lo sviluppo degli agenti. Puoi mappare visivamente i workflow degli agenti, testare le risposte in tempo reale e sperimentare diverse configurazioni prima di eseguire il deployment o passare al codice.

Questo documento fornisce una panoramica di Agent Studio e spiega come configurare l'ambiente, creare e testare gli agenti ed eseguirne il deployment direttamente in un runtime di produzione.

Configura l'ambiente

Prima di utilizzare Agent Studio, configura con Google Cloud.

Ottieni i ruoli richiesti

Per ottenere le autorizzazioni necessarie per utilizzare Agent Studio, chiedi all'amministratore di concederti il ruolo IAM Utente di Agent Platform (roles/aiplatform.user) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Crea un agente

Nota: tutti i file di configurazione per gli agenti creati vengono archiviati nella regione us-west1. Se la tua organizzazione ha policy che ti impediscono di utilizzare questa regione, potresti non essere in grado di creare un agente. Per ulteriori informazioni, consulta Limitare le località delle risorse.

Segui questi passaggi per progettare e testare un agente in Agent Studio:

1. Nella Google Cloud console, vai alla pagina Agenti.
   

   Vai ad Agenti

2. Fai clic su Crea agente per aprire il canvas di Agent Studio per un nuovo agente.

3. Progetta l'agente nel canvas di Agent Studio. Puoi passare da una scheda all'altra:

   • Flusso: crea l'agente principale e i sottoagenti utilizzando una rappresentazione visiva del workflow e della logica di controllo dell'agente.

     1. Fai clic su un agente per aprire il riquadro Dettagli per quell'agente. Puoi anche fare clic su Aggiungi un sottoagente (+) per aggiungere sottoagenti.

     2. Configura l'agente principale e i sottoagenti nel riquadro Dettagli:

        1. Nome: aggiungi un nome per identificare l'agente.

        2. Descrizione: un riepilogo dello scopo dell'agente.

        3. Istruzioni: aggiungi istruzioni per guidare l'agente.

        4. Modello: seleziona il modello per alimentare l'agente.

        5. Strumenti: fai clic su Aggiungi strumenti (+) per aggiungere strumenti che consentano all'agente di completare le attività. Per ulteriori informazioni, consulta Configurare e aggiungere strumenti.

   • Anteprima: testa le funzionalità e la risposta dell'agente mentre lo crei. Chatta con l'agente per testarne le funzionalità.

4. Fai clic su Ottieni codice per visualizzare il codice dell'agente. Se vuoi continuare a sviluppare l'agente altrove, puoi copiare il codice e incollarlo in un editor di codice a tua scelta. Per altre opzioni per continuare a sviluppare l'agente, consulta i tutorial dell'ADK.

Una volta completato l'agente, puoi eseguirne il deployment direttamente da Agent Studio. Per ulteriori informazioni, consulta Eseguire il deployment di un agente da Agent Studio.

Configura e aggiungi strumenti in Agent Studio

Puoi configurare i seguenti strumenti per l'agente:

• Ricerca Google: consente all'agente di eseguire ricerche sul web utilizzando Ricerca Google. Attivato per impostazione predefinita.

• Contesto URL: consente al modello di analizzare gli URL dei prompt inviati all'agente. Attivato per impostazione predefinita.

• Datastore di ricerca di Agent Platform: fai clic su Aggiungi (+) per consentire all'agente di accedere alle informazioni indicizzate nel datastore di ricerca dell'agente.

  • Numero progetto: il Google Cloud numero di progetto associato al datastore di ricerca dell'agente. Visualizza il numero del progetto.

  • Località: La località del datastore.

  • ID datastore: ID di Firestore in modalità Datastore (Datastore) dei dati da includere. Visualizza un elenco dei datastore e degli ID.

  • ID raccolta: ID raccolta dei dati da includere. Visualizza un elenco dei datastore e degli ID raccolta. Se il datastore non ha un ID raccolta, inserisci default_collection.

  Se non hai un datastore esistente, consulta Inizia a utilizzare la ricerca personalizzata per crearne uno. Poi, concedi al account di servizio l'accesso alla ricerca di Agent Platform:

  1. Nella Google Cloud console, vai alla pagina IAM.
     

     Vai a Identity and Access Management (IAM)

  2. Fai clic su Concedi l'accesso.

  3. Nel campo Nuove entità, inserisci le seguenti informazioni del account di servizio: [e-mail].

  4. Seleziona + Aggiungi ruoli. Cerca e seleziona Utente di Discovery Engine. Fai clic su Applica e poi su Salva.

• Server MCP: fai clic su Aggiungi (+) per aggiungere gli strumenti MCP collegandoti a un server MCP.

  1. Nome visualizzato MCP: inserisci un nome per il server MCP.

  2. URL endpoint: inserisci un URL endpoint per il server MCP.

  3. Autenticazione: compilato automaticamente come Nessuno. Agent Studio supporta solo i server MCP che non richiedono l'autenticazione.

  L'agente può utilizzare tutti gli strumenti del server MCP connesso.

Esegui il deployment di un agente da Agent Studio

Dopo aver creato e visualizzato l'anteprima di un agente, puoi eseguirne il deployment in produzione. Segui questi passaggi per eseguire il deployment di un agente da Agent Studio:

1. Nella pagina dell'elenco Agenti, fai clic sull'agente di cui vuoi eseguire il deployment. Viene visualizzata la pagina dei dettagli dell'agente selezionato.

2. Fai clic su Esegui il deployment per aprire la finestra di dialogo Esegui il deployment in un'istanza di Agent Runtime.

3. (Facoltativo) Modifica il Nome visualizzato o la Descrizione dell'agente.

4. Seleziona una regione di deployment dall'elenco delle regioni disponibili, quindi fai clic su OK.

5. Fai clic su Esegui il deployment.

Il deployment crea una nuova istanza di runtime e può richiedere fino a cinque minuti. Se l'operazione va a buon fine, viene visualizzato un messaggio nella scheda Flusso del canvas di Agent Studio. L'agente è ora disponibile in produzione e può integrarsi in modo sicuro con le tue app esterne.

Visualizza un agente di cui è stato eseguito il deployment

Per visualizzare l'agente di cui è stato eseguito il deployment:

1. Nella Google Cloud console, vai alla pagina Agent Platform.
   

   Vai ad Agent Platform

2. Utilizza l'elenco Regione per filtrare in base alla regione di deployment.

3. Gli agenti di cui è stato eseguito il deployment e che fanno parte del progetto selezionato vengono visualizzati nell'elenco.

4. Fai clic sul nome dell'agente specificato. Si apre la pagina Metriche dell'agente.

Per ulteriori informazioni sulle metriche disponibili per l'agente, consulta Visualizzare le metriche per l'agente di cui è stato eseguito il deployment.