Integrar Google Dialogflow ES

Pré-requisitos

Para usar Google Dialogflow ES 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 de:

  • Uma conta do Google Cloud Platform.
  • Um agente virtual do Google Dialogflow ES configurado e treinado para fornecer respostas às solicitações de seus contatos.

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. 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. Translate: As ações de agente virtual compatíveis para este 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 scripts de 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 Google Dialogflow ES em NiCE CXone:

  • CustomPayload é usado para passar contexto para uma intençãoClosed O significado ou a finalidade por trás do que um contato diz/digita; o que o contato deseja comunicar ou realizar.. O Contexto ajuda o agente virtual a entender a intenção do usuário. Os Contextos não são obrigatórios, mas ajudam o agente virtual corresponder um enunciadoClosed O que um contato diz ou digita. a uma intenção.
  • Em uma ação de Snippet no seu script, crie um objeto customPayload que segue o formato descrito na documentação do Google Dialogflow ES Ícone indicando que o link leva a um site externo para REST Resource: projects.agent.sessions.context. A ajuda online do Studio fornece informações adicionais sobre objetos de dados dinâmicos.
  • Você também pode passar dados personalizados com customPayload sem contextos. Para fazer isso, inclua pares de chave-valor JSON padrão em um objeto de dados dinâmicos.
  • Os contextos de fala são passados na carga útil personalizada no parâmetro speech_contact. Você pode ver o conteúdo desse parâmetro em rastreamentos de Studio e logs de aplicativo.
  • O objeto dinâmico customPayload é passado como um parâmetro de agente virtual como JSON, conforme mostrado no script de exemplo.
  • Configure as dicas de contexto de fala 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 Google Dialogflow ES 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 este 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 para indicar se deseja que a transcrição da conversa e as informações de intenção sejam capturadas. Se esta guia 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 o representante da sua conta NiCE CXone para mais informações sobre este recurso.

  9. Clique em Avançar.

  10. Na página Testar + Adicionar, você pode testar a conexão do seu bot enviando prompts de voz ou de texto. Se as mensagens de teste não funcionarem, clique em voltar para retornar à página Configuração e verificar as configurações. Também pode ser necessário verificar as configurações no console de gestão do provedor do seu agente virtual.

  11. Clique em Adicionar.

Google Dialogflow ES 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 ES. 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.
Conta de serviço JSON

O arquivo de chave de 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. Este campo é visível apenas se você estiver usando seu próprio Google Dialogflow ES conta.

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"
}

Idioma

O idioma que você deseja que este agente virtual use. Esta é a linguagem que o agente virtual entende. Este é um campo obrigatório.

Região A região onde seu Google Dialogflow ES agente virtual está localizado.
Ambiente O nome do ambiente personalizado no qual seu agente virtual é publicado. Se você deixar este campo em branco, o ambiente rascunho será usado.
Executar TTS de Saída

Habilite esta opção se quiser usar o serviço 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.) do Google Dialogflow ES. Configure as configurações de saída do TTS.

Se não quiser usar o serviço Google Dialogflow CX TTS, 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.

Evento DE limite DE tempo Nome do evento Google Dialogflow ES que você deseja acionar no limite de tempo.
Padrão de pausa de Dtmf

Enter os caracteres que, quando pressionados durante uma chamada, fazem o agente virtual ignorar para o ramo DTMFBreakout do script Studio.

Preencha este campo apenas se for um agente virtual de voz.

Use Google Protobuf JSON Serializer

Ativa esta opção para usar o Serializador Google Protobuf. As respostas serializadas melhoram o desempenho reduzindo o tamanho das respostas e a memória necessária para processá-las. A redução de tamanho torna menos provável que as respostas excedam 32 KB, que é o limite geral de tamanho para variáveis de script.

Recomendamos que você ative esta opção. Se precisar desativá-la por algum motivo, ela deve ser reativada assim que o problema for resolvido.

Se você configurou sua integração do Google Dialogflow ES antes da versão Spring 2022 do NiCE CXone, é importante que você verifique seus scripts para análise da carga útil. Onde você encontrar isso, você precisa substituí-lo pela análise do novo esquema antes de habilitar essa opção na sua integração. Por exemplo, se o seu script atualmente faz referência a algo como isto:

{parameters.fields.myfield.stringValue}

você mudaria para:

{parameters.myfield}

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 ES. Quando o limite de tempo for atingido, o controle retorna ao script, que segue a ramificação de erro.

Configurar Saída de TTS do Google Dialogflow ES

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 são exibidos quando você habilita a opção executar Saída de TTS na Dialogflow página de Configuração do ES 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 a Virtual Agent Hub desta 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 de Google TTS usem ao sintetizar a fala.

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

  7. Insira a Taxa DE fala, o Pitch e o Ganho DE volume para configurar como você quer que o som da voz do TTS seja.

  8. Retornar à seção Adicionar um aplicativo a 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 Turn by Turn Control (CXone Voicebot Gateway).
  4. Em Opções de Transcription, selecione a Opção para o 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 aquele que deseja usar. Clique em Adicionar novo perfil de transcrição em tempo real Transcription para criar um novo perfil.
  6. Clique em Avançar.
  7. Retornar para a seção Adicionar um aplicativo a Virtual Agent Hub nesta página para terminar de adicionar o aplicativo de configuração.

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

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

Quando o app do agente virtualClosed O significado ou a finalidade por trás do que um contato diz/digita; o que o contato deseja comunicar ou realizar. está instalado e configurado em Virtual Agent Hub, você precisa atribuí-lo à ação 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 Ferramentas , expanda a categoria Automação e AI e adicione a ação de agente virtual que deseja usar. Certifique-se de colocá-lo na localização correta do seu script. Se você não vir 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 da esquerda, localize o perfil de agente virtual que 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 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 de 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 a partir da página de propriedades do aplicativo de agente virtual em Virtual Agent Hub. Ao testar, 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 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 no Virtual Agent Hub (não Dialogflow ES). 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, digite uma mensagem de teste no campo Digite uma mensagem e pressione Enter para enviá-la. Você também pode clicar em MicrofoneUm í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 seu teste novamente.
  7. Se você precisar fazer alterações com base nos resultados do 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 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 minuciosamente o agente virtual após cada alteração nos Scripts ou em qualquer configuração.
  9. Quando terminar de testar, clique em Fechar.