Panoramica dei componenti predefiniti

I componenti predefiniti sono una raccolta di flussi predefiniti forniti da agenti conversazionali (Dialogflow CX) per svolgere attività e scenari comuni. Possono essere utilizzati per accelerare lo sviluppo sia per gli agenti nuovi sia per quelli esistenti.

Esistono due tipi di componenti predefiniti:

  • Componenti di base: Componenti che raccolgono parametri specifici, come nome e indirizzo
  • Caso d'uso: componenti che rappresentano percorsi dell'utente più ampi, come l'effettuazione di un pagamento, che possono utilizzare uno o più elementi di base

I flussi di componenti predefiniti includono intent e entità pronti all'uso. Per i componenti che richiedono integrazioni con servizi esterni, devi modificare la configurazione dei webhook flessibili per l'integrazione con gli endpoint appropriati.

Sono disponibili i seguenti componenti di blocchi di base:

Sono disponibili i seguenti componenti dei casi d'uso:

Limitazioni

Si applicano le seguenti limitazioni:

  • Al momento i componenti predefiniti supportano solo l'inglese (en).

Importare un componente predefinito

Per importare un componente predefinito nel tuo progetto:

  1. Vai alla console di Dialogflow CX.
  2. Scegli il tuo progetto Google Cloud.
  3. Seleziona il tuo agente o creane uno nuovo.
  4. Seleziona la scheda Gestisci.
  5. Fai clic su Predefinito nel riquadro Gestisci.
  6. Fai clic sul componente che ti interessa e poi su Importa come flusso.
  7. Consulta la documentazione specifica di ciascun componente per determinare se per il webhook.
  8. Inizia i test e la personalizzazione.

Controlli di servizio VPC

Se il tuo progetto si trova all'interno di un perimetro VPC Service Controls (VPC-SC), potresti dover aggiungere una regola di uscita per consentire l'importazione delle versioni più recenti dei componenti predefiniti dal bucket Google Cloud Storage esterno ospitato da Google in cui sono archiviati. Se le regole VPC-SC impediscono il traffico in uscita verso bucket, potresti visualizzare un messaggio di errore al momento dell'importazione che contiene il messaggio durante l'accesso all'URI di Google Cloud Storage "gs://gassets-api-ai/prebuilt_components/cx-standard-prebuilt-components/resource-name".

Per abilitare l'importazione, dovrai creare una regola in uscita che permette di accedere al progetto Google Cloud esterno contenente Bucket Cloud Storage gs://gassets-api-ai. I seguenti attributi descrivono la risorsa e le operazioni necessarie per abilitare l'importazione dalla risorsa di proprietà di Google:

  • Risorsa: projects/921279757870
  • Nome servizio: storage.googleapis.com
  • Metodo: google.storage.objects.get

Personalizzazioni e impostazioni

Per personalizzare il componente e migliorare le impostazioni:

  1. Modifica le risposte dell'agente e entità personalizzate per soddisfare le tue esigenze aziendali.
  2. Per gli agenti vocali, sono consigliate le seguenti impostazioni di parlato:
  3. Se utilizzi un'integrazione di telefonia che consente valori dei parametri estratti dalle pressioni del tastierino del telefono, abilita DTMF per le integrazioni di telefonia.
  4. Testa l'agente usando il simulatore.
  5. Per testare il componente tramite comandi vocali, si consiglia di utilizzare Gateway per telefoni Dialogflow CX.

Gestire gli eventi di uscita

Una volta completata l'attività, un componente predefinito viene chiuso con END_FLOW target per la transizione simbolica.

Se un componente predefinito non è in grado di completare l'attività, per la pagina chiamante verranno emessi i seguenti eventi che ha causato la transizione al flusso dei componenti predefiniti. È buona prassi gestire questi eventi nell'agente creando i gestori di eventi corrispondenti nella pagina di chiamata.

Consulta gli eventi integrati:

  • flow-cancelled
  • flusso non riuscito
  • flow-failed-human-escalation

Funzionalità aggiuntive

Alcuni componenti predefiniti hanno funzionalità aggiuntive. Consulta la documentazione specifica del componente per verificare quali funzionalità sono implementate per un determinato componente.

Funzionalità di ripetizione

Se l'utente finale ha difficoltà a interpretare l'agente virtuale o non sentiva la risposta dell'agente può chiedere di ripetere l'ultima richiesta.

Frasi di esempio:

  • Cos'hai appena detto?
  • Ripeti.
  • Puoi ripetere?
  • Pardon.

Funzionalità della sala d'attesa

Se l'utente finale vuole prendersi un minuto per richiamare l'agente e non ha una risposta immediata a un prompt, puoi chiedere all'agente virtuale di attendere. Quando l'utente finale è pronto a continuare la conversazione, può dire all'agente "Sono pronto" per riprendere la conversazione. La sala d'attesa viene attivata in alcuni componenti predefiniti richiamando il metodo componente predefinito per la sala d'attesa. La funzionalità della sala d'attesa può essere attivata anche in qualsiasi punto dell'agente seguendo le istruzioni di configurazione descritte nella panoramica del componente predefinito della sala d'attesa.

Frasi di esempio:

  • Attendi.
  • Attendi un attimo.
  • Resta in attesa, fammi controllare.
  • Sto controllando, aspetta.
  • Ora posso.

Funzionalità di riproduzione

Se l'utente finale vuole sapere cosa ha raccolto l'agente finora, può chiedere l'agente alla riproduzione. L'agente riprodurrà i parametri attualmente acquisiti.

Frasi di esempio:

  • Riproduzione.
  • Riproducilo.
  • Riproduci di nuovo.
  • Leggimelo.

Intenzioni comuni

Le intenzioni comuni sono quelle utilizzate per comportamenti comuni in più componenti.

Intento comune Descrizione
prebuilt_components_confirmation_yes Frasi positive usate per esprimere affermazione, assenso o per indicare l'aggiunta di qualcosa che enfatizza e amplifica un'affermazione in risposta a una domanda o una richiesta
prebuilt_components_confirmation_no Frasi negative usate per esprimere dissenso, negazione o rifiuto in risposta a una domanda o una richiesta
prebuilt_components_confirmation_done Frasi utilizzate per indicare che l'utente finale ha completato un'attività o una richiesta
prebuilt_components_escalate_human_agent Frasi utilizzate per richiedere all'agente virtuale di mettere in contatto l'utente finale con un agente umano
prebuilt_components_start_over Frasi utilizzate per richiedere che l'intera esperienza ricominci dall'inizio
prebuilt_components_playback Frasi specifiche per richiedere la riproduzione all'utente finale dell'input attualmente raccolto in modo che possa dare conferma
prebuilt_components_replay Frasi utilizzate per richiedere che il prompt precedente venga ripetuto
prebuilt_components_waiting_room Frasi utilizzate per esprimere la necessità di tempo per esaminare, trovare o fornire informazioni in risposta a una domanda o una richiesta
prebuilt_components_ready Frasi utilizzate per comunicare all'agente virtuale che l'utente finale vuole continuare un'azione