Visão geral dos componentes pré-criados

Componentes pré-criados são uma coleção de fluxos pré-criados fornecidos pelo Dialogflow para tarefas e cenários comuns. Elas podem ser usadas 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 maiores do usuário, 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 integrar com os endpoints adequados.

Os seguintes componentes 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ó têm suporte ao inglês (en).

Importar um componente pré-criado

Para importar um componente pré-criado para seu projeto, siga estas etapas:

  1. Acesse o Console do Dialogflow CX.
  2. Escolha seu projeto do Google Cloud.
  3. Selecione o agente ou crie um novo.
  4. Selecione a guia Manage.
  5. Clique em Pré-criado no painel Gerenciar.
  6. Clique no componente de interesse e depois em Import as flow.
  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 dentro de um perímetro do VPC Service Controls (VPC-SC), talvez seja necessário adicionar uma regra de saída para ativar a importação das versões mais recentes de 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 contendo "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, é preciso criar 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 permitir 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 do seu negócio.
  2. Para agentes de voz, são recomendadas as seguintes configurações de fala:
  3. Se você usar uma integração de telefonia que permita valores de parâmetro extraídos de pressionamentos de teclado telefônico, ative o DTMF para integrações de telefonia.
  4. Teste o agente usando o simulador.
  5. Para testar seu componente por voz, recomendamos usar o Dialogflow CX Phone Gateway.

Processar eventos de saída

Após a conclusão da tarefa, um componente pré-criado vai ser fechado com o END_FLOW destino de transição simbólica (link em inglês).

Quando um componente pré-criado não consegue concluir a tarefa, os eventos a seguir serã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:

  • com cancelamento de fluxo
  • com falha no fluxo
  • flow-failed-human-escalation

Outros recursos

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

Repetir funcionalidade

Se o usuário final tiver dificuldade para interpretar o agente virtual ou não ouvir a resposta do agente, ele poderá solicitar que o último prompt seja repetido.

Exemplos de declarações:

  • O que você acabou de dizer?
  • Diga de novo.
  • Pode repetir?
  • Pardo.

Funcionalidade de sala de espera

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

Exemplos de declarações:

  • Aguarde.
  • Espere um segundo.
  • Por favor, aguarde.
  • Estou verificando, aguarde.
  • Estou pronto agora.

Funcionalidade de reprodução

Se o usuário final quiser saber o que o agente coletou até agora, ele poderá solicitar que ele reproduza o que foi coletado. O agente vai reproduzir os parâmetros capturados no momento.

Exemplos de declarações:

  • Reprodução.
  • Reproduza.
  • Tocar isso, por favor?
  • Leia de volta para mim.

Intents comuns

Intents comuns são aquelas usadas para comportamentos comuns em vários componentes.

Intenção comum Descrição
prebuilt_components_confirmation_yes Frases positivas usadas para expressar afirmação, concordância ou para marcar a adição de algo, enfatizando e amplificando uma afirmaçã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 recomece do início
prebuilt_components_playback Frases específicas para solicitar que a entrada coletada no momento seja reproduzida ao usuário final, para que ele possa confirmar
prebuilt_components_replay Frases usadas para pedir que a instrução anterior seja repetida
prebuilt_components_waiting_room Frases usadas para expressar a necessidade de tempo para revisar, 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