Crea un agente

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 dell'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 consente di avere un controllo diretto e granulare sulla progettazione dell'agente fin dall' inizio. È ideale per progettare agenti multi-fase complessi che richiedono configurazioni e flussi logici di subagenti specifici.

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 gli agenti funzionino in modo efficace ed efficiente, tieni presente le seguenti best practice:

  • Definisci obiettivi chiari: indica chiaramente cosa vuoi che l'agente raggiunga. Un obiettivo ben definito aiuta a progettare la logica dell'agente e a valutarne il rendimento.
  • Inizia con un agente semplice, poi espandilo: 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 multi-fase, dividi le attività di grandi dimensioni in sottoattività più piccole e gestibili. Ogni subagente deve avere un ruolo specifico.
  • Esegui test iterativi: testa regolarmente l'agente in ogni fase di sviluppo. In questo modo, puoi 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 la scrittura di prompt per creare un agente.

Prima di iniziare

Creare 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 Google Cloud console, 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 Agent Designer.

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

  6. (Facoltativo) Fai clic su Icona Agenti Gestisci i tuoi dati e attiva o disattiva le origini dati che vuoi che l' agente utilizzi.

  7. (Facoltativo) Fai clic su Aggiungi file per caricare eventuali materiali di riferimento aggiuntivi da utilizzare per l'agente.

  8. Fai clic su Invia.

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

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

  10. (Facoltativo) Perfeziona la funzione e il comportamento dell'agente fornendo istruzioni aggiuntive nel riquadro di chat a sinistra.

  11. Per visualizzare i dettagli generali dell'agente, vai alla scheda Flusso e fai clic sul nodo dell'agente principale.

    • (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 guidino gli utenti su come interagire con l'agente. Puoi aggiungere tutti i prompt iniziali che vuoi, ma il sistema ne mostra una selezione casuale di massimo tre alla volta.

  12. (Facoltativo) Fai clic sulla scheda Pianificazione per configurare le pianificazioni di esecuzione per l'agente. Per ulteriori informazioni sulle pianificazioni degli agenti, vedi Pianificare le esecuzioni degli agenti.

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

Best practice per la scrittura di prompt per creare un agente

Il prompt che fornisci aiuta Gemini a comprendere i tuoi obiettivi e a generare il miglior agente 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 l'agente faccia. 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 limiti o restrizioni sull'output dell'agente

    Definisci cosa deve e non deve fare l'agente. Puoi impostare limiti sulla lunghezza delle risposte, sul formato, sul tono o su 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.

  • Chiedi a Gemini di farti delle domande

    Chiedi a Gemini di farti delle domande, se necessario. In questo modo, Gemini può raccogliere 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.

Creare un agente utilizzando il generatore di flussi

Utilizza questo metodo per un controllo granulare sulla progettazione dell'agente, sulla selezione del modello e sull'orchestrazione multi-fase.

Console

Per creare un agente utilizzando il generatore 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 Agent Designer.

  3. Fai clic su Procedi al generatore per aprire direttamente la scheda Agent Designer > Flusso.

    Nel canvas di Agent Designer viene creato un agente predefinito denominato Il mio agente.

  4. Per visualizzare e configurare i dettagli generali dell'agente, fai clic sul nodo Il mio agente e procedi nel seguente modo:

    1. Nome: inserisci un nome per l'agente.
    2. Descrizione: inserisci un riepilogo dello scopo dell'agente.
    3. Istruzioni: fornisci una serie dettagliata di istruzioni che definiscono gli obiettivi, le attività e i comportamenti dell'agente.
    4. Modello: seleziona il modello LLM Gemini da utilizzare per l'agente.
    5. Dati e strumenti: fai clic su Aggiungi origini dati e strumenti per aggiungere le origini dati connesse all'app.
    6. (Facoltativo) Nella sezione Conoscenza, fai clic su Aggiungi file per caricare eventuali materiali di riferimento aggiuntivi per l'agente.
    7. (Facoltativo) Nella sezione Personalizzazione, aggiungi prompt iniziali che guidino gli utenti su come interagire con l'agente. Puoi aggiungere tutti i prompt iniziali che vuoi, ma il sistema ne mostra una selezione casuale di massimo tre alla volta.

  5. Crea il flusso del subagente:

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

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

  7. (Facoltativo) Fai clic sulla scheda Pianificazione per configurare le pianificazioni di esecuzione per l'agente.

  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.

Passaggi successivi