Integrar Google Dialogflow CX

Pré-requisitos

To usar Google Dialogflow CX agentes virtuaisClosed Um aplicativo de software que gerencia as interações com clientes no lugar de um agente humano ao vivo. com NiCE CXone, você precisa:

  • Uma conta do Google Cloud Platform.

  • Um agente virtual do Google Dialogflow CX configurado e treinado para fornecer respostas às solicitações de seus contatos. Para concluir a integração no NiCE CXone, você precisa do nome do agente virtual nas configurações do agente virtual no console Google Dialogflow CX.

Visibilidade alfa no Google

Visibilidade alfa é um programa do Google que fornece a Projetos do Google Cloud acesso a recursos que não estão disponíveis por outro meio. A visibilidade alfa não é necessária para usar o Dialogflow CX com o NiCE CXone. Entretanto, há alguns casos em que pode ser necessário ter a visibilidade alfa ativada. É necessária a visibilidade Alpha se você desejar:

  • Para que a última expressão do usuário seja retornada do agente virtual Dialogflow juntamente com as informações de intenção. Você pode ver essas informações em um rastreamento de script. Se a variável lastUserUtterance estiver vazia quando deveria conter dados, a visibilidade alfa pode não estar habilitada para seu projeto. Se você precisar dessas informações, a visibilidade alfa deve estar habilitada em seu Cloud Project Google.

  • Para que a página atual seja retornada como parte da carga útil personalizada da resposta.

  • Para que o campo de transcrição Dialogflow seja retornado como parte da carga útil da resposta.

Criar um script

Permissões necessárias: Studio Script View, Create/Edit

É necessário pelo menos um script do Studio para direcionar as interações para o seu agente virtual. Siga as diretrizes do script. Seu script deve ter o tipo DE mídiaClosed Um meio, como voz, e-mail e chat, pelo qual um contato se conecta com um destinatário pretendido. telefone para um agente virtual de voz ou o tipo DE mídia digital para um agente virtual de texto. Os ações do agente virtual com suporte para esse provedor são:

Se você estiver configurando um agente virtual de voz e usando um serviço NiCE CXone Text-to-Speech (Cloud TTS Hub), inclua a CLOUD TTS ação em seu script.

Você pode saber mais sobre o script do Studio nas seções Fundamentos e Referência Técnica Guide da ajuda online.

  • O Dialogflow CX não usa contextos para passar dados paraDialogflow intençõesClosed O significado ou a finalidade por trás do que um contato diz/digita; o que o contato deseja comunicar ou realizar. do Dialogflow como o Dialogflow ES faz.
  • Você pode passar dados personalizados para Dialogflow CX usando pares de chave-valor JSON. Em uma Snippet ação no seu script, crie um objeto dinâmico customPayload e adicione os pares de chave-valor a ele. Por exemplo:

    DYNAMIC customPayload
    customPayload.ani = ani
    customPayload.contactID = contactId
    customPayload.masterContactId = masterId
    customPayloadJSON = "{customPayload.asJSON()}"	
  • Na ação Exchange em seu script, configure a propriedade customPayload com uma variável que tenha a função asJSON() em seu valor. Você pode encontrar essa variável no objeto customPayload.
  • Transmita a customPayload JSON para o agente virtual usando a propriedade Payload de QueryParameters. Consulte a documentação de Google sobre QueryParameters A square with an arrow pointing from the center out from the top right corner. para Google Dialogflow CX.
  • Dados transmitidos por meio de QueryParameters são recebidos por um webhook em Dialogflow CX.Você pode escrever código no console CX Dialogflowpara manipular os dados passados.
  • Não aninhe um objeto dentro do objeto customPayload. Os objetos são enviados como strings literais.
  • Para transmitir dados personalizados do seu agente virtual Dialogflow CX de volta ao script, use o campo Carga útil personalizada no console Dialogflow CX.Verifique se você está no console do agente virtual que está usando NiCE CXone. Mapeie isso para o seu script usando a variável customPayloadVarName (out) na ação Studio VOICEBOT EXCHANGE ou TEXTBOT EXCHANGE Studiono seu script. Por exemplo, você pode usar isso para definir os comportamentos do próximo prompt.
  • Para passar dados personalizados para o Dialogflow CX a partir do script, use session_params no objeto customPayload em uma ação Snippet. Por exemplo:

    DYNAMIC customPayload
    customPayload.session_params.name = "Winnie le Pooh" 
    customPayload.session_params.job = "Food critic" 
    customPayload.session_params.location = "Hundred Acre Wood"	

    Acesse os parâmetros de sessão no intent do agente CX Dialogflow usando a seguinte sintaxe:

    $session.params.name = Winnie Le Pooh
    $session.params.job = Food critic
    $session.params.location = 100 Acre Wood 

    Os parâmetros de sessão são usados apenas com agentes virtuais Dialogflow CX. Para obter um resultado semelhante com Dialogflow ES, use contextos.

  • Configurar dicas de contexto de fala e um ID de conversa personalizado para transferir a conversa para um agente virtual Dialogflow CX diferente no snippet Carga útil personalizada .

  • Para configurar por quanto tempo o agente virtual aguarda quando o contato faz uma pausa ao falar, adicione o maxPostEnergySilenceMS parâmetro à Next Prompt Behaviorsou Default Next Prompt Behaviors Snippet ação.

Adicionar um aplicativo ao Virtual Agent Hub

Permissões necessárias: Connections Hub > Launch Connections Hub

Adicionar um aplicativo de configuração ao Virtual Agent Hub estabelece a conexão entre NiCE CXone e seu provedor de agente virtual.

  1. Em NiCE CXone, clique no seletor de aplicativos Icon of three-by-three grid of white squares on a blue background e selecioneOutro > Connection Hub e, em seguida, clique em Virtual Agent Hub. Você também pode dar um duplo clique na ação de agente virtual em seu script Studio para iniciar Virtual Agent Hub.
  2. Clique Adicionar bot.
  3. Digite um nome do agente virtual (bot) e clique em Dialogflow CX na lista de provedores de Agente virtual.

  4. Clique em Avançar.

  5. Preencha os campos no formulário de configuração e clique em Avançar. Você pode encontrar detalhes sobre esse formulário na seção Detalhes da Página de Configuração nesta página.

  6. Clique em Avançar.

  7. Se você estiver configurando um agente virtual de texto, selecione Text Only (No Voice Support) na página Voz. Se você estiver configurando um agente virtual de Voz, consulte a seção Configurar Opções de Integração de voz nesta página.

  8. Na página Transcript, selecione a opção que indica se deseja que a transcrição da conversa e as informações de intenção sejam capturadas. Se essa aba não estiver disponível, o recurso não está habilitado para o seu locatárioClosed Agrupamento organizacional de alto nível usado para gerenciar o suporte técnico, o faturamento e as configurações globais do seu sistema NiCE CXone.. Contate seu representante de conta para obter mais informações sobre esse recurso. Esta opção está disponível somente para agentes virtuais de texto e agentes virtuais de voz baseados em frases (utterance-based).

  9. Clique em Avançar.

  10. Na página Test + Add, você pode Testar a conexão do seu bot enviando prompts de voz ou texto. Se suas mensagens de teste não funcionarem, clique em voltar para retornar à página Configuration e verificar as configurações.

  11. Clique em Adicionar.

Google Dialogflow CX Detalhes da Página de configuração

Use as informações na tabela a seguir ao preencher a página Configuração. Você vê essa página ao adicionar um aplicativo em Virtual Agent Hub

Campo

Detalhes

Versão DE integração

Selecione a versão de Virtual Agent Hub que você deseja usar. Esta opção permite que você use uma versão anterior do Virtual Agent Hub até que esteja pronto para mudar para uma versão recém-lançada. As versões disponíveis são:

  • Versão 1.0.0: Esta é a primeira versão de Virtual Agent Hub. O objeto de carga útil personalizada retorna como customPayload.payload.xxxx.
  • Versão 2.0.0: Esta versão atualizou os esquemas usados com Google Dialogflow CX. Isso afeta a estrutura do objeto customPayload.
  • Versão 3.0.0: Esta versão introduziu StandardBot, que padroniza a forma como NiCE CXone se comunica com os provedores de agente virtual. O objeto customPayload retorna como uma matriz, como customPayloadscriptPayloads[n].xxxx. Esta versão está disponível para todos os provedores.

SIP configurado Não ative esta opção. NiCE CXone não oferece suporte a uma configuração de backchannel SIP com Google Dialogflow CX.
Conta de serviço JSON

O arquivo de chave da conta de serviço que você criou e baixou do Google Cloud Console. Copie e cole todo o conteúdo do arquivo de chave neste campo, incluindo as chaves que envolvem a chave. Este campo é visível apenas se você estiver usando seu próprio Google Dialogflow CX conta. Se o campo não estiver visível quando deveria estar, peça ao representante da sua conta NiCE CXone para revisar as configurações do seu sistema.

A chave da conta de serviço é um objeto JSON similar ao exemplo a seguir:

{

"type": "service_account",
"project_id": "ic-demo2-aai-gcp",
"private_key_id": "sdv80sdf08ssd9sdf0sdf8sdfsdf90sdf8",
"private_key": "-----BEGIN PRIVATE KEY-----
nMIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQCzgrS8vp
<private key has been truncated for this example>
----END PRIVATE KEY-----\n",
"client_email": "your@client_email-gcp.iam.gserviceaccount.com",
"client_id": "123456789",
"auth_uri": "https://accounts.google.com/o/oauth2/auth",
"token_uri": "https://oauth2.googleapis.com/token",
"auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
"client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/dialogflow-dthjop%40ic-demo2-aai-gcp.iam.gserviceaccount.com"
}

A Conta de Serviço JSON deve ter a função de Admin da API Dialogflow A square with an arrow point from the center out to the upper right corner..

Idioma

O idioma que você deseja que este agente virtual use. Esta é a linguagem que o agente virtual entende. Este é um campo obrigatório. Selecione None para suprimir o código de idioma nas solicitações de API. Use esta opção quando o agente virtual gerencia a detecção de idioma por conta própria ou não requer um código de idioma.

Região

A região onde o Google Dialogflow CX agente virtual que você está adicionando Virtual Agent Hub está localizado. Este é um campo obrigatório.

Agente

O nome do Google Dialogflow CX agente virtual que você deseja adicionar Virtual Agent Hub . Você pode encontrar o nome no console CX do Dialogflow agente virtual e clicar em Copy Name para copiá-lo para a área de transferência. Este é um campo obrigatório.

Ambiente

Insira o GUID do ambiente que você deseja que este aplicativo Dialogflow use. No Dialogflow CX, diferentes versões do mesmo agente virtual são chamadas de ambientes. Você pode encontrar o GUID para seus ambientes no console Google Dialogflow CX nas configurações do agente.

Executar TTS de Saída

Clique no controle deslizante para Ativado se desejar usar o serviço Google Dialogflow CX de conversão de texto em fala (TTSClosed Permite que os usuários insiram prompts gravados como texto e usem uma voz gerada por computador para falar o conteúdo.). Configurar as opções de TTS para Google.

Se não quiser usar o serviço TTS Google Dialogflow CX, deixe este campo definido como Desativado. Você pode usar um serviço NiCE CXoneText-to-Speech (Cloud TTS Hub).

Se esse for um agente virtual de texto, deixe a opção desativada.

Manipulador de evento DE limite DE tempo Nome do evento Google Dialogflow CX que você deseja acionar no tempo limite.
Padrão de pausa de Dtmf Se os caracteres especificados forem pressionados, o script passa diretamente para a ramificação OnDTMFBreakout .
Realizar análise de Sentimento

Clique no controle deslizante para Ativado se desejar receber os resultados da análise de sentimento de Google. Esta opção requer que você tenha esta opção ativada em seu projeto do Google Cloud. Você é responsável por configurar como os dados da análise de sentimento são usados com seu agente virtual.

Limite de tempo do provedor externo

Enter o número de segundos que você deseja que o script espere por uma resposta de Dialogflow CX. Quando o limite de tempo for atingido, o controle retorna ao script, que segue a ramificação de erro.

Perfil de Conversação

Insira o id do perfil de conversação Dialogflow CX que deseja que este perfil Virtual Agent Hub utilize. Se você não especificar um ID, o sistema criará um novo perfil. Você pode encontrar o id do perfil de conversação no console de gestão de projetos do Google.

Se você alterar os campos Agente ou Ambiente, o campo Perfil de Conversa é limpo. Isso ocorre porque os perfis de conversa são específicos do agente e do ambiente.

Configurar Saída de TTS do Google Dialogflow CX

Permissões necessárias: Connections Hub > Launch Connections Hub

Conclua as etapas desta seção se quiser usar o serviço Google TTS. Os campos na imagem a seguir aparecem quando você habilita a opção Perform Output TTS na Dialogflow página CX Configuration em Virtual Agent Hub.

  1. Em Virtual Agent Hub, adicione um novo aplicativo de configuração e configure-o de acordo com as etapas na seção Adicionar um aplicativo ao Virtual Agent Hub nesta página.
  2. Ative executar TTS de Saída.
  3. Para usar um modelo de voz personalizado, ative Usar Voz personalizada e insira o nome do modelo AutoML que você quer usar no campo modelo de Voz personalizado.

  4. Se você quiser usar um modelo de voz do Google, selecione o nome da Voz TTS na lista suspensa.

  5. Selecione o modelo de machine learning e a Variante DE modelo que você deseja que os serviços Google TTS usem ao sintetizar a fala.

  6. Para adicionar silêncio ao início da resposta em áudio do agente virtual, insira o número de milissegundos de silêncio a adicionar no campo Add Leading Silence. O tempo de silêncio recomendado é de 500 milissegundos.

  7. Enter a Taxa DE fala, Pitch e Ganho DE volume para configurar o som da voz do TTS que você deseja.

  8. Retornar à seção Adicionar um aplicativo ao Virtual Agent Hub nesta página para terminar de adicionar o aplicativo de configuração.

Configurar Opções de Integração de Voz

Permissões necessárias: Connections Hub > Launch Connections Hub

Se estiver configurando um agente virtual de texto, você pode pular esta seção.

  1. Em Virtual Agent Hub, adicione um novo aplicativo de configuração e configure-o de acordo com as etapas na seção Adicionar um aplicativo ao Virtual Agent Hub nesta página.
  2. Clique em Próx. na página Configuration.

  3. Na página Voz, em Opções de Integração de Voz, selecione Controle Passo a Passo (CXone Voicebot Gateway).
  4. Em Opções de Transcription, selecione a Opção do serviço de transcrição que você deseja usar.

  5. Se você optar por usar um perfil Turn-by-Turn Transcription, clique em Turn-by-Turn Transcription Perfil para selecionar o que deseja usar. Clique em Adicionar novo perfil de Turn by Turn Transcription para criar um novo perfil.
  6. Em Transcription opções, selecione um Transcription Profile ou clique em Add New Turn by Turn Transcription Profile para criar um novo perfil.
  7. Clique em Avançar.
  8. Retorne à Adicionar um aplicativo à seção Virtual Agent Hub nesta página para terminar de adicionar o aplicativo de configuração.

Atribuir o aplicativo Google Dialogflow CX a uma Ação

Permissões necessárias: Studio Script View, Create/Edit

Quando o aplicativo de agente virtualClosed O significado ou a finalidade por trás do que um contato diz/digita; o que o contato deseja comunicar ou realizar. estiver configurado em Virtual Agent Hub, você precisa atribuí-lo à ação de agente virtual em seu script. Isso conecta a ação e o script ao seu provedor de agente virtual.

  1. Dentro Studio, abra o script que deseja modificar.
  2. Se ainda não o fez, clique na guia Tools , expanda a categoria Automation and AI e adicione a ação de agente virtual que deseja usar. Certifique-se de colocá-lo na localização correta em seu script. Se você não visualizar a ação esperada, verifique se o tipo DE mídia do script está correto.Por exemplo, se você estiver criando um script para um agente virtual de voz, o script deverá ser um script de telefone.

  3. Clique em Abrir editor na ação para abrir Virtual Agent Hub.

  4. Na coluna à esquerda, localize o perfil de agente virtual que você deseja atribuir à ação e clique na marca de seleção Um ícone de círculo com uma marca de seleção dentro dele. ao lado dele.

    Uma alternativa ao uso da marca de seleção é criar uma variável no seu script do Studio. Use a variável para passar o nome do aplicativo do agente virtual para a propriedade ID do Agente virtual da ação Virtual Agent Hub que você está usando.

  5. Clique me Fechar.

Alterar o Perfil Transcription

Permissões necessárias: Connections Hub > Launch Connections Hub

Um perfil de transcrição permite que você use um serviço de transcrição diferente daquele oferecido pelo provedor do agente virtual. Cada agente virtual pode ter um perfil de transcrição. Você só precisa seguir as etapas desta seção se estiver trabalhando com um agente virtual de voz e precisar alterar o perfil de transcrição.

  1. Em NiCE CXone, clique no seletor de aplicativos Icon of three-by-three grid of white squares on a blue background e selecioneOutro > Connection Hub e, em seguida, clique em Virtual Agent Hub. Você também pode dar um duplo clique na ação de agente virtual em seu script Studio para iniciar Virtual Agent Hub.
  2. Na lista de aplicativos de configuração de agente virtual no painel esquerdo da página Virtual Agent Hub, clique naquele que você deseja modificar.
  3. No centro da página de propriedades do aplicativo de agente virtual, clique na guia Voz.
  4. Em Opções de Transcription, selecione Usar Perfil de Turn-by-Turn Transcription se ainda não estiver selecionado.

  5. Selecione o Perfil Turn by TurnTranscription que você deseja que esta integração de agente virtual use. Se a opção que você deseja usar não estiver lá, você poderá adicioná-la.

  6. Clique em Salvar.
  7. Teste seu serviço de transcrição usando a opção de microfone na seção testar da página de propriedades do aplicativo de agente virtual.

Testar seu Agente virtual

Permissões necessárias: Connections Hub > Launch Connections Hub

Você pode testar muitos aspectos do seu agente virtual para garantir que tudo funcione conforme o esperado. Você pode executar testes na página de propriedades do aplicativo de agente virtual em Virtual Agent Hub. Durante os testes, você pode:

  • Verificar se o aplicativo do agente virtual está configurado corretamente para se comunicar com o provedor do agente virtual.
  • Adicionar a carga útil personalizada JSON para testar a manipulação de dados da carga útil personalizada do agente virtual.
  • Acione um evento de intenção DE boas vindas para testar como o agente virtual inicia uma conversa.
  • Acione um evento de intenção personalizada para testar quaisquer eventos personalizados que você criou para o seu agente virtual.
  • Acionar um evento de tempo limite para testar como o agente virtual responde quando o contato expira.
  • Testar como o agente virtual lida com a entrada DTMFClosed Tons de sinalização gerados quando um contato pressiona uma tecla do teclado do telefone..

A imagem a seguir é um exemplo da página de propriedades de um aplicativo do agente virtual em Virtual Agent Hub (não Dialogflow CX). Mostra as guias Configuração e Voz e o painel teste.

  1. Em NiCE CXone, clique no seletor de aplicativos Icon of three-by-three grid of white squares on a blue background e selecioneOutro > Connection Hub e, em seguida, clique em Virtual Agent Hub. Você também pode dar um duplo clique na ação de agente virtual em seu script Studio para iniciar Virtual Agent Hub.
  2. Clique para selecionar o aplicativo de configuração para o agente virtual que deseja testar na lista à esquerda.
  3. No painel Testar, insira uma mensagem de teste no campo Type a message e pressione Enter para enviá-la. Você também pode clicar em MicrophoneUm ícone na forma de um microfone. e falar no microfone do computador.

  4. Clique em Iniciar com intenção DE boas vindas para iniciar uma conversa de teste desde o início. O agente virtual responde com sua mensagem de boas-vindas padrão. Você pode inserir mensagens de teste.
  5. Clique em Mais opçõesUm ícone com três pontos empilhados verticalmente. para testar outros aspectos do seu agente virtual.

  6. Clique em Reset para iniciar o teste novamente.
  7. Se você precisar fazer alterações com base nos resultados de seus testando, você pode:

    • Modificar os scripts do Studio para o agente virtual.
    • Modificar as configurações no aplicativo do agente virtual no Virtual Agent Hub.
    • Modificar as configurações do agente virtual no console do provedor. Clique no botão quadrado grande na página de propriedades do aplicativo em Virtual Agent Hub. O exemplo no início desta seção mostra o aplicativo Google Dialogflow CX com o botão do provedor. Ele tem o ícone An icon that has a square with an arrow overlaid on top of it. The arrow points from the center of the square to the top right corner of the square. para indicar que o link abre um site externo.
  8. Teste o agente virtual minuciosamente após cada alteração nos Scripts ou em qualquer configuração.
  9. Quando terminar de testar, clique em Fechar.