Subir archivos de conocimiento personalizados a Knowledge Hub

Puede agregar archivos a una base de conocimiento en Knowledge Hub a través de la APICerrado Interfaz de programación de la aplicación. Permite automatizar determinadas funciones conectando su sistema CXone Mpower con otro software.. Esto le permite completar la base de conocimientos con archivos de una fuente de conocimientoCerrado Un sistema de gestión del conocimiento que aloja artículos de conocimiento.personalizada. Esto significa que puedes usar Knowledge Hub incluso si no utilizas una fuente de conocimiento compatible. Luego puede configurar Copilot for Agents para utilizar sus archivos de conocimiento personalizados para generar contenido.

Este método es un esfuerzo del desarrollador. Se requieren conocimientos de API REST y capacidad de programación para enviar archivos mediante una API.

Tenga en cuenta:

  • El tamaño máximo de un archivo individual es de 50 MB.

  • Puede transferir hasta 100 archivos a la vez.

Complete cada una de estas tareas en el orden dado.

Configurar la base de conocimientos

Siga los pasos a continuación para configurar la base de conocimiento en Knowledge Hub para utilizar una fuente de conocimiento personalizada. Esto genera los ID necesarios para la base de conocimiento que debe incluir en la llamada API que transfiere archivos.

Si aún no dispone de una base de conocimientos, póngase en contacto con NiCE Servicios Profesionales. Sólo NiCE Servicios Profesionales pueden crear nuevas bases de conocimiento.

  1. En CXone Mpower, haga clic en el selector de aplicaciones y seleccioneAdmin > GenAI Manager >Knowledge Hub.

  2. Haga clic en la base de conocimiento a la que desea agregar una fuente de conocimiento personalizada.

  3. En el menú desplegable Fuente de la base de conocimientos, seleccione Personalizado.

  4. Haga clic en Enviar.

Obtenga un token de acceso

Para utilizar la API Knowledge Hub, debe incluir un token de acceso en el encabezado de su llamada. Para obtener un token de acceso, debes intercambiar ciertas credenciales proporcionadas por NiCE. Siga las instrucciones de introducción en el portal para desarrolladores para hacerlo. Más adelante, deberás incluir este token de acceso en tu llamada API. Le permite a CXone Mpower saber que la llamada no es fraudulenta.

Puede leer más detalles sobre la autenticación y autorización de API en CXone Mpower .

Obtener identificaciones

Para transferir archivos con la API Knowledge Hub, debe incluir dos ID:

  • Data Source ID: Cadena de identificación única para la fuente de conocimiento personalizada. Esto le dice a la API de dónde extraer el contenido.

  • Knowledge Hub ID: Cadena de identificación única para la base de conocimiento que configuró. Esto le dice a la API dónde enviar el contenido.

Puedes obtener ambos llamando a la API GET /knowledgehub:

  1. Llame a la API https://api-na1.niceincontact.com/eai-knowledge-hub-services/config/v1/knowledgehub . Es posible que tengas que reemplazar na1 en esa URL; debe coincidir con lo que viene antes de nice-incontact.com en tu URL CXone Mpower. Asegúrese de incluir su token de acceso.

    
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. En la respuesta, busque Knowledge Hub ID en el atributo id de la matriz knowledgeBases.

    El atributo id en la parte superior de la matriz knowledgeBases está resaltado. Su valor es una cadena alfanumérica larga.

  3. Busque el data source ID en el atributo id de la matriz dataSources.

    El atributo id en la parte superior de la matriz dataSources está resaltado. Su valor es una cadena alfanumérica larga.

Enviar archivos con la API Knowledge Hub

Puede enviar hasta 100 archivos a Knowledge Huba la vez. El tamaño máximo por archivo es 50 MB.

Crea un script que use POST /documents API para enviar archivos a Knowledge Hub. Puedes escribir este script en el lenguaje que elijas, como Python, C# o Java. Puede utilizar este script de Python de muestra como plantilla. Configure el script para que se ejecute automáticamente según una programación para actualizar Knowledge Hub con el contenido más reciente en su fuente de conocimiento personalizada.

Introduzca los ID que obtuvo en el paso anterior como parámetros de cadena en el cuerpo de la solicitud de la POST /documents API llamada.

  1. Inicie sesión en la DEVone Comunidad de desarrolladores usando sus CXone Mpower credenciales.

  2. Vaya a la página de POST /documents .

  3. Hacer clic en Try it out.

  4. Edite estos valores en la matriz de documentos:

    1. En clientToken, ingrese el token de acceso que recibió durante la autenticación.

    2. En dataSourceId, ingrese su data source ID.

    3. En knowledgeHubId, ingrese su Knowledge Hub ID.

  5. Copie el JSON configurado en su script.

Posteriormente, su conocimiento personalizado se envía a Knowledge Hub. Knowledge Hub lo ingiere y lo analiza para su uso en LLMCerrado Modelo lingüístico amplio. Tipo de IA que procesa, comprende y genera el lenguaje humano basándose en el contexto.. Se muestra como una fuente de conocimiento bajo la base de conocimiento que usted configuró.