Knowledge Accelerators コンポーネントは、カスタマイズする前に、まず IBM Knowledge Catalog にロードする必要があります。
管理者は、コンテンツの一部として提供されている REST API エンドポイントを使用して、 Knowledge Accelerators を IBM Knowledge Catalog にインポートできます。
詳しくは、 Knowledge Accelerators API 資料 ( https://cloud.ibm.com/apidocs/watson-data-api#list-kas ) を参照するか、 v1/knowledge_accelerators/api/explorer/
を IBM Cloud Pak for Data URL に追加して Knowledge Accelerators OpenAPI ユーザー・インターフェースにアクセスしてください。
クイック・スタート
以下の表に、 Knowledge Accelerators 成果物をインポートするための主なステップの概要を示します。
Knowledge Accelerators の API エンドポイントの説明については、 https://cloud.ibm.com/apidocs/watson-data-api#list-kasを参照してください。
手順 | アクションまたは API エンドポイント | 詳細情報 |
---|---|---|
要件と権限 | 以下の ユーザー権限 が必要です。
|
要件とアクセス権 |
認証 | API キーを使用して IBM Cloud IAM トークンを生成します。 https://cloud.ibm.com/docs/account?topic=account-iamtoken_from_apikeyを参照してください。 |
認証と権限付与 |
インポート | 指定された Knowledge Accelerator 項目をグロッサリーにインポートします。 https://cloud.ibm.com/apidocs/watson-data-api#import-ka-into-ikcを参照してください。 |
Knowledge Acceleratorsのインポート を参照してください。 |
インポートの状況 | 資産ステータスのインポート。 https://cloud.ibm.com/apidocs/watson-data-api#get-import-statusを参照してください。 |
インポート・ジョブの状況の確認 |
このビデオをご覧ください。このビデオでは、 Knowledge Acceleratorsをインポートする方法について説明しています。
ビデオの特記事項: このビデオは、この資料の概念とタスクを学習するための視覚的な方法を提供します。 このビデオの一部のマイナー・ステップとグラフィカル・エレメントは、 Cloud Pak for Data デプロイメントとは異なる場合があります。
要件と権限
Knowledge Accelerators は、以下の プランと ユーザー権限を持つ IBM Cloud Pak for Data ユーザーに、 IBM Knowledge Catalogにインポートすることができます。
- オファリング・プラン
- IBM Cloud Pak for Data エンタープライズ・プランがある場合は、 Knowledge Accelerators をガバナンス・フレームワークに追加できます。 エンタープライズ・プランについて詳しくは、 IBM Knowledge Catalog サービス・プランを参照してください。
- 必要な権限
- Knowledge Acceleratorsをインポートするには、以下の ユーザー権限 が必要です。
- ガバナンス・カテゴリーの管理
- グロッサリーの管理
リソース・ハブでの Knowledge Accelerators の検索
- Cloud Pak for Data as a Service リソース・ハブ https://dataplatform.cloud.ibm.com/galleryにログインします。
- を選択します。
- タイルをクリックすると、特定の Knowledge Accelerators 業界の詳細が表示されます。
認証と権限付与
Cloud Pak for Dataで認証するには、 IBM Cloud IAM トークンを生成する必要があります。
- API キーを取得します。 手順については、 https://cloud.ibm.com/docs/account?topic=account-userapikey#create_user_keyを参照してください。
- API キーを使用して IAM トークンを生成します。 手順については、 https://cloud.ibm.com/docs/account?topic=account-iamtoken_from_apikeyを参照してください。
インポートする Knowledge Accelerator 項目の選択
Knowledge Accelerators のコンテンツのインポートを計画する場合は、以下の 2 つの主なオプションを考慮してください。
- 選択したビジネス・スコープのインポート
- 一連の Knowledge Accelerator ビジネス・スコープは、個別にインポートすることができます。例えば、 Data Privacy やその他の業界固有のスコープなどです。 関心のある領域に対してこれらのビジネス・スコープが 1 つ以上存在し、比較的少数のビジネス用語 (例えば、200 から 500 個の用語) から開始する場合は、これらの個別のスコープを 1 つ以上インストールできます。
- Knowledge Accelerator ボキャブラリーの一部またはすべてのインポート
- Knowledge Accelerators のボキャブラリーは、4 つの特定の業種ごとに存在し、完全なビジネス・ボキャブラリー、業界アライメント・ボキャブラリー、およびすべてのビジネス・スコープを含んでいます。 これらのボキャブラリーのすべてをインポートするか、選択したボキャブラリーをインポートするかを選択できます。 業界の幅 (例えば、5,000 から 20,000 個の用語) に対応するために広範なビジネス用語セットをインポートする必要がある場合は、このオプションを選択します。
インポートに使用できる項目の確認
インポート可能な Knowledge Accelerators を確認するには、 Get all Knowledge Accelerators API エンドポイントにアクセスしてください。https://cloud.ibm.com/apidocs/watson-data-api#list-kas を参照してください。
業界ごとにどの項目をインポートできるかを検査しています
特定の業界でインポート可能な Knowledge Accelerators を確認するには、 Get a specific Knowledge Accelerator API エンドポイントにアクセスしてください。https://cloud.ibm.com/apidocs/watson-data-api#get-ka-by-idを参照してください。
業界共通 | 電力/ガス | 金融サービス | 医療 | 保険 |
---|---|---|---|---|
|
|
|
|
|
どの Knowledge Accelerators が既にインポートされているかの確認
Knowledge Accelerators が IBM Knowledge Catalogのインスタンスにインポートされているかどうかを確認するには、 Get what Knowledge Accelerator items are imported into glossary API エンドポイントを呼び出します。https://cloud.ibm.com/apidocs/watson-data-api#get-ka-statusを参照してください。
Knowledge Accelerators のインポート
Knowledge Accelerators 項目を IBM Knowledge Catalogのインスタンスにインポートするには、 「指定された Knowledge Accelerator 項目をグロッサリーにインポート」 API エンドポイントに呼び出します。
https://cloud.ibm.com/apidocs/watson-data-api#import-ka-into-ikcを参照してください。
- インストールする項目を選択します。 「 インポートに使用できる項目の確認 」および「 業種ごとにインポートに使用できる項目の確認」を参照してください。ヒント: 業種ごとに、特定のビジネス・スコープをインポートするか、業界全体のビジネス・コア・ボキャブラリーとオプションの業界アライメント・ボキャブラリーをインポートするかを選択できます。 定義、ID、および詳細情報を含む、使用可能なすべての項目の詳細なリストについては、以下のリンクを参照してください。
- 以下のパラメーターの値を入力します。次に例を示します。
パラメーター 説明 例 ka_id 業界の ID。 kafs20
ids インポートする 1 つ以上の Knowledge Accelerator 項目の ID をコンマで区切って指定します。 一度にインポートできるスコープは 1 つのみであることに注意してください。 core-bpi,ccpa,fhir, gdpr
マージ・オプション IBM Knowledge Catalogにインポートするときに使用するマージ・オプション。 all
dependencies 指定された項目 ID のどの依存関係もインポートする必要があるかを示します。 mandatory
do_import (do_import) false
を選択して、パラメーターを確認し、インポートされる内容を調べます。- インポートする
true
を選択します。
false
- 応答では、「
process_id
」をメモします。これを使用して、次のセクション「 インポート・ジョブの状況の確認」でインポート・ジョブの状況を確認できます。 インポートされた項目の数とサイズによっては、インポートに時間がかかる場合があるため、この検査が必要であるか、望ましい場合があります。
- 複数の KA ビジネス・スコープをインポートすると、ポリシーやルールなどの共有成果物から語彙用語への一部の関係が、後続のビジネス・スコープ・インポートによって上書きされる可能性があります。
- 複数の業界の Knowledge Accelerators をインポートする場合、ポリシーやルールから語彙用語への変換などの共有成果物からの関係は、後続のインポートのためにマージされない可能性があります。最初にインポートされた KA 成果物からのマッピングは保持されます。 ポリシーおよびガバナンス・ルールに関連するインポート・ログ内のメッセージ (GIM00010E または GIM00015E) は無視できます。
インポート・ジョブのステータスの確認
インポートの状況を確認するには、 「アセット状況のインポート (Import of assets status)」 API エンドポイントを呼び出します。https://cloud.ibm.com/apidocs/watson-data-api#get-import-status を参照してください。ここで、 {process_id}
は Knowledge Acceleratorsのインポートの値です。
インポート状況は、すべての成果物がインポートされるまで "IN_PROGRESS"
のままです。
コラボレーターの追加
コラボレーターを Knowledge Accelerators カテゴリーに追加する必要があります。追加しない場合は、アクセラレーターをインポートしたユーザーのみが成果物を使用できます。 これを行う方法について詳しくは、 カテゴリーへのアクセスの管理 を参照してください。プロジェクトへのコピー
Copy Knowledge Accelerator items into project API エンドポイントを使用して、 Knowledge Accelerators 成果物を CSV ファイルとして Cloud Pak for Data プロジェクトに追加することもできます。https://cloud.ibm.com/apidocs/watson-data-api#copy-ka-into-ikc を参照してください。
CSV ファイルはローカルにダウンロードでき、コンテンツは IBM Knowledge Catalog ユーザー・インターフェースを使用してインポートできます。 IBM Knowledge Catalogで CSV インポートを使用する方法について詳しくは、トピック「 CSV ファイルを使用したタイプ別のガバナンス成果物のインポート」を参照してください。