Carregar arquivos de conhecimento personalizados para Knowledge Hub

Você pode adicionar arquivos a uma base de conhecimento no Knowledge Hub por meio de APIFechado Interface de programação de aplicativo. Permite automatizar certas funcionalidades conectando seu sistema CXone Mpower a outro software.. Isso permite que você preencha a base de conhecimento com arquivos de uma fonte de conhecimentoFechado Um sistema de gerenciamento de conhecimento que hospeda artigos de conhecimento.personalizada. Isso significa que você pode usar Knowledge Hub mesmo que não use uma fonte de conhecimento suportada. Em seguida, você pode configurar Copilot for Agents para usar seus arquivos de conhecimento personalizados para gerar conteúdo.

Esse método é um esforço do desenvolvedor. Requer conhecimento de APIs REST e capacidade de programação para enviar arquivos usando uma API.

Observação:

  • O tamanho máximo de um arquivo individual é de 50 MB.

  • Você pode transferir até 100 arquivos por vez.

Complete cada uma dessas tarefas na ordem indicada.

Configurar a base de conhecimento

Siga as etapas abaixo para configurar a base de dados de conhecimento no Knowledge Hub usar uma fonte de conhecimento personalizada. Isso gera os IDs necessários para a base de conhecimento que você deve incluir na chamada de API que transfere arquivos.

Se você ainda não tiver uma base de conhecimento, entre em contato com NiCE Professional Services. Somente NiCE Professional Services podem criar novas bases de dados de conhecimento.

  1. No CXone Mpower, clique no seletor de aplicativos e selecioneAdmin > GenAI Manager >Knowledge Hub.

  2. Clique na base de conhecimento à qual você deseja adicionar uma fonte de conhecimento personalizada.

  3. Na lista suspensa Fonte da base de conhecimento selecione Personalizado.

  4. Clique Enviar.

Obter um token de acesso

Para usar o API Knowledge Hub, você deve incluir um token de acesso no cabeçalho da chamada. Para obter um token de acesso, você deve trocar determinadas credenciais fornecidas pelo NiCE. Siga as instruções de introdução no portal do desenvolvedor para fazer isso. Posteriormente, você deve incluir esse token de acesso em sua chamada de API. Isso permite que CXone Mpower saiba que a chamada não é fraudulenta.

Você pode ler mais detalhes sobre API autenticação e autorização em CXone Mpower .

Buscar IDs

Para transferir arquivos com o API Knowledge Hub, você deve incluir dois IDs:

  • Data Source ID: ID exclusivo string para a fonte de conhecimento personalizada. Isso informa à API de onde extrair o conteúdo.

  • Knowledge Hub ID: ID exclusivo string para a base de conhecimento que você configurou. Isso informa à API para onde enviar o conteúdo.

Você pode obter ambos chamando o GET /knowledgehub API:

  1. Ligue para o https://api-na1.niceincontact.com/eai-knowledge-hub-services/config/v1/knowledgehub API. Pode ser necessário substituir na1 nesse URL; Deve corresponder ao que vem antes nice-incontact.com em seu CXone Mpower URL. Certifique-se de incluir seu token de acesso.

    
curl --location 'https://api.na1.niceincontact.com/eai-knowledge-hub-services/config/v1/knowledgehub' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer [CXone token]'

  2. Na resposta, localize o Knowledge Hub ID no atributo id da matriz knowledgeBases.

    O atributo id na parte superior da matriz knowledgeBases é realçado. Seu valor é uma string alfanumérica longa.

  3. Localize o data source ID no atributo id da matriz dataSources.

    O atributo id na parte superior da matriz dataSources é realçado. Seu valor é uma string alfanumérica longa.

Envie arquivos com o Knowledge Hub API

Você pode enviar até 100 arquivos para Knowledge Hubpor vez. O tamanho máximo por arquivo é de 50 MB.

Crie um script que use o POST /documents API para enviar arquivos para Knowledge Hub. Você pode escrever esse script na linguagem de sua escolha, como Python, C# ou Java. Você pode usar este exemplo de script Python como modelo. Configure o script para ser executado automaticamente de acordo com uma programação para atualizar Knowledge Hub com o conteúdo mais recente em sua fonte de conhecimento personalizada.

Insira os IDs que você buscou na etapa anterior como parâmetros de string no corpo da solicitação da chamada POST /documents API.

  1. Entrar para a Comunidade de Desenvolvedores DEVone usando suas credenciais CXone Mpower.

  2. Navegue até a página para POST /documents .

  3. Clique em Try it out.

  4. Edite estes valores na matriz de documentos:

    1. Em clientToken, digite o token de acesso que você recebeu durante a autenticação.

    2. Em dataSourceId, digite seu data source ID.

    3. Em knowledgeHubId, digite seu Knowledge Hub ID.

  5. Copie o JSON configurado para o seu script.

Seu conhecimento personalizado é então enviado para Knowledge Hub. Knowledge Hub ingere e analisa para uso LLMFechado Modelo de linguagem grande. Um tipo de IA que processa, entende e gera linguagem humana com base no contexto.. Ele é exibido como uma fonte de conhecimento na base de dados de conhecimento que você configurado.