Upload aangepaste kennisbestanden naar Knowledge Hub

U kunt bestanden toevoegen aan een kennisbank in Knowledge Hub via de APIGesloten Application Programming Interface. Hiermee kunt u bepaalde functies automatiseren door uw CXone Mpower-systeem te koppelen aan andere software.. Hiermee kunt u de kennisbank vullen met bestanden uit een aangepaste kennisbronGesloten Een kennisbeheersysteem dat als host optreedt voor kennisartikelen.. Dit betekent dat u Knowledge Hub kunt gebruiken, zelfs als u geen ondersteunde kennisbrongebruikt. Vervolgens kunt u Copilot for Agents configureren om uw aangepaste kennisbestanden te gebruiken om inhoud te genereren.

Deze methode is een project van de ontwikkelaars. Om bestanden via een API te versturen, hebt u kennis van REST API's en programmeervaardigheden nodig.

Let op:

  • De maximale bestandsgrootte van een afzonderlijk bestand is 50 MB.

  • U kunt maximaal 100 bestanden tegelijk overzetten.

Voer de onderstaande taken in de aangegeven volgorde uit.

Configureer de kennisbank

Volg de onderstaande stappen om de kennisbank in Knowledge Hub te configureren voor het gebruik van een aangepaste kennisbron. Hiermee worden de benodigde ID's voor de kennisbank gegenereerd die u moet opnemen in de API-aanroep waarmee bestanden worden overgedragen.

Als u nog geen kennisbank heeft, neem dan contact op met NiCE Professional Services. Alleen NiCE Professional Services kunnen nieuwe kennisbanken creëren.

  1. Klik in CXone Mpower op de app-kiezer en selecteerAdmin > GenAI Manager >Knowledge Hub.

  2. Klik op de kennisbank waaraan u een aangepaste kennisbron wilt toevoegen.

  3. Selecteer in de vervolgkeuzelijst Bron kennisbank de optie Aangepast.

  4. Klik op Verzenden.

Ontvang een toegangstoken

Om de Knowledge Hub API te gebruiken, moet u een toegangstoken in de header van uw aanroep opnemen. Om een toegangstoken te krijgen, moet u bepaalde inloggegevens uitwisselen die u van NiCEheeft gekregen. Volg hiervoor de aan de slag-instructies op de ontwikkelaarsportal. Later moet u dit toegangstoken opnemen in uw API-aanroep. Hiermee wordt CXone Mpower duidelijk gemaakt dat het gesprek niet frauduleus is.

Meer informatie over API-authenticatie en -autorisatie vindt u in CXone Mpower .

ID's ophalen

Om bestanden met de Knowledge Hub API over te dragen, moet u twee ID's opgeven:

  • Data Source ID: Unieke ID-reeks voor de aangepaste kennisbron. Hiermee wordt aan de API doorgegeven waar de inhoud vandaan moet worden gehaald.

  • Knowledge Hub ID: Unieke ID-reeks voor de kennisbank die u hebt geconfigureerd. Hiermee wordt aan de API doorgegeven waar de content naartoe moet worden gepusht.

U kunt beide verkrijgen door de GET /knowledgehub API aan te roepen:

  1. Roep de https://api-na1.niceincontact.com/eai-knowledge-hub-services/config/v1/knowledgehub API aan. Mogelijk moet u na1 in die URL vervangen; dit moet overeenkomen met wat er vóór nice-incontact.com komt in uw CXone Mpower-URL. Vergeet niet uw toegangstoken mee te sturen.

    
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. Zoek in het antwoord de Knowledge Hub ID in het id-kenmerk van de knowledgeBases-array.

    Het id-kenmerk bovenaan de knowledgeBases-array is gemarkeerd. De waarde is een lange alfanumerieke tekenreeks.

  3. Zoek de data source ID in het id-kenmerk van de dataSources-array.

    Het id-kenmerk bovenaan de dataSources-array is gemarkeerd. De waarde is een lange alfanumerieke tekenreeks.

Push-bestanden met de Knowledge Hub API

U kunt maximaal 100 bestanden tegelijk naar Knowledge Hubpushen. De maximale grootte per bestand is 50 MB.

Maak een script dat de POST /documents API gebruikt om bestanden naar Knowledge Hubte pushen. U kunt dit script schrijven in de taal van uw keuze, bijvoorbeeld Python, C# of Java. U kunt dit voorbeeld-Python-script als sjabloon gebruiken. Stel het script zo in dat het automatisch volgens een schema wordt uitgevoerd om Knowledge Hub bij te werken met de nieuwste inhoud in uw aangepaste kennisbron.

Voer de ID's die u in de vorige stap hebt opgehaald als tekenreeksparameters in de aanvraagtekst van de POST /documents API aanroep.

  1. Meld u aan bij de DEVone Developer Community met uw CXone Mpower-inloggegevens.

  2. Navigeer naar de pagina voor POST /documents .

  3. Klik op Try it out.

  4. Bewerk deze waarden in de documentenarray:

    1. Voer in clientTokenhet toegangstoken in dat u tijdens de authenticatiehebt ontvangen.

    2. Voer in dataSourceIduw data source IDin.

    3. Voer in knowledgeHubIduw Knowledge Hub IDin.

  5. Kopieer de geconfigureerde JSON naar uw script.

Uw aangepaste kennis wordt vervolgens naar Knowledge Hubverzonden. Knowledge Hub neemt het op en parseert het voor LLMGesloten Groot taalmodel Een type AI die menselijke taal verwerkt, begrijpt en genereert op basis van context.-gebruik. Het wordt weergegeven als een kennisbron onder de kennisbank die u hebt geconfigureerd.