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:

  • Blocchi predefiniti:componenti che raccolgono parametri specifici, come nome e indirizzo.
  • Casi d'uso:componenti che rappresentano percorsi utente più ampi, come l'esecuzione di un pagamento, che possono utilizzare uno o più blocchi predefiniti.

I flussi dei 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 appropriati.

Sono disponibili i seguenti componenti 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 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. 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 di Controlli di servizio VPC (VPC-SC) perimeter, 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'uscita verso il bucket ospitato da Google, potresti visualizzare un messaggio di errore durante l'importazione contenente "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 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 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 esigenze della tua attività.
  2. Per gli agenti vocali, sono consigliate le seguenti impostazioni vocali:
  3. Se utilizzi un'integrazione di telefonia che consente di estrarre i valori dei parametri dalle pressioni della tastiera del telefono, abilita DTMF per le integrazioni di telefonia.
  4. Testa l'agente utilizzando il simulatore.
  5. Per testare il componente tramite la voce, ti consigliamo di utilizzare il gateway telefonico di Dialogflow CX.

Gestire gli eventi di uscita

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

Quando un componente predefinito non è in grado di completare l'attività, verranno generati i seguenti eventi per la pagina chiamante che ha causato la transizione al flusso del componente predefinito. Ti consigliamo di gestire questi eventi nel tuo agente creando i gestori di eventi corrispondenti nella pagina chiamante.

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 una risposta dell'agente, può chiedere di ripetere l'ultimo prompt.

Esempi di espressioni:

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

Funzionalità della sala d'attesa

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

Esempi di espressioni:

  • Attendi, per favore.
  • Un secondo.
  • Attendi, per favore, devo controllare.
  • Sto controllando, aspetta.
  • Ora sono pronto.

Funzionalità di riproduzione

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

Esempi di espressioni:

  • Riproduci.
  • Riproduci.
  • Puoi riprodurre, per favore?
  • Ripeti.

Intent comuni

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

Intent comune Descrizione
prebuilt_components_confirmation_yes Frasi positive utilizzate per esprimere affermazione, assenso o per contrassegnare 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 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 che l'input attualmente raccolto venga riprodotto all'utente finale 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 a una richiesta.
prebuilt_components_ready Frasi utilizzate per notificare all'agente virtuale che l'utente finale vuole continuare un'azione.