Configurar Autopilot (Amelia) com Knowledge Hub

Você pode usar NiCE CXone Knowledge Management (Expert) ou uma fonte de conhecimentoClosed Um sistema de gestão do conhecimento que hospeda artigos de conhecimento. de terceiros com seu agente virtual Autopilot (Amelia). A conexão entre Autopilot (Amelia) e sua fonte de conhecimento é gerenciada com NiCE CXone Knowledge Hub.

Antes de iniciar

Configurar a integração de Autopilot (Amelia) e Knowledge Hub envolve duas Chamadas de API de Autopilot (Amelia) para NiCE CXone. Antes de poder configurar e testar essas chamadas, você deve registrar um aplicativo com NiCE. Conclua as seguintes tarefas para se preparar para a integração:

  • Certifique-se de que você tenha uma base de conhecimento Knowledge Hub criada e configurada em seu sistema NiCE CXone. Isso deve ser Concluído pelo seu representante de conta NiCE CXone.

  • Certifique-se de que Autopilot (Amelia) esteja configurado e funcionando antes de iniciar a integração de Knowledge Hub.

  • Conclua as tarefas descritas no guia de introdução para trabalhar com as API do NiCE CXone.

    • O id DO cliente e o secreto devem ser passados na carga útil da solicitação para obter um token. Isso é configurado nas tarefas 2 e 4 do guia de introdução.
    • Integrações com API do NiCE CXone devem consumir o serviço de descoberta. As URLs não devem ser codificadas de forma fixa. Isso é abordado na tarefa 5.
    • Você precisa descobrir a URL base para as Chamadas de API usadas na integração. Isso também é abordado na tarefa 5. A prática recomendada é realizar a chamada de descoberta antes de cada Chamada de API que você fizer. Isso evita que você precise codificar sua URL base de forma fixa. Por exemplo, você poderia desenvolver um Web Service Action que consome a descoberta de API e transmite a URL base.

Definir a Integração

Siga estas etapas para configurar a integração do Autopilot (Amelia) e do Knowledge Hub.

Gerar uma NiCE CXone Acesso Chave

Gere uma chave DE acesso em NiCE CXone. Siga as diretrizes da sua organização para determinar qual perfil de funcionário usar para tokens de acesso. Você pode acessar a chave secreta somente uma vez, portanto, salve-a em um local seguro. Você a usará na próxima etapa.

Criar uma Ação de Serviço Web para gerar um token

Em Autopilot (Amelia), crie uma Web Service Action para gerar um token. Você configurará a Web Service Action com o token de acesso e a chave secreta NiCE CXone que você gerou na tarefa anterior. O token que a Web Service Action gera será usado em Chamadas de API no cabeçalho Authorization: Bearer [access token].

Dê a este Ação de Serviço Web um nome como Knowledge Hub Geração de Token. Use as informações a seguir em Ação de Serviço Web:

  • Solicitação: Defina o Verb como POST e use o seguinte API: [base URL]/auth/token.

    Modifique a URL substituindo [base URL] pela URL base do seu sistema NiCE CXone. Você pode descobrir qual é seguindo as instruções no developer portal Icon of a square with an arrow point from the center through the top right corner. em API Discovery.

  • Cabeçalhos: Adicione o seguinte parâmetro:

    • Chave: Defina como Tipo de conteúdo.
    • Valor: Defina como application/x-www-form-urlencoded).
  • Corpo: Na aba Corpo, cole a seguinte solicitação e configure :

    grant_type=password&username=[accessKeyId]&password=[accessKeySecret]&client_id=[clientId]&client_secret=[clientSecret]

    No pedido, configure os parâmetros desta forma:

    • grant_type: Defina como password.
    • password: Defina isso como a NiCE CXone chave secreta que você gerou na tarefa anterior. Se você perdeu a chave secreta, deverá excluir a chave DE acesso gerada e criar uma nova.

    • username: Defina isso como a NiCE CXone chave DE acesso que você gerou na tarefa anterior.

    • client ID: Defina isso como o id DO cliente que você recebe após registrar o aplicativo com NiCE. Esta é a Tarefa 2 no guia de introdução Icon of a square with an arrow point from the center through the top right corner. no portal do desenvolvedor.

    • client secret: Defina isso como o segredo do cliente que você recebe após registrar o aplicativo com NiCE. Esta é a Tarefa 2 no guia de introdução Icon of a square with an arrow point from the center through the top right corner. no portal do desenvolvedor.

    Um exemplo do corpo é:

    grant_type=password&username=MZXXK3TPO5XW4ZLU&password=K5RWKZ3FNVXW4ZLUNFXG63TPOVXW4ZOVXW633D&client_id=f47ac10b-ab12-4372-cd34-0e02b2c3d479&client_secret=aGVsbG9E9PQaBc123%3D%3D 

Criar uma Ação de Serviço Web para chamar Knowledge Hub

Crie uma segunda Web Service Action em Autopilot (Amelia) para a Chamada de API Knowledge Hub. Dê a ela um nome que mostre que ela é para a integração Knowledge Hub. Por exemplo, Knowledge Hub v4.

Em Solicitação, adicione as seguintes informações em Ação do Web Service:

  • Verb: Selecione POST.
  • URL: [base URL]/eai-real-time-insight/v4/direct-query

    Modifique a URL substituindo [base URL] pela URL base do seu sistema NiCE CXone.

  • Cabeçalhos:

    • Chave: Autorização

      Valor: Bearer [token], em que você substitui [token] pela variável apropriada para armazenar o token gerado pela Web Service Action que você criou na etapa anterior. Por exemplo, ${token}.

    • Chave: Content-Type

      Valor: application/json

  • Corpo: Na guia Corpo, cole a seguinte solicitação:

    Certifique-se de que todos os valores obrigatórios no corpo da solicitação estejam corretos. Pode ser necessário modificar outros valores para personalizar a integração de acordo com as necessidades da sua organização. Você pode saber mais sobre os campos no corpo da solicitação e como completá-los.

Build Fluxos em Autopilot (Amelia)

A etapa final da configuração da integração é construir fluxos que usem Web Service Actions criados.

  1. Em seu console do Autopilot (Amelia), crie um fluxo para gerar um token e conectá-lo à Ação de Serviço Web de geração de token que você criou.

  2. Conecte a Ação de Serviço Web Web Service Action da integração Knowledge Hub que você criou aos fluxos apropriados para adicioná-la às suas conversas de Autopilot (Amelia).

Configuração de resposta do KB

Autopilot (Amelia) fornece respostas com soluções para o problema do contato. Elas são baseadas na base de conhecimentoClosed Um sistema de gestão do conhecimento que hospeda artigos de conhecimento. (KB) da sua organização. Por exemplo, se um contato disser que está tendo problemas com o Produto A, a resposta sugerida poderia ser: "Tente reiniciar o Produto A. Vá até Configurações e clique em Redefinir."

You pode definir uma contagem máxima de palavras para as respostas da KB no corpo da resposta em Autopilot (Amelia). Você também pode configurar as respostas da KB para incluir:

  • Etapas do processo: Divide as respostas da KB em etapas individuais. Autopilot (Amelia)pode enviar uma etapa por vez para orientar o contato durante o processo de solução do problema.

  • Links da Web da KB: fornece links para artigos da KB. Autopilot (Amelia) pode enviar esses links para o contato, que pode abrir os artigos em uma nova guia. Você pode limitar o número de links que podem ser enviados em cada resposta.

  • Imagens da KB: Fornece imagens de artigos da KB. Autopilot (Amelia) pode enviar estas imagens aos contatos. Você pode limitar o número de imagens que podem ser enviadas em cada resposta.

No corpo da resposta, você deve fornecer o ID AWS Bedrock da base de conhecimento que deseja usar. Você pode obter esse ID com o representante da sua conta NiCE CXone.

Campos do Corpo da solicitação

Os seguintes menus suspensos contêm definições dos campos no corpo da solicitação.