Agenti

Il termine agente può avere significati diversi. In un sistema multi-agente, che forma un albero di agenti gerarchico, l'intero albero di agenti viene definito applicazione agente.

Un'applicazione agente è composta da uno o più agenti, dove ogni agente può essere l'agente root o un sub-agente.

Un agente principale (noto anche come agente di indirizzamento) funge da punto di accesso e orchestratore principale per l'intera applicazione dell'agente. In genere gestisce l'interazione principale con l'utente finale, è responsabile della comprensione degli obiettivi generali e delega attività specifiche ai sub-agenti appropriati.

Un sub-agente (noto anche come agente secondario) è un agente più specializzato progettato per gestire un'attività, un dominio o una funzionalità specifici. Ad esempio, a un sub-agente potrebbe essere assegnato il compito di eseguire ricerche in un database specifico o di analizzare un particolare tipo di dati. I sub-agenti promuovono la modularità e la riusabilità nell'applicazione dell'agente.

Gli agenti principali possono richiamare i sub-agenti e i sub-agenti possono richiamare altri sub-agenti.

Crea un'applicazione agente e un agente root

Per creare un'applicazione agente e un agente principale:

1. Apri la console CX Agent Studio.
2. Seleziona il progetto.
3. Fai clic su Crea o Crea agente.
4. Specifica un nome per l'applicazione dell'agente.
5. Fai clic su Crea. Se questa è la prima applicazione dell'agente che hai creato per il progetto, la creazione potrebbe richiedere 1-2 minuti. Viene visualizzato Agent Builder e viene creato un agente principale.
6. Fai clic sul segno Più nell'angolo in alto a destra dell'agente principale.
7. Fai clic su Aggiungi istruzioni per aggiungere istruzioni per l'agente root.
8. Fai clic su Aggiungi strumento per aggiungere strumenti per l'agente principale.

Crea un subagente

Per creare un sub-agente:

1. Fai clic sul segno Più nella parte inferiore dell'agente principale.
2. Fai clic su Aggiungi subagente.

Gestisci le applicazioni degli agenti

Per gestire le applicazioni degli agenti per il tuo progetto:

1. Apri la console CX Agent Studio.
2. Seleziona il progetto. Viene visualizzato l'elenco delle applicazioni degli agenti per il tuo progetto.

Per ogni applicazione dell'agente, sono disponibili le seguenti informazioni e azioni:

• Fai clic sul nome dell'applicazione dell'agente per aprirla in Agent Builder.
• La colonna Deployment in mostra il numero di canali in cui è stato eseguito il deployment dell'applicazione.
• La colonna Sessioni mostra il numero di sessioni nelle ultime 24 ore che utilizzano un canale di deployment.
• La colonna Escalation mostra il numero di escalation nelle ultime 24 ore che utilizzano un canale di deployment.
• Viene visualizzata l'ora dell'ultimo aggiornamento dell'applicazione dell'agente.
• Puoi fare clic sul menu contestuale di una determinata applicazione agente, quindi su Importa agente, Esporta agente o Elimina agente. Per saperne di più, consulta Esporta e importa.

Supporto dei linguaggi

Devi progettare gli agenti utilizzando l'inglese, ma gli agenti possono rilevare automaticamente la lingua dell'input utente finale e risponderanno automaticamente utilizzando la stessa lingua. Per l'elenco delle lingue supportate, consulta il riferimento alle lingue.

Supporto del modello

CX Agent Studio utilizza i foundation model di Gemini per supportare il ragionamento generativo, l'esecuzione di istruzioni e le funzionalità multimodali. Puoi selezionare un modello globale per l'intera applicazione dell'agente o eseguirne l'override per sub-agenti specifici.

I modelli in CX Agent Studio sono ottimizzati per le prestazioni della customer experience e potrebbero differire dalle offerte standard di Vertex AI.

Nota: tutti i modelli in CX Agent Studio sono considerati in disponibilità generale (GA), a meno che non siano esplicitamente contrassegnati come "Anteprima" nell'interfaccia utente. Questa fase di lancio è specifica per CX Agent Studio e opera indipendentemente dallo stato di un modello in altri prodotti Google Cloud.

Per CX Agent Studio, sono supportati i seguenti modelli:

Modello	Ottimizzazione	Fase di lancio
gemini-composite-v2	Ottimizzazione per la voce	GA
gemini-composite-v1	Ottimizzazione per la voce	GA
gemini-3.7-flash	Testo ottimizzato	GA
gemini-3.5-flash	Testo ottimizzato	GA
gemini-3-flash	Testo ottimizzato	Anteprima
gemini-2.5-flash	Testo ottimizzato	GA
gemini-3.1-flash-live	Ottimizzazione per la voce	GA

Modello Gemini Composite V2

Il modello Gemini Composite V2 è la versione successiva del modello Composite V1 per gli agenti vocali aziendali. Utilizza gli stessi modelli Listener e Thinking di Composite V1, con un modello Speaker aggiornato che offre i seguenti miglioramenti:

• Linguaggio più naturale:ritmo, tono ed espressione migliorati.
• Controllo preciso della generazione: i tag incorporati aggiungono pause, respiri, risate e cambi di tono esattamente dove li posizioni.
• Maggiore precisione alfanumerica: lettura più accurata di valori come numeri di tracciamento, numeri di telefono e indirizzi.

Per utilizzare Composite V2, seleziona gemini-composite-v2 come modello globale per la tua applicazione agente. Se stai spostando un agente da Composite V1, consulta Esegui la migrazione da Composite V1.

Modello Gemini Composite V1

Il modello Gemini Composite V1 è progettato per gli agenti vocali aziendali. Combina tre modelli di sottocomponenti per offrire una rigorosa aderenza alle istruzioni, un'esecuzione superiore degli strumenti e un'eccezionale stabilità della voce:

Questo modello composito è una combinazione di tre modelli di sottocomponenti sottostanti:

• Modello di ascolto: converte l'audio in entrata in trascrizioni con eliminazione del rumore in tempo reale.
• Modello di ragionamento: elabora gli input, applica le istruzioni ed esegue gli strumenti di backend.
• Modello di speaker: converte le risposte di testo in un parlato naturale a bassa latenza.

Nota: gli aggiornamenti automatici potrebbero attivare una modifica della versione secondaria del modello composito o dei componenti secondari.

Best practice per i modelli compositi

Segui queste best practice per ottenere un parlato naturale e affidabile dal modello Composite V2. Composite V2 utilizza la punteggiatura e il contesto per dare forma alla voce, quindi la maggior parte delle risposte suona naturale senza ulteriori indicazioni. Inizia con un approccio semplice e aggiungi indicazioni solo dove migliorano la conversazione.

Stile di conversazione

Lo stile di conversazione nelle impostazioni della voce modella la voce per ogni risposta. Segui queste linee guida:

• Inizia con uno stile di conversazione vuoto. Testa l'agente prima senza uno stile di conversazione, poi aggiungine uno solo se è utile.
• Scegli un testo breve. Descrivi l'oratore in circa una dozzina di parole, ad esempio età, timbro vocale, tono, accento e ritmo. Ad esempio: Friendly woman in her early 30s, warm mid-pitch voice, relaxed conversational pace.
• Descrivi chi sta parlando, non come si sente. Utilizza i tag incorporati per le emozioni che cambiano di momento in momento.
• Evita i prompt lunghi. I prompt lunghi e suddivisi in più sezioni, come un profilo audio con note sulla scena e sul regista, possono causare una deviazione della voce durante una chiamata e possono entrare in conflitto con i tag incorporati.

Tag in linea

I tag in linea in una risposta dell'agente controllano l'invio in un punto specifico. Per utilizzarli, indica all'agente nelle sue istruzioni quando aggiungere i tag alle sue risposte.

La tabella seguente elenca i tag più comuni:

Tipo di tag	Esempi	Effetto
Metti in pausa	<short pause>, <long pause>	Aggiunge un silenzio breve o lungo.
Suono	<breath>, <sigh>, <chuckles>, <exhales>	Aggiunge un suono non verbale una volta, dove lo posizioni.
Tono	<warm>, <calm>, <empathetic>, <positive>, <clear>	Imposta il tono fino al tag di tono successivo.

Nella seguente risposta di esempio, l'agente passa da un tono empatico a un tono positivo:

<calm><empathetic> I'm so sorry your flight was canceled. <positive> The good news is that I've already rebooked you on the next flight out.

Segui queste linee guida quando utilizzi i tag incorporati:

• Utilizza le parentesi angolari. Scrivi i tag come <sigh>, non [sigh].
• Inserisci i tag all'inizio di una frase. Puoi impilare i tag, ad esempio <calm><empathetic>. Solo i tag di pausa possono essere inseriti all'interno di una frase, dopo la punteggiatura. Ad esempio: I checked your account, <short pause> everything is in order..
• Utilizza uno o due tag per turno. La maggior parte delle conversazioni con i clienti non richiede altro.
• Non utilizzare tag di chiusura, come </warm>. Un tag di tono rimane attivo fino al successivo.
• Mantieni i tag in inglese, anche quando l'agente risponde in un'altra lingua.
• Utilizza le lettere maiuscole e la punteggiatura per dare enfasi. Usa le lettere maiuscole per enfatizzare una parola e i puntini di sospensione per un'esitazione naturale.

Per l'elenco completo dei tag, consulta la guida ai prompt di Gemini TTS.

Numeri e identificatori

Per assicurarti che l'agente pronunci correttamente numeri, valute, date, numeri di telefono e ID alfanumerici, aggiungi regole di normalizzazione del testo alle tue istruzioni globali. Ad esempio, indica all'agente di pronunciare $87.25 come "ottantasette dollari e venticinque centesimi" e di leggere l'ID ordine XED1234 un carattere alla volta. Specifica che queste regole si applicano solo alle risposte vocali, quindi l'agente passa comunque i valori originali, ad esempio XED1234, agli strumenti.

Esegui la migrazione da Composite V1

Per spostare un agente esistente da Composite V1 a Composite V2:

1. Nelle impostazioni della voce, sostituisci qualsiasi prompt di stile di parlato lungo con una breve descrizione o lascialo vuoto.
2. Nelle istruzioni e negli strumenti, modifica i tag tra parentesi quadre in parentesi angolari. Ad esempio, modifica [sigh] in <sigh>.
3. Imposta il modello su gemini-composite-v2 per l'applicazione dell'agente e per tutti i sub-agenti che eseguono l'override del modello globale.
4. Testa l'agente con le tue solite valutazioni e i test di accettazione utente prima di eseguirne il deployment.

Impostazioni dell'applicazione dell'agente

Consulta le impostazioni.

Impostazioni dell'agente

Consulta le impostazioni.