Configurar um AI Agents (Cognigy) Text Bot em Virtual Agent Hub
Use esta página para conectar um bot de texto AI Agents (Cognigy) a NiCE CXone por meio de Virtual Agent Hub. Quando você concluir este procedimento, NiCE CXone roteará as mensagens do cliente de um canal digital por meio de Studio e Virtual Agent Hub para o seu bot AI Agents (Cognigy), e retornará as respostas do bot para o contato. Essa integração oferece suporte a digital channels baseadas em texto, incluindo chat digital, WhatsApp, Apple Messages for Business, Facebook Messenger e SMS Messaging.
Esta página aborda somente integrações de bot de texto. Integrações de bot de Voz usam um método de backchannel SIP separado e exigem a assistência do representante de conta NiCE CXone. Não use este procedimento para configurar um bot de voz.
Como funciona a Integração do Text Bot
Quando um contato envia uma mensagem por meio de um canal digital, o NiCE CXone roteia a interação para um script do Studio. O script usa a TextBotExchange ação para encaminhar a mensagem ao AI Agents (Cognigy) por meio de Virtual Agent Hub. O AI Agents (Cognigy) processa a mensagem, identifica a intenção do contato e retorna uma resposta e um sinal de controle. O script então entrega a resposta ao contato ou age de acordo com o sinal de controle.
Fluxo de mensagem
A sequência a seguir descreve o fluxo de mensagens para cada turno em uma conversa com bot de texto:
-
O contato envia uma mensagem por meio de um canal digital.
-
O canal digital invoca a AskCaller ação para passar a mensagem para o script Studio.
-
O script Studio encaminha a mensagem para a ação TextBotExchange.
-
A ação TextBotExchange envia a mensagem para AI Agents (Cognigy) por meio do Virtual Agent Hub.
-
AI Agents (Cognigy) processa a mensagem e gera uma resposta.
-
O Virtual Agent Hub entrega a resposta e o sinal de controle de AI Agents (Cognigy) para a TextBotExchange ação.
-
A TextBotExchange ação passa a resposta e o sinal de controle para o script Studio.
-
O script Studio avalia o sinal de controle e determina a ramificação apropriada.
-
Se a conversa continuar: o script Studio retorna à AskCaller ação, vá para a etapa 9.
-
Se a tarefa estiver concluída ou se a escalação for necessária: O script Studio sai do loop do bot e continua com a próxima ação no script.
-
-
A AskCaller ação entrega a resposta ao contato por meio do canal digital e aguarda a próxima mensagem. O fluxo se repete a partir da etapa 1.
Isso se aplica somente à agência OnPromptAndCollectNextResponse.
Sinais de Controle Retornados por AI Agents (Cognigy)
Após cada turno, AI Agents (Cognigy) retorna um dos seguintes sinais de controle para a TextBotExchange ação. Seu script Studio deve lidar com cada sinal:
-
PromptAndCollectNextResponse: A conversa deve continuar. O script retorna à ação AskCaller para aguardar a próxima mensagem do contato.
-
OnReturnControlToScript: O agente virtual concluiu sua tarefa ou determinou que é necessário um agente ativo. O controle retorna ao script Studio. AI Agents (Cognigy) passa dados de escalação através docustomPayload, e o script do Studio os lê para determinar a próxima ação de roteamento. A prática recomendada é usar uma intenção de escalação que comece com escalat, para que o script possa detectar de forma confiável a escalação em diferentes nomes de intenção do bot, como "escalate" ou "escalation".
-
OnError: ocorreu um erro inesperado. O script segue o caminho de tratamento de erros. Verifique a variável _ERR e a propriedade de saída errorDetailsVarName para obter detalhes.
Pré-requisitos
Verifique se todos os pré-requisitos foram atendidos antes de iniciar este procedimento. Pré-requisitos ausentes são a causa mais comum de falhas de integração.
Requisitos do NiCE CXone
-
Virtual Agent Hub habilitado para sua unidade de negócios ou locatário. Contate seu TAM se Virtual Agent Hub não estiver disponível em seu sistema.
-
AI Agents (Cognigy) deve estar habilitado para o seu locatário NiCE CXone. Esse aplicativo é habilitado por um TAM ou pelos Serviços Profissionais. Se a opção AI Agents (Cognigy) não aparecer no menu do aplicativo, verifique se as funções e permissões apropriadas foram atribuídas. Se as permissões necessárias não estiverem disponíveis, isso significa que sua organização não está configurada para usar o AI Agents (Cognigy); nesse caso, entre em contato com seu TAM.
-
Visualizar, criar e editar Scripts - necessário para criar e modificar scripts do Studio.
-
Um canal digital configurado no CXone Digital Experience (DX). digital channels baseados em texto suportados, incluindo chat digital, WhatsApp, Apple Messages for Business, Facebook Messenger e SMS Messaging.
-
Um script do Studio configurado para um tipo DE mídia digital (ou permissão para criar um). Os tipos de script de Voz não oferecem suporte à ação TextBotExchange.
Requisitos do AI Agents (Cognigy)
-
Um projeto AI Agents (Cognigy) com um Fluxo totalmente configurado, treinado e pronto para implantação. A prática recomendada é que o Fluxo inclua respostas para, no mínimo, a intenção DE boas vindas e uma intenção DE tempo limite.
-
Permissão de edição em NiCE CXone para AI Agents (Cognigy) (mapeia para a função de Admin em AI Agents (Cognigy)), ou permissões AI Agents (Cognigy) suficientes para criar e gerenciar Endpoints.
-
Um entendimento do nome do projeto AI Agents (Cognigy) e do Fluxo que você deseja usar.
Configure a Integração AI Agents (Cognigy) Text Bot
Complete the following tasks in order. Each task depends on the results of the previous task.