0 / 0
Go back to the English version of the documentation
Pierwsze kroki z Knowledge Accelerators
Last updated: 27 lip 2023
Jak zaimportować Knowledge Accelerators do Watson Knowledge Catalog

Komponenty Knowledge Accelerators muszą być najpierw załadowane do Watson Knowledge Catalog , zanim będą mogły zostać dostosowane.

Administrator projektu może zaimportować Knowledge Accelerators do Watson Knowledge Catalog przy użyciu punktów końcowych interfejsu REST API udostępnianych jako część treści i można je wywoływać za pomocą interfejsu użytkownika Knowledge Accelerators OpenAPI .

Wykres 1. Interfejs użytkownika interfejsów REST API Knowledge Accelerators
Obraz przedstawiający interfejs użytkownika interfejsu REST API Knowledge Accelerators .

Szybki start

W poniższej tabeli przedstawiono główne kroki importowania artefaktu Knowledge Accelerators .

Krok Działanie lub punkt końcowy interfejsu API Więcej szczegółów
Interfejs użytkownika KA OpenAPI Dodaj
v1/knowledge_accelerators/api/explorer/
na adres URL IBM Cloud Pak for Data		 Uzyskiwanie dostępu do punktów końcowych Knowledge Accelerators OpenAPI
Uwierzytelnij

Wygeneruj znacznik IBM Cloud IAM za pomocą klucza API. Patrz https://cloud.ibm.com/docs/account? topic = account-iamtoken_from_apikey.

 Uwierzytelnianie i autoryzowanie
Importuj POST
/v1/knowledge_accelerators/{ka_id}
/import_items
 Importowanie Knowledge Accelerators
Status importu GET
/v3/governance_artifact_types/
import/status/{process_id}
 Sprawdzanie statusu zadania importowania

Obejrzyj film wideo opisujący sposób importowania Knowledge Accelerators.

Ten film wideo udostępnia metodę wizualną jako alternatywę dla poniższych kroków opisowych w tej dokumentacji.

Zastrzeżenie wideo: Niektóre drobne kroki i elementy graficzne w tym filmie wideo mogą się różnić w zależności od wdrożenia Cloud Pak for Data .

Szczegółowe instrukcje importu i inne przydatne punkty końcowe interfejsu API

  • Knowledge Accelerators są dostępne do zaimportowania do programu Watson Knowledge Catalog, do użytkowników IBM Cloud Pak for Data z następującymi planami i uprawnieniami użytkowników.

    Plan oferty
    Produkt Knowledge Accelerators można dodać do środowiska zarządzania, jeśli jest on używany w planie przedsiębiorstwa IBM Cloud Pak for Data . Więcej informacji na temat planu przedsiębiorstwa zawiera sekcja Plany usług Watson Knowledge Catalog.
    wymagane uprawnienia
    Aby zaimportować Knowledge Accelerators, należy mieć uprawnienie użytkownika :
    • Zarządzaj kategoriami zarządzania
    • Zaloguj się do galerii Cloud Pak for Data as a Service https://dataplatform.cloud.ibm.com/gallery.
    • Wybierz opcję Filtr > Znaczniki > Knowledge Accelerators.
    • Otwórz kafel galerii dla konkretnej branży Knowledge Accelerators .
  • Punkty końcowe interfejsu API usług REST dla instancji programu IBM Cloud Pak for Data można znaleźć, dodając v1/knowledge_accelerators/api/explorer/ do adresu URL IBM Cloud Pak for Data .
    Na przykład
    • https://api.dataplatform.cloud.ibm.com staje się https://api.dataplatform.cloud.ibm.com/v1/knowledge_accelerators/api/explorer/
    Wskazówka: Opisy punktów końcowych interfejsu API dla opcji Knowledge Accelerators można znaleźć pod adresem https://cloud.ibm.com/apidocs/watson-data-api#getknowledgeaccelerators.

  • Istnieją dwie główne opcje, które należy wziąć pod uwagę podczas planowania importowania treści Knowledge Accelerators .

    Importowanie wyboru zasięgów biznesowych
    Wybór aplikacji Knowledge Accelerator Business Scopes jest dostępny do zaimportowania oddzielnie, na przykład Data Privacy i inne zasięgi specyficzne dla branży. Jeśli dla obszaru, który Cię interesuje, istnieje co najmniej jeden z tych zasięgów biznesowych, a użytkownik woli rozpocząć od stosunkowo niewielkiej liczby warunków biznesowych, na przykład od 200 do 500 terminów, to można zainstalować jeden lub więcej z tych osobnych zasięgów.
    Importowanie niektórych lub wszystkich słowników aplikacji Knowledge Accelerator
    Słowniki Knowledge Accelerators istnieją dla każdej z czterech branż i zawierają kompletny słownik biznesowy, słowniki branżowe i wszystkie zasięgi biznesowe. Można wybrać import wszystkich lub wybór tych słowników. Jeśli istnieje potrzeba zaimportowania obszernego zestawu warunków biznesowych, aby zająć się rozpiętą branżą, na przykład 5.000 do 20 000 terminów, należy wybrać tę opcję.
    Szczegółową listę wszystkich dostępnych pozycji dla każdej branży, w tym definicję, identyfikatory i więcej informacji, można znaleźć w poniższych linkach.
  • Aby sprawdzić, które Knowledge Accelerators są dostępne do zaimportowania, należy wywołać punkt końcowy interfejsu API GET /v1/knowledge_accelerators Get all Knowledge Accelerators .
    1. Wybierz opcję GET /v1/knowledge_accelerators i kliknij opcję Try it out(Wypróbuj ją).
    2. Kliknij przycisk Wykonaj.
    Przykład odpowiedzi:
    {
  "liczba": 6,
  "knowledge_accelerators": [
    {
      "id": "kahc20",
      "name": "Knowledge Accelerator for Healthcare",
      "definicja": "IBM Knowledge Accelerator for Healthcare
      Materiały licencjonowane-własność IBM 
      © Copyright IBM Corp. 2020, 2023. Wszelkie prawa zastrzeżone. 
      Documentation dla tej oferty https://www.ibm.com/docs/SSQNUZ_4.7.x/ka/ka-cpd.HTML 
      Uwagi dotyczące tej oferty https://www.ibm.com/docs/SSQNUZ_4.7.x/ka/notices.html ",
      "type": "akcelerator wiedzy",
      "format": "słownik_wkc_glosariusz",
      "version": " .....
      …....
  • Aby sprawdzić, które opcje Knowledge Accelerators są dostępne do zaimportowania, należy wywołać punkt końcowy interfejsu API GET /v1/knowledge_accelerators/{id} Pobierz konkretny akcelerator wiedzy .
    1. Wybierz opcję GET /v1/knowledge_accelerators/{id} i kliknij opcję Try it out(Wypróbuj ją).
    2. Wprowadź wartość id dla branży aplikacji Knowledge Accelerator. Poprawne wartości znajdują się w poniższej tabeli.
      Różne branże Energia i media Usługi finansowe Służba zdrowia Zarządzanie 
      kaci20
      		 
      kaeu20
      		 
      kafs20
      		 
      kahc20
      		 
      kain20
    3. Kliknij przycisk Wykonaj.
    Przykład odpowiedzi:
    {
  "id": "kafs20",
  "name": "Knowledge Accelerators",
  "definicja": " Kategoria, która grupuje artefakty zarządzania, które są używane w 
Knowledge Accelerators.
Materiały licencjonowane-własność IBM 
© Copyright IBM Corp. 2020, 2023. Wszelkie prawa zastrzeżone.
Documentation dla tej oferty https://www.ibm.com/docs/SSQNUZ_4.7.x/ka/ka-cpd.html
Uwagi dotyczące tej oferty https://www.ibm.com/docs/SSQNUZ_4.7.x/ka/notices.html",
  "type": "akcelerator wiedzy", .....
      …....
  • Aby sprawdzić, czy dowolna Knowledge Accelerators są importowane do instancji Watson Knowledge Catalog, należy wywołać metodę GET/v1/knowledge_accelerators/import_items Get what Knowledge Accelerator items are currently imported into glossary (Pobierz elementy akceleratora wiedzy są obecnie importowane do glosariusza) API.
    1. Wybierz opcję GET /v1/knowledge_accelerators/import_items i kliknij opcję Try it out(Wypróbuj ją).
    2. Kliknij przycisk Wykonaj.
    Przykład odpowiedzi:
    {
  "message": "KA008I: Następujące elementy akceleratora wiedzy są importowane",
  "import_evaluation": [
    {
      "knowledge_accelerator": "CPD_URL/v1/knowledge_accelerators/kaci20",
      "pozycje": [
        {
          "id": "dane personalne",
          "evaluation": "imported_at_undeterminable_version",
          "latest_version": "2.0.2023XX"

  • Aby zaimportować elementy Knowledge Accelerators do instancji produktu Watson Knowledge Catalog, należy wywołać metodę POST /v1/knowledge_accelerators/{ka_id}/import_items Importuj określone elementy aplikacji Knowledge Accelerator do punktu końcowego interfejsu API glosariusza .

    1. Wybierz elementy, które chcesz zainstalować. Więcej informacji na ten temat zawiera sekcja Sprawdzanie, które elementy są dostępne do zaimportowania i Sprawdzanie, które elementy są dostępne do zaimportowania dla poszczególnych branż.
      Wskazówka: Dla każdej branży dostępna jest opcja importowania konkretnych zasięgów biznesowych lub pełnego słownika Business Core Vocabulary oraz opcjonalnych branżowych słowników wyrównywania. Szczegółową listę wszystkich dostępnych pozycji, w tym definicję, identyfikatory i więcej informacji, można znaleźć w poniższych odsyłaczach.
    2. Wybierz opcję POST /v1/knowledge_accelerators/{ka_id}/import_items i kliknij opcję Wypróbuj ją.
    3. Wprowadź wartości dla następujących parametrów.
      Na przykład:
      Parametr Opis Przykład
      id_ka_id Identyfikator dla branży kafs20
      Identyfikatory Identyfikator dla jednego lub większej liczby pozycji w akceleratorze wiedzy, które mają zostać zaimportowane, rozdzielając je przecinkami. Należy pamiętać, że można zaimportować tylko jeden zasięg naraz. core-bpi,ccpa,fhir, gdpr
      opcja_merge_option Opcja scalania, która ma być używana podczas importowania do produktu Watson Knowledge Catalog. all
      zależności Wskazuje, które zależności identyfikatorów elementów powinny być również importowane. mandatory
      do_import
      • Wybierz opcję false , aby sprawdzić parametry i dowiedzieć się, jakie informacje zostaną zaimportowane.
      • Wybierz opcję true , aby zaimportować.
      		 false
    4. Kliknij przycisk Wykonaj.
    5. W odpowiedzi należy zwrócić uwagę na "process_id", ponieważ można to wykorzystać do sprawdzenia statusu zadania importowania w następnej sekcji Sprawdzanie statusu zadania importowania. To sprawdzenie może być konieczne lub pożądane, ponieważ czasami importowanie może zająć trochę czasu, w zależności od liczby i wielkości zaimportowanych elementów.
    Uwaga:
    • W przypadku importowania wielu zasięgów biznesowych KA niektóre relacje ze współużytkowanych artefaktów, takie jak strategie i reguły, do terminów słownikowych, mogą zostać nadpisane przez kolejne importowanie zasięgu biznesowego.
    • W przypadku importowania Knowledge Accelerators dla wielu branż relacje ze współużytkowanych artefaktów, takich jak strategie i reguły do terminów słownikowych, nie mogą być scalane w celu późniejszego importowania-odwzorowania z początkowo zaimportowanych artefaktów KA są zachowywane. Niektóre komunikaty (GIM00010E lub GIM00015E) mogą być wyświetlane w dzienniku importowania odnoszący się do zasad strategii i reguł zarządzania, które można zignorować.
  • Aby sprawdzić status importu, wywołaj punkt końcowy interfejsu API GET/v3/governance_artifact_types/import/status/{process_id} , gdzie {process_id} jest wartością z sekcji Importowanie Knowledge Accelerators.

    Status importu pozostanie "IN_PROGRESS" , dopóki wszystkie artefakty nie zostaną zaimportowane.

    Przykłady odpowiedzi:
    • "IN_PROGRESS": Importowanie jest w toku i pokazuje, jaki numer kroku jest w toku, z łącznej liczby kroków.
      ..."status": "IN_PROGRESS",
....
    "step_number": 32,
    "total_steps": 50,.....
    • "SUCCEEDED": Odpowiedź pokazuje, ile artefaktów zostało utworzonych lub zmodyfikowanych.
        "process_id": "ea29dd39-f46e-4a8f-beee-297b72d4f7f1",
  "status": "SUCCEEDED",
  "step_number": 50,
  "total_steps": 50,
    • "IMPORT_SYNCHRONIZATION": Proces synchronizacji jest kompletny, a treść jest importowana do produktu Watson Knowledge Catalog.
            "process_id": "e0f4c893-54b3-40d6-8e35-42baded25333",
      "type": "IMPORT_SYNCHRONIZATION",
      "name": "Import synchronization process",
      "status": "SUCCEEDED",
      "percentage": 100,
  • Do kategorii Knowledge Accelerators należy dodać współpracowników, w przeciwnym razie tylko osoba importa akcelerator może korzystać z artefaktów. Szczegółowe informacje na temat tego, jak to zrobić zawiera sekcja Zarządzanie dostępem do kategorii .
  • Dodatkowo można dodać artefakty Knowledge Accelerators jako pliki CSV w projekcie Cloud Pak for Data , korzystając z opcji POST /v1/knowledge_accelerators/{ka_id}/copy_items Kopiuj elementy aplikacji Knowledge Accelerator do projektu interfejsu API.
    Wskazówka:

    Pliki CSV można pobrać lokalnie, a treść można zaimportować za pomocą interfejsu użytkownika Watson Knowledge Catalog . Więcej informacji na temat sposobu korzystania z importu CSV w produkcie Watson Knowledge Catalogzawiera sekcja Importowanie artefaktów zarządzania według typu z plikami CSV.

    1. Wybierz opcję POST /v1/knowledge_accelerators/{ka_id}/copy_items i kliknij opcję Wypróbuj ją.
    2. Wprowadź identyfikator branżowy aplikacji Knowledge Accelerator, identyfikator pozycji do zaimportowania oraz identyfikator projektu, a następnie kliknij opcję Execute(Wykonaj).
Generative AI search and answer
These answers are generated by a large language model in watsonx.ai based on content from the product documentation. Learn more