Integrar Microsoft Azure

Antes de concluir as tarefas desta página, certifique-se de que os pré-requisitos da integração tenham sido atendidos.

Criar um script

Permissões necessárias: Visualizar, criar/editar scripts do Studio

É necessário pelo menos um script do Studio para direcionar as interações para o seu agente virtual. Siga as diretrizes e os requisitos de script. O script deve conter o tipo de mídia Uma mídia, como voz, e-mail e chat, por meio da qual um contato se conecta a um destinatário pretendido. telefônica para um agente virtual de voz ou o tipo de mídia digital para um agente virtual de texto. As ações de agente virtual suportadas para este provedor são:

• VoiceBot Exchange
• TextBot Exchange

Você pode saber mais sobre scripts do Studio nas seções Fundamentos e Guia de referência técnica da ajuda online.

Quando o seu agente virtual estiver pronto para ser colocado em produção, atribua o script a um ou mais pontos de contato.

Adicionar um aplicativo ao Virtual Agent Hub

Permissões necessárias: Automação e IA > Iniciar Automação e IA

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

1. No CXone, clique no seletor de aplicativos e selecioneOutra > Automação e IA e clique em Virtual Agent Hub. Você também pode clicar duas vezes na ação do agente virtual no seu script do Studio para iniciar o Virtual Agent Hub.
2. Clique Adicionar bot.

3. Digite um Nome de agente virtual (bot) e clique em Microsoft Azure 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 esse formulário na seção Detalhes da página de configurações nesta página.

6. Clique em Avançar.

7. Se estiver configurando um agente virtual de texto, selecione Somente texto (sem suporte para voz) na página Voz. Se estiver configurando um agente virtual de voz, entre em contato com seu Representante de Contas do CXone.

8. Clique em Avançar.

9. Na página Transcrição, selecione se você quer a transcrição da conversa e as informações de intenção capturadas.

   Saiba mais sobre os campos nesta etapa

   Opção	Detalhes
   Não capturar ou arquivar transcrição ou informações de intenção	Selecione esta opção se não quiser capturar transcrições de conversas ou informações de intenção O significado ou propósito por trás do que um contato diz/digita; o que o contato quer comunicar ou alcançar..
   Capturar e arquivar somente informações de intenção	Selecione esta opção se quiser capturar somente informações de intenção. Os dados capturados são armazenados apenas durante a interação por padrão. Esta opção exige script personalizado.
   Capturar ou arquivar transcrição e informações de intenção	Selecione esta opção se quiser capturar transcrições e dados de intenção. Os dados capturados são armazenados apenas durante a interação por padrão. Esta opção exige script personalizado.

10. Clique em Avançar.

11. 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 Configuração e verificar as configurações. Você também pode precisar verificar as configurações no console de gerenciamento do seu provedor de agente virtual.

12. Clique em Adicionar.

Detalhes da página de configurações do Microsoft Azure

Use as informações na tabela a seguir ao preencher a página de configurações. Você verá essa página quando adicionar um aplicativo no Virtual Agent Hub

campo	Detalhes
Versão de integração	Selecione a versão do Virtual Agent Hub que quer 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 do Virtual Agent Hub. O objeto de carga útil personalizada retorna como customPayload.payload.xxxx. 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 o StandardBot, que padroniza como o CXone se comunica com provedores de agentes virtuais. O objeto customPayload retorna como uma matriz, como customPayloadscriptPayloads[n].xxxx. Esta versão está disponível para todos os provedores.
Segredo de linha direta	Insira seu segredo de autenticação Linha direta. Um segredo da Linha direta permite que o CXone acesse qualquer conversa que ocorra com seu agente virtual Microsoft Azure. Você pode encontrar o segredo no portal Microsoft Azure.
Use sua própria conta para invocação de conversão de Texto para fala da Azure (em vez da Nuvem TTS da CXone)	Se você quiser usar o serviço de conversão de texto em fala do Microsoft Azure e tiver sua própria conta configurada, arraste o controle deslizante para Ativado. Se você quiser usar o CXone Cloud TTS Hub ou não tiver uma conta Azure TTS configurada, deixe este campo definido como Desativado. Você pode configurar o Cloud TTS Hub na próxima página do assistente de configuração.
Chave de serviço de fala	Digite sua chave de serviço de fala. Você pode encontrar esta chave no portal Azure. Preencha este campo somente se tiver habilitado usando o serviço de conversão de texto em fala do Azure.
Região do serviço de fala	Insira o identificador da região para a qual sua chave de serviço de fala foi criada. Preencha este campo somente se tiver habilitado usando o serviço de conversão de texto em fala do Azure.
Nome de voz TTS	Selecione a voz da conversão de texto em fala Permite que os usuários insiram prompts gravados como texto e usem uma voz gerada por computador para falar o conteúdo. na lista suspensa que você quer que este agente virtual Azure use. Preencha este campo somente se tiver habilitado usando o serviço de conversão de texto em fala do Azure.
Mensagem de tempo limite	Digite a mensagem que você quer que o agente virtual Azure use quando um contato expirar. A mensagem padrão é Você ainda está aí?
Padrão de quebra de DTMF	Digite os caracteres que, quando pressionados durante uma chamada, fazem com que o agente virtual atenda o DTMFBreakout ramal do script do Studio. Preencha este campo apenas se for um agente virtual de voz.
Intenção de boas-vindas	Digite o ID da intenção O significado ou propósito por trás do que um contato diz/digita; o que o contato quer comunicar ou alcançar. de boas-vindas do Azure que você quer que este agente virtual use.
Intenção de tempo limite	Digite o ID da intenção do tempo limite do Azure que você quer que o agente virtual use.
Se você quiser LUIS Prediction Intent, use sua própria conta de aplicativo LUIS	Clique no controle deslizante para On se você tiver uma conta de aplicativo LUIS e deseja usar a previsão de intenção O significado ou propósito por trás do que um contato diz/digita; o que o contato quer comunicar ou alcançar. do LUIS com o seu bot Azure. Se você não quiser usar a previsão de intenção do LUIS com este agente virtual Azure, deixe este campo definido como Off. O LUIS faz parte do Serviço Cognitivo do Microsoft Azure para Linguagem e fornece funções de linguagem natural para seus agentes virtuais de conversação. Para obter mais informações, consulte a ajuda on-line para Microsoft Azure Serviço Cognitivo para Linguagem.
ID do aplicativo LUIS	Insira o ID do seu aplicativo LUIS. Este campo é visível apenas se você definir o campo Se você deseja usar a previsão de intenção do LUIS como On,
Chave de previsão LUIS	Digite a chave para o aplicativo LUIS que você está usando com este agente virtual Microsoft Azure. Este campo só é visível se você definir o campo Se você deseja LUIS Prediction Intent como On,
Ponto final de previsão do LUIS	Digite o ponto final para o aplicativo LUIS que você está usando com este bot Microsoft Azure. Este campo é visível apenas se você definir o campo Se você deseja usar a previsão de intenção do LUIS como On,

Configurar o TTS do Azure

Permissões necessárias: Automação e IA > Iniciar Automação e IA

Se você for usar a conversão de texto em fala do Azure com este agente virtual, deverá ter uma conta já configurada no Microsoft.

1. No Virtual Agent Hub, adicione um novo aplicativo de configuração e configure-o de acordo com as etapas descritas em Adicionar um aplicativo ao Virtual Agent Hub nesta página.
2. Clique em Use sua própria conta para invocação de conversão de texto em fala para Ativado para habilitá-la.
3. Digite sua chave de serviço de fala. Você pode encontrar esta chave no portal Azure.
4. Insira o identificador da região para a qual sua chave de serviço de fala foi criada no campo Região do serviço de fala.
5. Selecione a voz e o idioma que você quer que este agente virtual use na lista suspensa Nome de voz TTS.
6. Volte para 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: Automação e IA > Iniciar Automação e IA

Para agentes virtuais Azure, você pode usar o serviço de conversão de texto em fala do Azure ou o CXone Cloud TTS Hub.

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

1. No Virtual Agent Hub, adicione um novo aplicativo de configuração e configure-o de acordo com as etapas descritas na seção Adicionar um aplicativo ao Virtual Agent Hub nesta página.

2. Clique em Avançar na página Configuração.

3. Na página Voz em Opções de integração de voz, selecione a opção para o tipo de conexão de voz que você está usando com seu agente virtual.

   Saiba mais sobre os campos nesta etapa

   campo

   Detalhes

   Opções de Integração de Voz

   Selecione o tipo de integração de voz que você está usando com este agente virtual: Controle turno a turno (CXone Voice Bot Gateway): Selecione esta opção se o seu script controlar cada turno da conversa com o agente virtual. Seu script deve usar ações Voicebot Exchange. Integração SIP (canal de retorno): Selecione esta opção se você estiver usando uma conexão de canal de retorno SIP com seu agente virtual. Entre em contato com o seu Representante de Contas do CXone para obter assistência na configuração. Telefonia personalizada (gRPC, DirectLine Voice, etc.): Selecione esta opção se estiver usando outra opção de telefonia para se conectar ao seu agente virtual. Entre em contato com o seu Representante de Contas do CXone para obter assistência na configuração.

4. Se o formulário não permitir que você selecione Usar CXone Cloud TTS, clique em Voltar para voltar à página Configuração. Clique no controle deslizante Use sua própria conta para invocação de conversão de Texto para fala do Azure para Desativado. Agora você pode agora ativar Cloud TTS Hub na página Voz.

5. Selecione um Fornecedor TTS, se estiver usando o Cloud TTS Hub. Se você estiver usando o serviço TTS do seu provedor de agente virtual, esse campo não ficará visível e você poderá pular esta etapa.

6. Em Opções de transcrição, selecione a opção do serviço de transcrição que deseja usar.

   Saiba mais sobre os campos nesta etapa

   campo

   Detalhes

   Opções de Transcrição

   Selecione o serviço que você deseja usar para a transcrição: Usar transcrição de conta de bot: Selecione isso se quiser usar o serviço de transcrição do seu provedor de agente virtual. O áudio dos enunciados do contato é enviado ao provedor antes de ser transcrito. Usar perfil de transcrição do CXone: Selecione isso se quiser usar um perfil de transcrição do CXone. Você pode saber mais sobre essa opção na página de ajuda do CXone Turn-by-Turn Transcription.

7. Se você optar por usar um perfil de transcrição do CXone, clique em Perfil de transcrição para selecionar aquele que você quer usar. Clique em Adicionar novo perfil de transcrição turno a turno para criar um novo perfil.
8. Clique em Avançar.
9. Volte para a seção Adicionar um aplicativo ao Virtual Agent Hub nesta página para terminar de adicionar o aplicativo de configuração.

Atribuir o aplicativo Microsoft Azure a uma ação

Permissões necessárias: Visualizar, criar/editar scripts do Studio

Quando o aplicativo de agente virtual O significado ou propósito por trás do que um contato diz/digita; o que o contato quer comunicar ou alcançar. está definido e configurado no Virtual Agent Hub, você precisa atribuí-lo às ações 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. Caso ainda não tenha feito isso, clique na guia Ferramentas, expanda a categoria Automação e IA e adicione a ação do agente virtual que deseja usar. Certifique-se de colocá-la no local correto em seu script. Se não vir a ação esperada, verifique se o seu tipo de mídia do script está correto. Por exemplo, se estiver criando um script para um agente virtual de voz, o script deverá ser um script de telefone.

3. Clique duas vezes na ação para abrir o Virtual Agent Hub.

   Ver imagem

   
4. Na coluna da esquerda, localize o agente virtual que você quer atribuir à ação e clique na opção de seleção ao lado dele.
5. Clique em Fechar.

Alterar o perfil de transcrição

Permissões necessárias: Automação e IA > Iniciar Automação e IA

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. No CXone, clique no seletor de aplicativos e selecioneOutra > Automação e IA e clique em Virtual Agent Hub. Você também pode clicar duas vezes na ação do agente virtual no seu script do Studio para iniciar o 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ê quer modificar.
3. No centro da página de propriedades do aplicativo de agente virtual, clique na guia Voz.

4. Em Opções de transcrição, selecione Usar CXone perfil de transcrição se já não estiver selecionado.

5. Selecione o Perfil de transcrição turno a turno que você quer 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 Teste da página de propriedades do aplicativo de agente virtual.

Teste seu bot de agente virtual

Permissões necessárias: Automação e IA > Iniciar Automação e IA

Você pode testar vários aspectos do seu agente virtual para garantir que tudo funcione conforme o esperado. Você pode executar testes na página de propriedades do aplicativo do agente virtual no 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 carga útil personalizada JSON para testar como o agente virtual lida com dados de carga útil personalizada.
• Adicionar um evento de intenção de boas-vindas para testar como o agente virtual inicia uma conversa.
• Acionar 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 DTMF Tons de sinalização gerados quando um usuário pressiona ou toca em uma tecla do teclado do telefone..

A imagem a seguir é um exemplo da página de propriedades de um aplicativo de agente virtual no Virtual Agent Hub. Ela mostra as guias Configuração e Voz e o painel Teste.

1. No CXone, clique no seletor de aplicativos e selecioneOutra > Automação e IA e clique em Virtual Agent Hub. Você também pode clicar duas vezes na ação do agente virtual no seu script do Studio para iniciar o 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 Teste, insira uma mensagem de teste no campo Digite uma mensagem e pressione Enter para enviá-la. Você também pode clicar em Microfone e falar no microfone do seu 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ções para testar outros aspectos do seu agente virtual.

   Saiba mais sobre os campos nesta etapa

   campo	Detalhes
   Adicionar JSON de carga útil personalizada.	Selecione para testar o envio de JSON de carga útil personalizada para seu agente virtual. Insira a carga útil personalizada na caixa de texto Adicionar carga útil personalizada JSON que aparece na página Testar + Adicionar. Pressione Enter após cada linha. Envie uma mensagem de teste quando estiver pronto para testar a carga útil personalizada. Quando terminar de testar a carga útil personalizada, clique em Fechar no painel Adicionar carga útil personalizada JSON.
   Acionar Evento de Intenção de Boas-vindas	Selecione testar a intenção O significado ou propósito por trás do que um contato diz/digita; o que o contato quer comunicar ou alcançar. de boas-vindas padrão. O agente virtual envia a mensagem de boas-vindas. Digite uma mensagem para responder.
   Acionar evento personalizado de intenção.	Selecione para testar um evento personalizado de intenção. Digite o Nome do evento no pop-up que aparece e clique em Acionar. O agente virtual envia a mensagem para a intenção que você inseriu. Envie uma resposta para testar a intenção.
   Acionar Evento de Tempo esgotado	Selecione para visualizar a intenção de tempo limite padrão. O agente virtual envia a mensagem de resposta de tempo limite com a qual está configurado.
   Entrada DTMF	Selecione para testar a resposta do seu agente virtual de voz para tons DTMF Tons de sinalização gerados quando um usuário pressiona ou toca em uma tecla do teclado do telefone.. Digite caracteres DTMF e clique em Entrada para ver a resposta do agente virtual para esses caracteres.

6. Clique em Redefinir para reiniciar o seu teste.

7. Se precisar fazer alterações com base nos resultados de seus testes, 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 no 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 para indicar que o link abre um site externo.
8. Teste o agente virtual após cada alteração nos scripts ou em qualquer configuração.
9. Quando terminar de testar, clique em Fechar.