必须先将 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 工件的主要步骤。
可以在 https://cloud.ibm.com/apidocs/watson-data-api#list-kas中找到 Knowledge Accelerators 的 API 端点的描述。
阶 | 操作或 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 Knowledge Catalog中,并具有以下 套餐和 用户许可权的 IBM Cloud Pak for Data 用户。
- 产品套餐
- 如果您具有 IBM Cloud Pak for Data Enterprise 套餐,那么可以将 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 内容时,请考虑以下两个主要选项。
- 导入选择的业务作用域
- 可以单独导入选择的知识加速器业务作用域,例如 Data Privacy 和其他特定于行业的作用域。 如果对于您感兴趣的区域存在一个或多个这些业务作用域,并且如果您希望从相对较少的业务术语 (例如 200 到 500 个术语) 开始,那么可以安装一个或多个这些单独的作用域。
- 导入部分或全部 Knowledge Accelerator 词汇表
- Knowledge Accelerators 词汇表适用于四个特定行业中的每个行业,并包含完整的 "业务词汇表" , "行业对齐词汇表" 和所有 "业务作用域"。 您可以选择导入所有词汇表或选择这些词汇表。 如果需要导入一组广泛的业务术语 (例如, 5,000 到 20,000 个术语) ,请选择此选项。
正在检查哪些项可用于导入
要检查哪些 Knowledge Accelerators 可用于导入,请调用 Get all Knowledge Accelerators API 端点。检查每个行业可用于导入的项目
要检查哪些 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的实例中,请调用 获取将哪些 Knowledge Accelerator 项导入到词汇表 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。
- 选择要安装的项。 请参阅 检查哪些商品可供导入 和 检查哪些商品可供每个行业导入。提示: 对于每个行业,您可以选择导入特定业务作用域或完整的行业业务核心词汇表和可选的行业对齐词汇表。 有关所有可用项 (包括定义,标识和更多信息) 的详细列表,请参阅以下链接。
- 输入以下参数的值。例如:
参数 描述 示例 ka_id 行业的标识 kafs20
标识 要导入的一个或多个 Knowledge Accelerator 项的标识,以逗号分隔。 请注意,一次只能导入一个作用域。 core-bpi,ccpa,fhir, gdpr
merge_option 导入到 IBM Knowledge Catalog时要使用的合并选项。 all
dependencies 指示还应导入所指定项标识的哪些依赖关系。 mandatory
do_import - 选择
false
以检查参数并确定将导入的内容。 - 选择要导入的
true
。
false
- 选择
- 在响应中,记下 "
process_id
" ,因为您可以使用它在下一部分 检查导入作业的状态中检查导入作业的状态。 可能需要或需要执行此检查,因为有时导入可能需要一些时间,具体取决于导入的项的数量和大小。
- 如果导入多个 KA 业务作用域,那么从共享工件 (例如,策略和规则) 到词汇表术语的某些关系可能会被后续业务作用域导入覆盖。
- 如果为多个行业导入 Knowledge Accelerators ,那么对于后续导入,可能不会合并共享工件 (例如,从策略和规则到词汇表术语) 中的关系-将保留最初导入的 KA 工件中的映射。 您可以忽略导入日志中与策略和监管规则相关的消息 (GIM00010E 或 GIM00015E)。
检查导入作业的状态
要检查导入的状态,请调用 导入资产状态 API 端点。请参阅 https://cloud.ibm.com/apidocs/watson-data-api#get-import-status ,其中 {process_id}
是 导入 Knowledge Accelerators中的值。
导入状态保持为 "IN_PROGRESS"
,直到导入所有工件为止。
添加合作者
您需要将合作者添加到 Knowledge Accelerators 类别,否则只有导入加速器的人员才能使用这些工件。 请参阅 管理对类别的访问权 ,以获取有关如何执行此操作的详细信息。复制到项目中
您还可以使用 将 Knowledge Accelerator 项复制到项目 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 文件按类型导入监管工件。