Télécharger des fichiers de connaissances personnalisés sur Knowledge Hub

Vous pouvez ajouter des fichiers à une base de connaissances dans Knowledge Hub via l'APIClosed Interface de programmation d’applications. Permet d’automatiser certaines fonctionnalités en connectant votre système CXone Mpower à d’autres logiciels.. Cela vous permet de remplir la base de connaissances avec des fichiers provenant d'une source de connaissancesClosed Un système de gestion des connaissances qui héberge des articles de connaissance.personnalisée. Cela signifie que vous pouvez utiliser Knowledge Hub même si vous n'utilisez pas une source de connaissances prise en charge. Vous pouvez ensuite configurer Copilot for Agents pour utiliser vos fichiers de connaissances personnalisés pour générer du contenu.

Cette méthode est un effort de développeur. Il faut une connaissance des API REST et des capacités de programmation pour envoyer des fichiers à l'aide d'une API.

Veuillez noter :

  • La taille maximale d'un fichier individuel est de 50 Mo.

  • Vous pouvez transférer jusqu'à 100 fichiers à la fois.

Effectuez chacune de ces tâches dans l’ordre indiqué.

Configurer la base de connaissances

Suivez les étapes ci-dessous pour configurer la base de connaissances dans Knowledge Hub afin d’utiliser une source de connaissances personnalisée. Cela génère les identifiants nécessaires pour la base de connaissances que vous devez inclure dans l'appel d'API qui transfère les fichiers.

Si vous n'avez pas encore de base de connaissances, contactez les services professionnels NiCE. Seuls les services professionnels NiCE peuvent créer de nouvelles bases de connaissances.

  1. Dans CXone Mpower, cliquez sur le sélecteur d’application et sélectionnezAdmin > GenAI Manager >Knowledge Hub.

  2. Cliquez sur la base de connaissances à laquelle vous souhaitez ajouter une source de connaissances personnalisée.

  3. Dans la liste déroulante Source de la base de connaissances, sélectionnez Personnalisé.

  4. Cliquez Soumettre.

Obtenir un jeton d'accès

Pour utiliser l'API Knowledge Hub, vous devez inclure un jeton d'accès dans l'en-tête de votre appel. Pour obtenir un jeton d'accès, vous devez échanger certaines informations d'identification fournies par NiCE. Pour ce faire, suivez les instructions de démarrage sur le portail des développeurs. Plus tard, vous devrez inclure ce jeton d’accès dans votre appel API. Cela permet à CXone Mpower de savoir que l'appel n'est pas frauduleux.

Vous pouvez lire plus de détails sur l'authentification et l'autorisation API dans CXone Mpower .

Récupérer les identifiants

Pour transférer des fichiers avec l'API Knowledge Hub, vous devez inclure deux identifiants :

  • Data Source ID : chaîne d’ID unique pour la source de connaissances personnalisée. Cela indique à l'API d'où extraire le contenu.

  • Knowledge Hub ID : chaîne d'identification unique pour la base de connaissances que vous avez configurée. Cela indique à l'API où envoyer le contenu.

Vous pouvez obtenir les deux en appelant l'API GET /knowledgehub :

  1. Appelez l'API https://api-na1.niceincontact.com/eai-knowledge-hub-services/config/v1/knowledgehub . Vous devrez peut-être remplacer na1 dans cette URL ; il devrait correspondre à ce qui précède nice-incontact.com dans votre URL CXone Mpower. Assurez-vous d'inclure votre jeton d'accès.

    
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. Dans la réponse, recherchez le Knowledge Hub ID dans l'attribut id du tableau knowledgeBases.

    L'attribut id en haut du tableau knowledgeBases est mis en surbrillance. Sa valeur est une longue chaîne alphanumérique.

  3. Trouvez le data source ID dans l'attribut id du tableau dataSources.

    L'attribut id en haut du tableau dataSources est mis en surbrillance. Sa valeur est une longue chaîne alphanumérique.

Envoyer des fichiers avec l'API Knowledge Hub

Vous pouvez envoyer jusqu'à 100 fichiers vers Knowledge Hubà la fois. La taille maximale par fichier est de 50 Mo.

Créez un script qui utilise le POST /documents API pour pousser les fichiers vers Knowledge Hub. Vous pouvez écrire ce script dans le langage de votre choix, comme Python, C# ou Java. Vous pouvez utiliser cet exemple de script Python comme modèle. Configurez le script pour qu'il s'exécute automatiquement selon un calendrier afin de mettre à jour Knowledge Hub avec le contenu le plus récent de votre source de connaissances personnalisée.

Entrez les ID que vous avez récupérés à l'étape précédente en tant que paramètres de chaîne dans le corps de la requête de l'appel. POST /documents API

  1. Connectez-vous à la communauté de développeurs DEVone en utilisant vos identifiants CXone Mpower.

  2. Allez à la page POST /documents .

  3. Cliquez sur Try it out.

  4. Modifiez ces valeurs dans le tableau des documents :

    1. Dans clientToken, entrez le jeton d'accès que vous avez reçu lors de l'authentification .

    2. Dans dataSourceId, entrez votre data source ID.

    3. Dans knowledgeHubId, entrez votre Knowledge Hub ID.

  5. Copiez le JSON configuré dans votre script.

Vos connaissances personnalisées sont ensuite envoyées à Knowledge Hub. Knowledge Hub l'ingère et l'analyse pour une utilisation LLMClosed Grand modèle de langue. Type d’IA qui traite, comprend et génère du langage humain en fonction du contexte.. Il s'affiche comme une source de connaissances sous la base de connaissances que vous avez configurée.