Agenti

Un agente Conversational Agents (Dialogflow CX) è un agente virtuale che gestisce conversazioni simultanee con gli utenti finali. Si tratta di un modulo di comprensione del linguaggio naturale che comprende le sfumature del linguaggio umano. Conversational Agents (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. Progetta e crea un agente Conversational Agents (Dialogflow CX) per gestire i tipi di conversazione richiesti per il tuo sistema.

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

Crea un agente

Per creare un agente:

Dati dell'agente

Gli agenti Conversational Agents (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.

Esportare e ripristinare un agente

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: Solo i flussi bozza vengono esportati nel file.
• Ambienti: Gli ambienti personalizzati non vengono esportati nel file.

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

• 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, a condizione che esistano gli ambienti associati. Tuttavia, queste versioni obsolete del flusso non sono elencate né selezionabili per l'agente.
• App Vertex AI Agents: L'associazione a un'app Vertex AI Agents rimane invariata nell'agente di destinazione. (In altre parole, 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 datastore. In questo caso, ti verrà spiegato come 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 Google Cloud e la posizione verranno aggiornati in modo che corrispondano all'app dell'agente di destinazione. L'ID raccolta e l'ID datastore rimarranno invariati. Ciò significa che devi aggiungere i 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 diventerà: projects/321/locations/us-east1/collections/default_collection/dataStores/myDataStore1

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

Per esportare o ripristinare un agente:

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

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

Per eliminare un agente:

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