内容


了解如何导出和导入 Watson Assistant 工作区

使用意图和实体,并构建代理通过对话进行交谈的能力

Comments

简介

在这个简单的教程中,我们将使用 Watson™ Assistant API 来完成用于导出和导入 Watson Assistant 工作区的步骤。

背景

利用 Watson Assistant 构建虚拟代理的团队将使用意图和实体来定义代理的领域,并构建代理通过对话进行交谈的能力。上面提到的意图、实体和对话是 Watson Assistant 工作区的核心组件,开发团队在构建和部署虚拟代理解决方案时可在此工作区中查看版本和进行升级。通过 Watson Assistant API,可以轻松地导出和导入 Watson Assistant 工作区。利用此处提供的指示信息,可以创建现有工作区的副本,以用于培训、开发、测试等。

环境设置

要从命令提示符或终端窗口中导出 Watson Assistant 工作区,可以使用 curl。注意,也可以从 IBM Cloud 用户界面中导出 Watson Assistant 工作区,但如果要使用脚本执行或自动执行此过程,您更有可能使用 API。确保在计划执行以下步骤中命令的计算机上安装了 curl。

显然,您还需要在 IBM Cloud 上配置至少一个 Watson Assistant 实例,并且需要有要导出和导入的相关工作区。

检索工作区标识

在导出特定工作区之前,首先需要可通过 IBM Cloud 上的 Watson Assistant UI 或通过 Watson Assistant API 获取的工作区标识。

要使用 Watson Assistant API 检索工作区标识,请发出以下 curl 命令:

  curl -u "{username}":"{password}" "https://gateway.watsonplatform.net/assistant/api/v1/workspaces?version=2018-09-20"

将上述命令中的 {username} 和 {password}  替换为 Watson Assistant 实例的相应凭证。您可能会注意到,Watson Assistant 实例不使用用户名/密码作为认证方法,而是使用身份和访问管理 (IAM) API 密钥作为认证方法。在此情况下,请 将 "{username}":"{password}" 替换为 "apikey:{apikey}" ,其中 {apikey}  是 Watson Assistance 服务实例的 IAM API 密钥值。

上述命令中使用的 URL 用于在美国南部地区运行的 Watson Assistant 服务实例。将该 URL 更新为您的 Watson Assistant 实例的相应值;此值因地区而异,并且可在 IBM Cloud 服务凭证所在的页面上找到此值。

导出 Watson Assistant 工作区

在检索到 Watson Assistant 工作区的标识后,发出以下命令以将工作区导出到 JSON 文件:

  curl -u "{username}":"{password}" "https://gateway.watsonplatform.net/assistant/api/v1/workspaces/<workspace_id>?version=2018-09-20&export=true"> workspace.json

另外,可更改上述命令以使用 IAM API 密钥(前提是它适用于您的服务实例)。该 URL 还应反映运行 Watson Assistant 实例的地区。最后,将 <workspace_id>  替换为上面检索到的值。

该命令采用 JSON 格式将 Watson Assistant 工作区导出到名为 workspace.json 的本地文件中。根据需要更改此文件名。在将 Watson Assistant 工作区导出到文件后,您可以使用相应的命令,自由地通过所选的源代码管理系统对该文件进行版本控制。我们还会将此 JSON 文件导入到 Watson Assistant 以重新创建工作区。该工作区可以驻留在同一个 Watson Assistant 服务实例上,也可以驻留在其他 Watson Assistance 服务实例(在相同或不同的 IBM Cloud 地区中运行)上。

导入 Watson Assistant 工作区

在此最后一步中,我们将 Watson Assistant 工作区导入到另一个 Watson Assistant 实例中。要导入 Watson Assistant 工作区,请发出以下命令:

  curl -H "Content-Type:application/json" -X POST -u "{username}":"{password}" -d @workspace.json "https://gateway.watsonplatform.net/assistant/api/v1/workspaces?version=2018-09-20"

跟前面一样,如果需要,可更改上述命令以使用 IAM API 密钥,并在需要时更新 Watson Assistant 实例的 URL。请记住,可以根据需要将 workspace.json 文件中的 Watson Assistant 工作区导入到同一个 Watson Assistant 实例或其他实例中。在导入 Watson Assistant 工作区后,您可以决定更改工作区名称以标识工作区版本或发布阶段;也可以在导入后通过 Watson Assistant UI 来更改工作区名称。

结束语

通过执行上述步骤,我们学会了如何使用 Watson Assistant API 来导出和导入 Watson Assistant 工作区。为了说明所涉及的步骤,我们使用 curl 向 Watson Assistant API 发出了一些命令。也可以使用 Watson SDK 以通过应用程序来发出这些 API 调用,或者对这些 API 调用进行脚本编制以将其作为配置或构建管理工具的一部分运行。

参考资源

本文翻译自:Learn how to export and import a Watson Assistant workspace (2019-01-14)


评论

添加或订阅评论,请先登录注册

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=10
Zone=认知计算
ArticleID=1064682
ArticleTitle=了解如何导出和导入 Watson Assistant 工作区
publish-date=02132019