Un agente 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. Dialogflow CX converte 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 Dialogflow CX per gestire i tipi di conversazioni richiesti per il tuo sistema.
Un agente CX di Dialogflow CX è simile a un agente di call center umano. Addestri entrambi i modelli per gestire gli scenari di conversazione previsti e l'addestramento non deve essere eccessivamente esplicito.
Crea un agente
Per creare un agente:
Console
- Apri la console Dialogflow CX.
- Crea o scegli un progetto.
- Fai clic su Crea agente.
- Seleziona Genera automaticamente per creare un agente datastore o seleziona Crea il tuo per creare altri tipi di agenti.
- Compila il modulo per le impostazioni di base dell'agente:
- Puoi scegliere qualsiasi nome visualizzato.
- Seleziona la tua località preferita. Se vuoi modificare le impostazioni di localizzazione avanzate, fai clic sul pulsante Modifica.
- Seleziona il fuso orario che preferisci.
- Seleziona la lingua predefinita per l'agente. Non puoi modificare la lingua predefinita di un agente dopo averlo creato.
- 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 localizzazione con l'API.
Per creare un agente, consulta il metodo create per il tipo Agent.
Seleziona un protocollo e una versione per il riferimento dell'agente:
| Protocollo | V3 | V3beta1 |
|---|---|---|
| REST | Risorsa agente | Risorsa agente |
| RPC | Interfaccia agente | Interfaccia 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 |
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:
Per saperne di più su come vengono applicati i dati a vari livelli, consulta i livelli di applicazione dei dati.
Endpointing 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 in formato lungo (ad esempio, phone_call).
È supportata solo la lingua en-US.
Se l'endpointing smart è abilitato per l'agente, puoi personalizzare il comportamento dell'endpointing smart per un parametro numerico impostando Timeout di attesa per specificare il tempo aggiuntivo. Dialogflow CX attenderà quindi che l'utente fornisca ulteriori input.
Il timeout di attesa è un periodo di tolleranza che ti consente di aggiungere qualcosa alla trascrizione STT prima che venga attivato il timeout della voce. 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, può aumentare il timeout per consentirti 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 lo stream 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 fa una pausa 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 è ancora in ascolto.
Esporta e ripristina 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 le versioni del flusso utilizzate nell'ambiente selezionato vengono esportate in un file.
- Ambienti: gli ambienti diversi da quello selezionato 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 finché esistono gli ambienti associati. Tuttavia, queste versioni del flusso obsolete 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
enginein 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 l'agente esistente in un agente del datastore aggiungendo un gestore dello stato del datastore. In questo caso, ti verrà mostrata la procedura per aggiungere un'app associata all'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 località verranno aggiornati in modo da corrispondere all'app dell'agente di destinazione. L'ID raccolta e l'ID datastore rimarranno invariati. Ciò significa che devi aggiungere datastore per tutti gli ID con tipi corrispondenti all'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/myDataStore1e l'app dell'agente di destinazione è denominataprojects/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
Durante l'esportazione, puoi selezionare il formato 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 file.
Per esportare o ripristinare un agente:
Console
- Apri la console Dialogflow CX.
- Scegli il progetto per l'agente.
- Seleziona l'opzione di menu more_vert per un agente nell'elenco.
- Fai clic sul pulsante Esporta o Ripristina.
- Segui le istruzioni per completare l'operazione.
API
Consulta i metodi export e restore per il tipo Agent.
Seleziona un protocollo e una versione per il riferimento dell'agente:
| Protocollo | V3 | V3beta1 |
|---|---|---|
| REST | Risorsa agente | Risorsa agente |
| RPC | Interfaccia agente | Interfaccia 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 |
Se le dimensioni dell'agente superano 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.
Elimina un agente
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
- Apri la console Dialogflow CX.
- Scegli il progetto per l'agente.
- Seleziona l'opzione di menu more_vert per un agente nell'elenco.
- Fai clic sul pulsante delete.
- Conferma l'eliminazione nella finestra di dialogo.
API
Consulta il metodo delete per il tipo Agent.
Seleziona un protocollo e una versione per il riferimento dell'agente:
| Protocollo | V3 | V3beta1 |
|---|---|---|
| REST | Risorsa agente | Risorsa agente |
| RPC | Interfaccia agente | Interfaccia 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 |
Se elimini il progetto, tutti gli agenti Dialogflow CX e i dati associati al progetto vengono eliminati immediatamente.