Integrar Google Dialogflow CX VoiceStream

Pré-requisitos

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

  • Uma conta do Google Cloud Platform.

  • Um agente virtual Google Dialogflow CX configurado e treinado para fornecer respostas às solicitações de seus contatosClosed A pessoa que interage com um agente, Rvi ou bot em seu contact center.. Para concluir a integração em NiCE CXone, você precisa do nome do agente virtual nas configurações do agente virtual no console do Google Dialogflow.

  • Uma conexão SIP com seu agente virtual 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. No entanto, há alguns casos em que pode ser necessário ter a visibilidade alpha habilitada. É necessária a visibilidade Alpha se você quiser:

  • 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 o seu projeto. Se você precisar dessas informações, a visibilidade alfa deve estar habilitada no seu Projeto Google Cloud.

  • 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 de script. A ação de agente virtual compatível para este provedor é VOICEBOTSTREAM e o script deve ter o tipo DE mídia telefone.

Você pode saber mais sobre a criação de scripts em Studio nas seções Fundamentals e Referência Técnico Guide da ajuda online.

Práticas recomendadas para carga útil personalizada

Siga estas práticas recomendadas ao integrar dados de carga útil personalizada de Google Dialogflow CX em NiCE CXone:

  • 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 VoiceBOT STREAM ação do 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 passar dados personalizados do seu agente virtual Dialogflow CX de volta para o 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 seu script usando a variável customPayloadVarName (out) na ação VOICEBOT STREAM em seu script.
  • 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 .

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 o provedor do seu 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 VoiceStream na lista de provedores de agentes virtuais.

  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 este formulário na seção Detalhes da Página de Configuração nesta página.

  6. Clique em Avançar.

  7. Na página Opções de Integração de Voz, a única Opção é Telefonia personalizada (grpc, DirectLine Voice, etc.). Ela é selecionada por padrão. Clique em Avançar.

  8. Na página Transcript, selecione a opção referente à captura das transcrições de conversa e informações de intenção. O padrão é Nothing. 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.

  9. Clique em Avançar.

  10. Na página Add, clique em Add.

Dialogflow CX VoiceStream 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 versão não está disponível para este provedor.
  • Versão 2.0.0: Esta versão não está disponível para este provedor.
  • 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.

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..

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.

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.

Usar Voz Personalizada

Permite que você use um modelo AutoML (aprendizado de máquina automatizado) para sintetizar uma voz personalizada para o seu bot. Dialogflow usa essa voz em vez de uma Voz TTS. Se você usar essa opção, insira o nome do modelo do AutoML que deseja usar no campo modelo de voz personalizado exibido.

Nome de voz TTS

O nome e o idioma da Voz TTS que você deseja que este agente virtual use. Essa opção não está disponível se você tiver ativado Use Custom Voice. Se você não estiver usando uma voz personalizada, esse campo é obrigatório.

Modelo

Select the machine learning model that you want the transcription service to use when transcribing the audio. These models have been trained to recognize speech from specific audio types and sources. Configure this field for voice virtual agents only. Not all languages support every model. Refer to the Google documentation for information about language support.

Chamada por telefone é a opção recomendada para a maioria dos agentes virtuais de voz.

As opções disponíveis são:

  • Comando e pesquisa: Use na transcrição de clipes de áudio mais curtos, como comandos e pesquisa de voz. Considere usar Latest Short em vez disso.
  • Padrão: Use quando o áudio não se encaixa nos outros modelos. Pode transcrever qualquer tipo de áudio, mas os resultados podem ter qualidade inferior para alguns tipos.
  • Latest Long: Use com conteúdo de formato longo, como fala espontânea ou conversas.
  • Último curto: Use quando os enunciados têm alguns segundos de duração, como comandos. Considere usar este modelo em vez de Comando e pesquisa.
  • Conversação médica: Use ao transcrever uma conversa entre um profissional médico e um paciente.
  • Ditado médico: Use ao transcrever notas ditadas por um profissional médico.
  • Chamada telefônica: Use para transcrever o áudio de uma chamada telefônica.
  • Telefonia: Use para maior qualidade de áudio em uma chamada telefônica.
  • Telefonia breve: Use para conversas curtas (menos de dez segundos) em uma chamada telefônica.
  • Vídeo: Use quando transcrever áudio que tenha múltiplos locutores, como de clipes de vídeo ou podcasts. Se Vídeo não estiver disponível no idioma que você precisa, use Último longo.
Variante DE modelo

Selecione a variante do Model selecionado que você deseja que o agente virtual use. Alguns modelos têm uma variante aprimorada que fornece resultados de maior qualidade. O padrão é Melhor disponível.

Consulte a Dialogflow documentação para obter mais informações sobre os modelos que suportam uma variante aprimorada. Os modelos aprimorados são cobrados a uma taxa mais alta do que os modelos padrão.

Para modelos de Chamada telefônica, a variante recomendada é Aprimorada.

As opções disponíveis para este campo são:

  • Best Available: Selecione se deseja que o Dialogflow use o modelo aprimorado, caso esteja disponível para o modelo selecionado. Se não estiver, o modelo padrão será usado.
  • Enhanced: selecione para usar o modelo avançado. Se um modelo aprimorado não estiver disponível para o modelo selecionado, o Dialogflow usará o modelo padrão.
  • Padrão: Selecione para usar o modelo padrão mesmo se houver um modelo aprimorado disponível.
  • Não especificado: Selecione se você não tiver certeza de qual variante usar. Dialogflow O padroniza para a melhor variante disponível do modelo selecionado.
Taxa DE fala

Clique em + ou – para alterar a velocidade com que a Voz TTS fala. A taxa pode estar entre 0,25 e 4,0. Uma taxa DE fala normal é 1,0.Uma taxa de 2,0 é duas vezes mais rápida que o normal e 0,5 é metade da velocidade normal. O padrão é 0.

Tom

Clique em + ou – para alterar o tom da voz do TTS. O tom é a voz alta ou baixa.O padrão é 0.O máximo é 20,0 e significa que a voz está 20 semitons acima do padrão.O mínimo é -20,0 e significa que a voz é 20 semitons inferior ao padrão.

Ganho DE volume

Clique em + ou – para alterar o volume da voz de TTS, medido em decibéis (dB). O padrão é 0.O intervalo é de 16,0 a -96,0 . Um ganho de +6,0 é reproduzido com aproximadamente o dobro do volume do padrão. Não exceda +10 dB.

Expressão única

Quando habilitado, o sistema trata a interação como uma solicitação de turno único. Ele escuta uma expressão completa do contato, a envia para o Dialogflow CX e, em seguida, encerra o turno. Quando desabilitado, o sistema trata a interação como uma conversa contínua e de múltiplos turnos.

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

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

Quando o aplicativo 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 e definido em Virtual Agent Hub, você precisa atribuí-lo à ação do 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. Localize a VOICEBOTSTREAM ação em seu script. Se ainda não o fez, adicione-a a partir da paleta Actions.
  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 em seu script 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.