Visão geral dos componentes pré-criados

Os componentes pré-criados são uma coleção de fluxos pré-criados fornecidos pelo Dialogflow CX para tarefas e cenários comuns. Eles podem ser usados para acelerar o desenvolvimento de agentes novos e atuais.

Há dois tipos de componentes pré-criados:

  • Elementos básicos:componentes que coletam parâmetros específicos, como nome e endereço.
  • Casos de uso:componentes que representam jornadas do usuário maiores, como fazer um pagamento, que podem usar um ou mais elementos básicos.

Os fluxos de componentes pré-criados incluem intents e entidades prontas para uso. Para componentes que exigem integrações com serviços externos, é necessário modificar a configuração dos webhooks flexíveis para que eles se integrem aos endpoints adequados.

Os seguintes componentes de elementos básicos estão disponíveis:

Os seguintes componentes de caso de uso estão disponíveis:

Limitações

Considere as seguintes limitações:

  • No momento, os componentes pré-criados só estão disponíveis em inglês (en).

Importar um componente pré-criado

Para importar um componente pré-criado para seu projeto:

  1. Acesse o console do Dialogflow CX.
  2. Escolha seu projeto do Google Cloud.
  3. Selecione seu agente ou crie um novo.
  4. Selecione a guia Manage.
  5. Clique em Prebuilt no painel Manage.
  6. Clique no componente de interesse e em Importar como fluxo.
  7. Consulte a documentação específica de cada componente para determinar se é necessária uma configuração adicional para o webhook.
  8. Comece a testar e personalizar.

VPC Service Controls

Se o projeto estiver em um perímetro do VPC Service Controls (VPC-SC), talvez seja necessário adicionar uma regra de saída para permitir a importação das versões mais recentes dos componentes pré-criados do bucket externo do Google Cloud Storage hospedado pelo Google em que eles estão armazenados. Se as regras do VPC-SC impedirem a saída para o bucket hospedado pelo Google, talvez você veja uma mensagem de erro na importação que contém "Permissão negada ao acessar o URI do Google Cloud Storage 'gs://gassets-api-ai/prebuilt_components/cx-standard-prebuilt-components/resource-name'".

Para ativar a importação, crie uma regra de saída que permita o acesso ao projeto externo do Google Cloud que contém o bucket gs://gassets-api-ai do Google Cloud Storage. Os atributos a seguir descrevem o recurso e as operações necessárias para ativar a importação do recurso do Google:

  • Recurso:projects/921279757870
  • Nome do serviço:storage.googleapis.com
  • Método:google.storage.objects.get

Personalizações e configurações

Para personalizar o componente e melhorar as configurações:

  1. Edite as respostas do agente e as entidades personalizadas para atender às necessidades da sua empresa.
  2. Para agentes de voz, recomendamos as seguintes configurações de fala:
  3. Se você usa uma integração de telefonia que permite valores de parâmetro extraídos de pressionamentos de teclado de telefone, ative DTMF para integrações de telefonia.
  4. Teste o agente usando o simulador.
  5. Para testar seu componente por voz, recomendamos usar o gateway telefônico do Dialogflow CX.

Processar eventos de saída

Após a conclusão da tarefa, um componente pré-criado será encerrado com o destino de transição simbólica END_FLOW.

Quando um componente pré-criado não consegue concluir a tarefa, os eventos a seguir são emitidos para a página de chamada que causou a transição para o fluxo do componente pré-criado. É uma prática recomendada processar esses eventos no agente criando os manipuladores de eventos correspondentes na página de chamada.

Consulte os eventos integrados:

  • flow-cancelled
  • flow-failed
  • flow-failed-human-escalation

Outras funcionalidades

Alguns componentes pré-criados têm outras funcionalidades. Consulte a documentação específica do componente para verificar quais recursos são implementados para um componente específico.

Funcionalidade de repetição

Se o usuário final tiver dificuldade para interpretar o agente virtual ou não tiver ouvido uma resposta do agente, ele poderá pedir para repetir o último comando.

Frases de treinamento:

  • O que você disse?
  • Repita.
  • Pode repetir?
  • Perdão.

Funcionalidade da sala de espera

Se o usuário final quiser um minuto para responder ao agente e não tiver uma resposta imediata para um comando, ele poderá pedir para o agente virtual aguardar. Quando o usuário final estiver pronto para continuar a conversa, ele poderá dizer ao agente "Estou pronto" para retomar a conversa. O recurso de sala de espera é ativado em alguns componentes pré-criados chamando o componente pré-criado de sala de espera. O recurso de sala de espera também pode ser ativado em qualquer lugar do agente seguindo as instruções de configuração descritas na visão geral do componente pré-criado de sala de espera.

Frases de treinamento:

  • Aguarde.
  • Espera aí.
  • Aguarde um momento, vou verificar.
  • Estou verificando, aguarde.
  • Estou pronto.

Funcionalidade de reprodução

Se o usuário final quiser saber o que o agente coletou até o momento, ele poderá pedir ao agente para reproduzir. O agente vai repetir os parâmetros capturados no momento.

Frases de treinamento:

  • Reprodução.
  • Vamos fazer uma retrospectiva.
  • Pode repetir, por favor?
  • Leia isso para mim.

Intents comuns

As intents comuns são usadas para comportamentos comuns em vários componentes.

Intent comum Descrição
prebuilt_components_confirmation_yes Frases positivas usadas para expressar afirmação, consentimento ou para marcar a adição de algo que enfatiza e amplifica uma declaração em resposta a uma pergunta ou solicitação
prebuilt_components_confirmation_no Frases negativas usadas para expressar discordância, negação ou recusa em resposta a uma pergunta ou solicitação
prebuilt_components_confirmation_done Frases usadas para expressar que o usuário final concluiu uma tarefa ou solicitação
prebuilt_components_escalate_human_agent Frases usadas para solicitar que o agente virtual conecte o usuário final a um agente humano
prebuilt_components_start_over Frases usadas para solicitar que toda a experiência seja reiniciada do começo
prebuilt_components_playback Frases específicas para solicitar que a entrada coletada no momento seja reproduzida para o usuário final, para que ele possa confirmar.
prebuilt_components_replay Frases usadas para pedir que o comando anterior seja repetido
prebuilt_components_waiting_room Frases usadas para expressar a necessidade de tempo para analisar, encontrar ou fornecer informações em resposta a uma pergunta ou solicitação
prebuilt_components_ready Frases usadas para notificar o agente virtual de que o usuário final quer continuar uma ação