Panoramica dei componenti predefiniti

I componenti predefiniti sono una raccolta di flussi predefiniti forniti da Conversational Agents (Dialogflow CX) per 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 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 di tuo interesse e poi su Importa come flusso.
  7. Consulta la documentazione specifica di ciascun 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 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 Google Cloud Storage esterno ospitato da Google in cui sono archiviati. Se le regole VPC-SC impediscono l'egress al bucket ospitato da Google, durante l'importazione potresti visualizzare un messaggio di errore contenente il testo "Autorizzazione negata durante l'accesso all'URI Google Cloud Storage "gs://gassets-api-ai/prebuilt_components/cx-standard-prebuilt-components/resource-name"".

Per attivare l'importazione, devi creare una regola di 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 attivare 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 degli agenti e le entità personalizzate per soddisfare le esigenze della tua attività.
  2. Per gli agenti vocali, sono consigliate le seguenti impostazioni di parlato:
  3. Se utilizzi un'integrazione di telefonia che consente di estrarre i valori dei parametri dalle pressioni dei tasti del telefono, attiva la funzionalità DTMF per le integrazioni di telefonia.
  4. Testa l'agente utilizzando il simulatore.
  5. Per testare il componente tramite comandi vocali, ti consigliamo di utilizzare Dialogflow CX Phone Gateway.

Gestire gli eventi di uscita

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

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

Consulta 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 dell'agente, può chiedere di ripetere l'ultima richiesta.

Frasi di esempio:

  • Cosa hai appena detto?
  • Ripeti.
  • Puoi ripetere?
  • Scusa.

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 funzionalità della sala d'attesa è attivata in alcuni componenti predefiniti chiamando il componente predefinito della 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.
  • Aspetta 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ò chiedergli di riprodurre i dati. L'agente riprodurrà quindi i parametri attualmente acquisiti.

Frasi di esempio:

  • Riproduzione.
  • Riproducila.
  • Riproduci di nuovo, per favore.
  • Rileggila.

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 sottolinea e amplifica un'affermazione in risposta a una domanda o una richiesta
prebuilt_components_confirmation_no Frasi negative utilizzate 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 di riavviare l'intera esperienza 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 di ripetere il 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 una richiesta
prebuilt_components_ready Frasi utilizzate per comunicare all'agente virtuale che l'utente finale vuole continuare un'azione