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 conversazioni richiesti per il tuo sistema.

Un agente Conversational Agents (Dialogflow CX) è simile a un agente di call center umano. Li addestrini entrambi a gestire gli scenari di conversazione previsti e la formazione non deve essere eccessivamente esplicita.

Crea un agente

Nota: puoi creare più agenti conversazionali (Dialogflow CX) per un singolo progetto Google Cloud.

Per creare un agente:

Console

1. Apri la console Dialogflow CX.
2. Crea o scegli un progetto Google Cloud.
3. Fai clic su Crea agente.
4. Seleziona Genera automaticamente per creare un agente del datastore o 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. Fai clic sul pulsante Modifica se vuoi modificare le impostazioni di geolocalizzazione avanzate.
   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 già configurato le impostazioni di geolocalizzazione per il tuo progetto, devi farlo con la console prima di creare gli agenti con l'API. Al momento, 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 all'API Agent

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

Protocollo	V3	V3beta1
REST	Risorsa agente	Risorsa agente
RPC	Interfaccia dell'agente	Interfaccia dell'agente
C++	AgentsClient	Non disponibile
C#	AgentsClient	Non disponibile
Vai	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 Conversational Agents (Dialogflow CX) fungono da contenitori di primo livello per le impostazioni e i dati degli agenti virtuali.

Per accedere ai dati di un agente:

Console

1. Apri la console Dialogflow CX.
2. Scegli il progetto Google Cloud per l'agente.
3. Trova l'agente nell'elenco.
4. Fai clic sul nome visualizzato dell'agente.
5. Aggiorna flussi, pagine e così via come descritto in altre guide.

API

Consulta le guide per i dati che vuoi aggiornare.

I seguenti dati sono associati agli agenti:

• Intent
• Tipi di entità
• Webhook
• Flussi
• Pagine
• Gruppi di route

Per ulteriori informazioni su come vengono applicati i dati a livelli diversi, 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 dei flussi: solo i flussi di bozza vengono esportati in file.
• Ambienti: gli ambienti personalizzati non vengono esportati in un file.

Un ripristino dell'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, a condizione che esistano gli ambienti associati. Tuttavia, queste versioni non aggiornate dei flussi 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. In altre parole, il valore di engine in GenAppBuilderSettings) Ciò significa che gli agenti datastore possono essere ripristinati solo in altri agenti datastore esistenti, perché anche l'agente risultante deve avere un'associazione a un'app Vertex AI Agents.

• Datastore di agenti Vertex AI: tutti i riferimenti ai datastore verranno sovrascritti nell'agente di destinazione secondo le seguenti regole:

  • Se l'agente di destinazione non è associato a un'app, non è possibile ripristinare un agente con riferimenti allo datastore. Il tentativo di farlo comporta un messaggio di errore. Per risolvere il problema, puoi creare un nuovo agente del datastore da zero. In alternativa, puoi trasformare l'agente esistente in un agente del datastore aggiungendo un gestore dello stato del datastore. In questo caso, ti verrà chiesto di aggiungere un'app associata al tuo agente.
  • Se l'agente target è associato a un'app, tutti i riferimenti dell'archivio dati verranno aggiornati al momento del ripristino: l'ID progetto Google Cloud e la posizione verranno aggiornati in base all'app dell'agente target. L'ID raccolta e l'ID datastore rimarranno invariati. Ciò significa che devi aggiungere gli archivi dati 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

Nota: nell'API e nei contenuti dei dati esportati, un'app Vertex AI Agents è chiamata GenAppBuilder Engine. 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 controllo dell'origine per i dati dell'agente, devi esportarli in formato JSON. Quando ripristini un agente, Conversational Agents (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 Google Cloud per l'agente.
3. Fai clic sul menu opzioni 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 del data store.

API

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

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

Protocollo	V3	V3beta1
REST	Risorsa agente	Risorsa agente
RPC	Interfaccia dell'agente	Interfaccia dell'agente
C++	AgentsClient	Non disponibile
C#	AgentsClient	Non disponibile
Vai	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 mantenere un backup, se necessario.

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

Per eliminare un agente:

Console

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

API

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

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

Protocollo	V3	V3beta1
REST	Risorsa agente	Risorsa agente
RPC	Interfaccia dell'agente	Interfaccia dell'agente
C++	AgentsClient	Non disponibile
C#	AgentsClient	Non disponibile
Vai	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 Conversational Agents (Dialogflow CX) e i dati associati al progetto vengono eliminati immediatamente.