Agenti

Un agente Dialogflow CX è un agente virtuale che gestisce conversazioni simultanee con gli utenti finali. È un modulo di comprensione del linguaggio naturale che comprende le sfumature del linguaggio umano. Dialogflow CX traduce il testo o l'audio dell'utente finale durante una conversazione in dati strutturati comprensibili dalle tue app e dai tuoi servizi. Progetti e crei un agente Dialogflow CX per gestire i tipi di conversazioni richiesti per il tuo sistema.

Un agente Dialogflow CX è simile a un agente umano di un contact center. Li addestri entrambi a gestire gli scenari di conversazione previsti e l'addestramento non deve essere eccessivamente esplicito.

Crea un agente

Nota: puoi creare più agenti Dialogflow CX per un progetto Google Cloud.

Per creare un agente:

Console

1. Apri la console Dialogflow CX.
2. Crea o scegli un progetto.
3. Fai clic su Crea agente.
4. Seleziona Genera automaticamente per creare un agente datastore o seleziona Crea il tuo per creare altri tipi di agenti.
5. Compila il modulo per le impostazioni di base dell'agente:
   1. Puoi scegliere qualsiasi nome visualizzato.
   2. Seleziona la tua posizione preferita. Se vuoi modificare le impostazioni di geolocalizzazione avanzate, fai clic sul pulsante Modifica.
   3. Seleziona il fuso orario che preferisci.
   4. Seleziona la lingua predefinita per l'agente. Non puoi modificare la lingua predefinita di un agente dopo averlo creato.
6. Fai clic su Salva.

API

Se non hai ancora configurato le impostazioni di localizzazione per il tuo progetto, devi configurarle con la console prima di creare agenti con l'API. Non puoi configurare le impostazioni di geolocalizzazione con l'API.

Per creare un agente, consulta il metodo create per il tipo Agent. Vai al riferimento dell'API Agent

Seleziona un protocollo e una versione per il riferimento all'agente:

Protocollo	V3	V3beta1
REST	Risorsa per gli agenti	Risorsa per gli agenti
RPC	Interfaccia dell'agente	Interfaccia dell'agente
C++	AgentsClient	Non disponibile
C#	AgentsClient	Non disponibile
Go	AgentsClient	Non disponibile
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	Non disponibile	Non disponibile
Python	AgentsClient	AgentsClient
Ruby	Non disponibile	Non disponibile

Close

Dati dell'agente

Gli agenti Dialogflow CX fungono da contenitori di primo livello per le impostazioni e i dati degli agenti virtuali. I seguenti dati sono associati agli agenti:

• Intenti
• Tipi di entità
• Webhook
• Flussi
• Pagine
• Gruppi di itinerari

Per ulteriori informazioni su come vengono applicati i dati a vari livelli, consulta i livelli di applicazione dei dati.

Endpoint intelligente

Speech-to-Text (STT) è un'API che converte l'audio in testo utilizzando il machine learning, consentendoti di integrare il riconoscimento vocale nelle tue applicazioni. I modelli STT supportati includono qualsiasi modello di formato lungo (ad esempio phone_call). È supportata solo la lingua en-US.

Nota: se utilizzi un modello breve, questa opzione attiva la fine della trasmissione dell'endpoint Cloud Speech.

Se l'endpoint intelligente è abilitato per l'agente, puoi personalizzare il comportamento dell'endpoint intelligente per un parametro numerico impostando Timeout di attesa per specificare il tempo aggiuntivo. Dialogflow CX attenderà quindi che l'utente fornisca un input aggiuntivo.

Il timeout di attesa è un periodo di tolleranza che ti consente di aggiungere qualcosa alla trascrizione STT prima che venga attivato il timeout del parlato. Dialogflow CX utilizza l'euristica per specificare il timeout da scegliere in base alla trascrizione. Ad esempio, può scegliere un timeout molto breve se l'intent è stato abbinato correttamente. Se l'intent non è stato trovato, il timeout può essere aumentato per darti la possibilità di dire qualcos'altro e riprovare a trovare l'intent.

Altre funzionalità di STT includono:

• Endpointing più rapido:l'analisi in tempo reale utilizza lo streaming della trascrizione audio per distinguere tra una pausa naturale e il completamento di un'espressione mentre il flusso STT rimane aperto. Se l'utente ha finito di parlare, Dialogflow CX termina lo stream in anticipo per fornire una risposta più rapida.
• Feedback conversazionale naturale:se l'utente si interrompe a metà frase, Dialogflow CX può estendere dinamicamente il timeout STT per evitare interruzioni premature o inserire segnali di backchanneling naturali (ad es. "mm hmm", "uh huh") per confermare che l'agente virtuale sta ancora ascoltando.

Esportare e ripristinare un agente

Avviso :a partire dal 15 agosto 2025, non verranno più esportate le credenziali del valore non elaborato per gli strumenti OpenAPI e i webhook. Devi eseguire la migrazione per archiviare le credenziali in Secret Manager. Per istruzioni, consulta la documentazione relativa a Webhook e Strumento.

Puoi esportare un agente in un file e ripristinarlo con quel file.

Un'esportazione dell'agente include tutti i dati dell'agente, ad eccezione di quanto segue:

• Versioni del flusso: Vengono esportati in un file solo i flussi bozza.
• Ambienti: Gli ambienti personalizzati non vengono esportati in un file.

Il ripristino di un agente sovrascrive tutti i dati dell'agente di destinazione (incluse tutte le versioni del flusso), ad eccezione di quanto segue:

• Ambienti: Tutti gli ambienti personalizzati rimangono invariati nell'agente di destinazione. Le versioni dei flussi a cui fanno riferimento gli ambienti personalizzati nell'agente di destinazione continueranno a esistere finché esisteranno gli ambienti associati. Tuttavia, queste versioni obsolete del flusso non sono elencate o selezionabili per l'agente.
• App Vertex AI Agents: L'associazione a un'app Vertex AI Agents rimane invariata nell'agente di destinazione (ovvero il valore di engine in GenAppBuilderSettings). Ciò significa che gli agenti del datastore possono essere ripristinati solo in altri agenti del datastore esistenti perché l'agente risultante deve avere anche un'associazione a un'app Vertex AI Agents.

• Datastore di Vertex AI Agents: Tutti i riferimenti ai datastore verranno sovrascritti nell'agente di destinazione, in base alle seguenti regole:

  • Se l'agente di destinazione non è associato a un'app, non è possibile ripristinare un agente con riferimenti al datastore. Se provi a farlo, viene visualizzato un messaggio di errore. Per risolvere il problema, puoi creare un nuovo agente datastore da zero. In alternativa, puoi trasformare il tuo agente esistente in un agente datastore aggiungendo un gestore di stato. In questo caso, ti verrà chiesto di aggiungere un'app associata al tuo agente.)
  • Se l'agente di destinazione è associato a un'app, tutti i riferimenti al datastore verranno aggiornati al momento del ripristino: l'ID progetto e la posizione verranno aggiornati in modo che corrispondano all'app dell'agente di destinazione. Google Cloud L'ID raccolta e l'ID datastore rimarranno invariati. Ciò significa che devi aggiungere datastore per tutti gli ID con tipi corrispondenti nell'app dell'agente di destinazione prima dell'operazione di ripristino.

  Esempio: se l'agente di origine fa riferimento a un datastore denominato projects/123/locations/eu-west2/collections/default_collection/dataStores/myDataStore1 e l'app dell'agente di destinazione è denominata projects/321/locations/us-east1/collections/default_collections/engines/app123, il riferimento al datastore risultante nell'agente di destinazione diventa: projects/321/locations/us-east1/collections/default_collection/dataStores/myDataStore1

Nota: nell'API e nei contenuti dei dati esportati, un'app Vertex AI Agents viene chiamata motore GenAppBuilder. Ad esempio, in un pacchetto JSON esportato, puoi trovare il nome del motore nel file agent.json, sotto la chiave genAppBuilderSettings.engine.

Durante l'esportazione, puoi selezionare il formato del file di esportazione. Se utilizzi il controllo della versione del codice sorgente per i dati dell'agente, devi esportare in formato JSON. Quando ripristini un agente, Dialogflow CX determina automaticamente il formato del file.

Per esportare o ripristinare un agente:

Console

1. Apri la console Dialogflow CX.
2. Scegli il progetto per l'agente.
3. Seleziona l'opzione di menu per un agente nell'elenco.
4. Fai clic sul pulsante Esporta o Ripristina.
5. Segui le istruzioni per completare l'operazione.

Nota: per ripristinare un agente datastore, assicurati che l'agente di destinazione sia stato creato come agente datastore.

API

Consulta i metodi export e restore per il tipo Agent. Vai al riferimento dell'API Agent

Seleziona un protocollo e una versione per il riferimento all'agente:

Protocollo	V3	V3beta1
REST	Risorsa per gli agenti	Risorsa per gli agenti
RPC	Interfaccia dell'agente	Interfaccia dell'agente
C++	AgentsClient	Non disponibile
C#	AgentsClient	Non disponibile
Go	AgentsClient	Non disponibile
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	Non disponibile	Non disponibile
Python	AgentsClient	AgentsClient
Ruby	Non disponibile	Non disponibile

Close

Se la dimensione dell'agente supera il limite massimo, utilizza l'opzione Cloud Storage per l'esportazione e il ripristino dell'agente.

Se utilizzi GitHub, consulta anche la guida all'esportazione/al ripristino di GitHub.

Eliminare un agente

Attenzione: l'eliminazione di un agente non può essere annullata. Esporta l'agente per conservare un backup, se necessario.

Per eliminare un agente, devi disporre di un ruolo che fornisca l'accesso completo o l'accesso in modifica. Per saperne di più, consulta la guida al controllo dell'accesso.

Per eliminare un agente:

Console

1. Apri la console Dialogflow CX.
2. Scegli il progetto per l'agente.
3. Seleziona l'opzione di menu per un agente nell'elenco.
4. Fai clic sul pulsante .
5. Conferma l'eliminazione nella finestra di dialogo.

API

Consulta il metodo delete per il tipo Agent. Vai al riferimento dell'API Agent

Seleziona un protocollo e una versione per il riferimento all'agente:

Protocollo	V3	V3beta1
REST	Risorsa per gli agenti	Risorsa per gli agenti
RPC	Interfaccia dell'agente	Interfaccia dell'agente
C++	AgentsClient	Non disponibile
C#	AgentsClient	Non disponibile
Go	AgentsClient	Non disponibile
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	Non disponibile	Non disponibile
Python	AgentsClient	AgentsClient
Ruby	Non disponibile	Non disponibile

Close

Se elimini il progetto, tutti gli agenti Dialogflow CX e i dati associati al progetto vengono eliminati immediatamente.