Panoramica dei componenti predefiniti

I componenti predefiniti sono una raccolta di flussi predefiniti forniti da Dialogflow CX 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 utente più ampi, come effettuare un pagamento, che possono utilizzare uno o più building block

I flussi di componenti predefiniti includono intent ed 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 corretti.

Sono disponibili i seguenti componenti di base:

Sono disponibili i seguenti componenti del caso 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 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 Predefiniti nel riquadro Gestisci.
  6. Fai clic sul componente che ti interessa e poi su Importa come flusso.
  7. Consulta la documentazione specifica di ogni componente per determinare se è necessaria una configurazione aggiuntiva per il webhook.
  8. Inizia a testare e personalizzare.

Controlli di servizio VPC

Se il tuo progetto si trova all'interno di un perimetro dei Controlli di servizio VPC (VPC-SC), potresti dover aggiungere una regola di uscita per consentire l'importazione delle versioni più recenti dei componenti predefiniti dal bucket Cloud Storage esterno ospitato da Google in cui sono archiviati. Se le regole VPC-SC impediscono l'uscita verso il bucket ospitato da Google, potresti visualizzare un messaggio di errore durante l'importazione che contiene "Permission denied while accessing Google Cloud Storage URI '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. 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 le entità personalizzate per soddisfare le esigenze della tua attività.
  2. Per gli agenti vocali, sono consigliate le seguenti impostazioni di sintesi vocale:
  3. Se utilizzi un'integrazione di telefonia che consente l'estrazione dei valori dei parametri dalla pressione dei tasti del tastierino telefonico, attiva DTMF per le integrazioni di telefonia.
  4. Testa l'agente utilizzando il simulatore.
  5. Per testare il componente tramite voce, ti consigliamo di utilizzare Dialogflow CX Phone Gateway.

Gestire gli eventi di uscita

Al termine dell'attività, un componente predefinito uscirà con la transizione simbolica END_FLOW.

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

Vedi gli eventi integrati:

  • flow-cancelled
  • flow-failed
  • 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 ha sentito la risposta di un agente, può chiedere di ripetere l'ultimo prompt.

Frasi di esempio:

  • Cosa hai appena detto?
  • Ripeti.
  • Puoi ripetere, per favore?
  • Scusi.

Funzionalità della sala d'attesa

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

Frasi di esempio:

  • Attendi.
  • Aspetta un secondo.
  • Resta in attesa, fammi controllare.
  • Sto verificando, un attimo.
  • Ora sono pronto.

Funzionalità di riproduzione

Se l'utente finale vuole sapere cosa ha raccolto finora l'agente, può chiedere all'agente di riprodurre le informazioni. L'agente riprodurrà quindi i parametri acquisiti.

Frasi di esempio:

  • Riproduzione.
  • Riproduci.
  • Puoi riprodurlo di nuovo?
  • Rileggimi quello che hai scritto.

Intenzioni comuni

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

Intenzione comune Descrizione
prebuilt_components_confirmation_yes Frasi positive utilizzate per esprimere affermazione, assenso o per indicare l'aggiunta di qualcosa che enfatizza e amplifica un'affermazione in risposta a una domanda o a una richiesta
prebuilt_components_confirmation_no Frasi negative utilizzate per esprimere dissenso, negazione o rifiuto in risposta a una domanda o a una richiesta
prebuilt_components_confirmation_done Frasi utilizzate per esprimere che l'utente finale ha terminato 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 che l'input attualmente raccolto venga riprodotto per l'utente finale in modo che possa dare conferma
prebuilt_components_replay Frasi utilizzate per richiedere la ripetizione del prompt precedente
prebuilt_components_waiting_room Frasi utilizzate per esprimere la necessità di tempo per esaminare, trovare o fornire informazioni in risposta a una domanda o a una richiesta
prebuilt_components_ready Frasi utilizzate per comunicare all'agente virtuale che l'utente finale vuole continuare un'azione