Panoramica dei componenti predefiniti

I componenti predefiniti sono una raccolta di flussi predefiniti forniti da Dialogflow per attività e scenari comuni. Possono essere utilizzati per accelerare lo sviluppo di agenti nuovi ed esistenti.

Esistono due tipi di componenti predefiniti:

  • Componenti di base: componenti che raccolgono parametri specifici, come nome e indirizzo
  • Casi d'uso: componenti che rappresentano percorsi degli utenti più lunghi, ad esempio un pagamento, in cui possono essere utilizzati uno o più componenti di base

I flussi dei componenti predefiniti includono intent ed entità pronti per l'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 base:

Sono disponibili i componenti del caso d'uso riportati di seguito:

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 Dialogflow CX.
  2. Scegli il tuo progetto Google Cloud.
  3. Seleziona l'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. Fai riferimento alla documentazione specifica del componente per determinare se è necessaria una configurazione aggiuntiva per il webhook.
  8. Inizia a testare e personalizzare.

Controlli di servizio VPC

Se il progetto si trova all'interno di un perimetro di Controlli di servizio VPC (VPC-SC), potrebbe essere necessario aggiungere una regola in uscita per abilitare l'importazione delle versioni più recenti dei componenti predefiniti dal bucket Google Cloud Storage esterno in cui sono archiviati. Se le regole VPC-SC impediscono il traffico in uscita verso il bucket ospitato da Google, potresti visualizzare un messaggio di errore al momento dell'importazione che contiene il messaggio "Autorizzazione negata 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, devi creare una regola in uscita che consenta l'accesso al progetto Google Cloud esterno contenente il bucket Google Cloud Storage gs://gassets-api-ai. Gli attributi seguenti 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 le entità personalizzate in base alle tue esigenze aziendali.
  2. Per gli agenti vocali, sono consigliate le seguenti impostazioni vocali:
  3. Se utilizzi un'integrazione di telefonia che consente i valori dei parametri estratti dalla pressione del tastierino del telefono, abilita il DTMF per le integrazioni di telefonia.
  4. Testa l'agente utilizzando il simulatore.
  5. Per testare il componente tramite comandi vocali, consigliamo di utilizzare Dialogflow CX Phone Gateway.

Gestire gli eventi di uscita

Una volta completata l'attività, un componente predefinito verrà chiuso con la destinazione di transizione simbolica END_FLOW.

Quando un componente predefinito non è in grado di completare l'attività, verranno emessi i seguenti eventi per la pagina di chiamata che ha causato la transizione al flusso dei componenti predefiniti. Una best practice consiste nel gestire questi eventi nell'agente creando i gestori di eventi corrispondenti nella pagina di chiamata.

Scopri gli eventi integrati:

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

Funzionalità aggiuntive

Alcuni componenti predefiniti hanno funzionalità aggiuntive. Consulta la documentazione specifica per conoscere le funzionalità implementate per un determinato componente.

Ripetizione della funzionalità

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

Esempi di frasi:

  • Cosa hai appena detto?
  • Dillo di nuovo.
  • Puoi ripetere?
  • Pardon.

Funzionalità della sala d'attesa

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

Esempi di frasi:

  • Attendi.
  • Attendi un attimo.
  • Aspetta, fammi controllare.
  • Sto controllando, aspetta.
  • Ora sono pronto.

Funzionalità di riproduzione

Se l'utente finale vuole sapere cosa ha raccolto finora l'agente, può chiedergli di riprodurre i contenuti. L'agente riprodurrà quindi i parametri attualmente acquisiti.

Esempi di frasi:

  • Riproduzione.
  • Riproduci i contenuti.
  • Per favore, fammi sentire?
  • Leggilo.

Intent comuni

Gli intent comuni sono intent utilizzati per comportamenti comuni in più componenti.

Intento comune Descrizione
prebuilt_components_confirmation_yes Espressioni positive utilizzate per esprimere affermazioni, assensi o per contrassegnare l'aggiunta di qualcosa che enfatizza e amplifica un'affermazione in risposta a una domanda o richiesta
prebuilt_components_confirmation_no Frasi negative utilizzate per esprimere dissenso, rifiuto o rifiuto in risposta a una domanda o 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 che l'agente virtuale colleghi l'utente finale a un agente umano
prebuilt_components_start_over Frasi utilizzate per chiedere che l'intera esperienza ricomincia dall'inizio
prebuilt_components_playback Frasi specifiche per richiedere che l'input attualmente raccolto venga riprodotto all'utente finale, in modo che quest'ultimo 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 rivedere, trovare o fornire informazioni in risposta a una domanda o a una richiesta
prebuilt_components_ready Frasi utilizzate per notificare all'agente virtuale che l'utente finale vuole continuare un'azione