Crea un agente

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione 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 delle fasi di lancio.

In Gemini Enterprise, gli agenti vengono creati nel contesto di un'app. Puoi creare un nuovo agente in due modi principali:

• Crea un agente utilizzando un prompt: questo è il modo più rapido per creare un agente. Descrivi lo scopo dell'agente e Agent Designer genera la versione iniziale all'interno della tua app. Questa opzione è ideale per gli agenti di base o come punto di partenza per quelli più complessi.
• Crea un agente utilizzando il generatore di flussi: questo metodo ti offre un controllo diretto e granulare sulla progettazione dell'agente fin dall'inizio. È ideale per progettare agenti complessi in più passaggi che richiedono configurazioni e flussi logici specifici per i subagenti.

Questi metodi sono flessibili e puoi combinarli in base alle tue esigenze. Ad esempio, puoi iniziare con un prompt per generare l'agente iniziale e poi passare al generatore di flussi per perfezionarne visivamente la logica e aggiungere complessità.

Best practice per la creazione di agenti

Per assicurarti che i tuoi agenti funzionino in modo efficace ed efficiente, prendi in considerazione le seguenti best practice:

• Definisci obiettivi chiari: indica chiaramente cosa vuoi che raggiunga il tuo agente. Un obiettivo ben definito aiuta a progettare la logica dell'agente e a valutarne le prestazioni.
• Inizia con un agente di base, poi espandi le funzionalità: inizia con un agente di base che gestisce le funzionalità principali. Una volta che è stabile, aggiungi gradualmente altre funzionalità e complessità.
• Suddividi le attività complesse:per gli agenti in più passaggi, dividi le attività di grandi dimensioni in sotto-attività più piccole e gestibili. Ogni subagente deve avere un ruolo specifico.
• Testa in modo iterativo:testa regolarmente l'agente in ogni fase di sviluppo. In questo modo è più facile identificare e risolvere i problemi in anticipo.
• Fornisci istruzioni chiare:quando utilizzi i prompt, sii specifico e conciso. Evita l'ambiguità per assicurarti che l'agente comprenda il suo scopo. Consulta Best practice per scrivere prompt per creare un agente.

Prima di iniziare

• Assicurati di avere un'app con le origini dati necessarie collegate. Per saperne di più, vedi Creare un'app, Connettere un'origine dati Google e Connettere un'origine dati di terze parti.
• Assicurati di aver attivato il pulsante di attivazione/disattivazione della funzionalità Agent Designer per la tua app web. Per ulteriori informazioni, vedi Gestire le funzionalità delle app web.

Crea un agente utilizzando un prompt

Utilizza questo metodo per generare rapidamente un agente utilizzando l'input conversazionale.

Console

Per creare un agente utilizzando un prompt in linguaggio naturale:

1. Nella console Google Cloud , vai alla pagina Gemini Enterprise > App.

   Gemini Enterprise

2. Seleziona l'app e copia l'URL dell'app web Gemini Enterprise dalla dashboard.

3. Apri l'URL dell'app web in una nuova scheda del browser.

4. Nel menu di navigazione dell'app web, fai clic su + Crea agente.

   Viene visualizzata la pagina Finestra di progettazione agente.

5. Nella casella di chat, inserisci un prompt che descriva lo scopo e il comportamento previsto dell'agente.

   Nota :non puoi utilizzare prompt conversazionali per attivare o connetterti ai datastore della categoria Origini cloud (ad esempio BigQuery, Cloud Storage, Cloud SQL). Crea l'agente utilizzando il generatore di flussi per queste attività.
   Suggerimento: consulta le best practice per la scrittura di prompt per creare un agente.

6. (Facoltativo) Fai clic su Gestisci i tuoi dati e attiva o disattiva le origini dati che vuoi che il tuo agente utilizzi.

7. Fai clic su Invia.

   Viene visualizzato il canvas di Agent Designer, che mostra un'anteprima in tempo reale del tuo agente.

8. Nella scheda Anteprima, interagisci con l'agente per testare e valutare le sue risposte.

9. Fai clic sulla scheda Dettagli e rivedi il nome e la descrizione dell'agente.

   • (Facoltativo) Nella sezione Conoscenza, fai clic su Aggiungi file per caricare eventuali materiali di riferimento aggiuntivi per l'agente.
   • (Facoltativo) Nella sezione Personalizzazione, aggiungi prompt iniziali che guidano gli utenti su come interagire con l'agente. Puoi aggiungere tutti i prompt iniziali che vuoi, ma il sistema mostra una selezione casuale di un massimo di tre prompt alla volta.

10. (Facoltativo) Per perfezionare la funzione e il comportamento dell'agente, fornisci istruzioni aggiuntive nel riquadro della chat a sinistra.

11. Fai clic su Crea per avviare e iniziare a utilizzare l'agente.

    Nota: se esci dal canvas di Agent Designer senza fare clic su Crea, l'agente viene impostato sullo stato Bozza.

Best practice per scrivere prompt per creare un agente

Il prompt che fornisci aiuta Gemini a comprendere i tuoi obiettivi e a generare l'agente migliore possibile. Per ottenere risposte chiare e pertinenti, segui queste linee guida e best practice:

• Fornisci un contesto sufficiente per eliminare l'ambiguità

  Specifica cosa vuoi che faccia l'agente. Ad esempio, specifica il livello di dettaglio, i tipi di esempi da utilizzare o l'output richiesto. In questo modo, Gemini Enterprise può generare un piano dell'agente più pertinente e specifico per le tue esigenze.

  Non consigliato: Create an agent for sales emails.

  Consigliato: Create an agent that drafts follow-up emails for new sales leads from my CRM. It should search for the contact's company, summarize their business, and suggest how our product can help them.

• Imposta confini o limitazioni per l'output dell'agente

  Definisci cosa deve e non deve fare l'agente. Puoi impostare limiti alla lunghezza delle risposte, al formato, al tono o a elementi specifici da includere o escludere. In questo modo, l'agente rimane concentrato e produce risultati più prevedibili.

  Non consigliato: Create a sales email agent.

  Consigliato: Create an agent that drafts follow-up emails for sales leads. The drafts should always use a professional tone, be no more than three paragraphs, and never include personal information about the client.

• Chiedere a Gemini di farti domande

  Chiedi a Gemini di farti domande, se necessario. In questo modo Gemini può raccogliere i dettagli che potrebbe aver perso e assicurarsi che il piano dell'agente risultante soddisfi le tue aspettative.

  Non consigliato: Create an agent to handle sales emails.

  Consigliato: I need an agent that can help me draft sales emails. First, ask me what information you need to effectively qualify a lead and draft a personalized message.

Esempi di prompt efficaci

• Esempio semplice: Create a sales email agent that drafts concise follow-up emails to new leads. The tone should be professional, and the email should be no more than three paragraphs.

• Esempio avanzato: Create an agent that automatically drafts sales emails to leads. Use my Gmail and access emails with the 'leads' label. First, ask me to confirm which leads you should prioritize and what the main selling points are for each. Once you have this information, your drafts should be no more than three paragraphs and use a professional tone. Don't include any technical jargon or slang and never include any personal information about the client.

Crea un agente utilizzando il generatore di flussi

Utilizza questo metodo per un controllo granulare della progettazione degli agenti, della selezione dei modelli e dell'orchestrazione in più passaggi.

Console

Per creare un agente utilizzando lo strumento per la creazione di flussi:

1. Apri l'app web Gemini Enterprise in un browser.

2. Nel menu di navigazione dell'app web, fai clic su + Crea agente.

   Viene visualizzata la pagina Finestra di progettazione agente.

3. Fai clic su Procedi allo strumento di creazione per aprire direttamente lo strumento di creazione del flusso visivo.

4. Nella scheda Flusso, aggiungi e configura il nodo dell'agente principale:

   1. Nome:inserisci un nome per l'agente principale.
   2. Modello:seleziona il modello LLM Gemini da utilizzare per l'agente principale.
   3. Descrizione: inserisci un riepilogo dello scopo principale dell'agente.
   4. Istruzioni:fornisci un insieme dettagliato di istruzioni che definiscono gli obiettivi, le attività e i comportamenti dell'agente.
   5. Dati e strumenti: fai clic su Aggiungi origini dati e strumenti per aggiungere le origini dati connesse alla tua app.

5. Crea il flusso del subagente:

   1. Nella scheda Flusso, tieni il puntatore sul nodo dell'agente principale e poi fai clic su Aggiungi agente secondario.
   2. Configura i dettagli del subagente.

6. Ripeti il passaggio 5 se necessario per completare la logica del flusso del subagente.

7. Fai clic sulla scheda Dettagli e rivedi il nome e la descrizione dell'agente.

   • (Facoltativo) Nella sezione Conoscenza, fai clic su Aggiungi file per caricare eventuali materiali di riferimento aggiuntivi per l'agente.
   • (Facoltativo) Nella sezione Personalizzazione, aggiungi prompt iniziali che guidano gli utenti su come interagire con l'agente. Puoi aggiungere tutti i prompt iniziali che vuoi, ma il sistema mostra una selezione casuale di un massimo di tre prompt alla volta.

8. Fai clic sulla scheda Anteprima per interagire con l'agente per testare e valutare se la logica del flusso dell'agente funziona come previsto.

9. Fai clic su Crea per avviare e iniziare a utilizzare l'agente.

   Nota: se esci dal canvas di Agent Designer senza fare clic su Crea, l'agente viene impostato sullo stato Bozza.

Passaggi successivi

• Scopri come utilizzare un agente.
• Scopri come modificare un agente.
• Scopri come eliminare un agente.