IBM Cloud Docs
创建基于技能的行动

创建基于技能的行动

基于技能的操作,也称为会话技能操作,允许助理连接并启动来自第三方应用程序和服务的任务。 然后,助理可以报告任务的状态,并与用户互动,以完成给定的任务。 有关技能的更多信息,请参阅 watsonx Orchestrate 文档中的 应用程序和技能概述

基于技能的操作需要连接到 watsonx Assistant 并提供访问外部应用程序或服务功能的提供商。 在watsonx Orchestrate中,您可以找到 预置技能和应用程序,它们允许您访问许多服务的功能,但您不能注册自己的应用程序将其用作技能提供者。

watsonx Assistant,您可以将您自己的应用程序用作基于技能的交互提供程序,并使用它们来增强用户与您的助手的交互体验,提供助手无法提供的功能。

准备工作

要创建自己的基于技能的行动,首先必须满足以下要求:

  1. 实施符合基于技能的操作提供程序 API 规范的 API
  2. watsonx Assistant 注册技能型行动提供者

为基于技能的行动提供程序设计应用程序接口

有关技能提供者 API 规范的更多信息,请参阅 对话技能:由 Pro-Code 会话技能客户端实施的 API 端点主文档

您还可以使用JavaSDK 学习会话技能。 欲了解更多信息,请发送电子邮件至 会话技能:基于 Java 的会话技能,用于 watsonx Assistant

注册技能行动提供者

创建端点后,您必须watsonx Assistant 中注册您的技能型行动提供者。 有关如何实现的更多信息,请参阅 注册对话技能提供程序

如果您需要更多不同模式中身份验证的示例,请参阅 创建会话技能提供程序

创建基于技能的行动

watsonx Assistant创建基于技能的操作有两种方法。 您可以使用API或 watsonx Assistant创建它们。 选择最适合您需要的选项。

使用应用程序接口创建基于技能的操作

要使用 API 创建基于技能的操作,您必须首先创建一个OpenAPI技能规范,该规范会引用您的技能提供程序的端点。

您可以使用任何 OAS 编辑器或 watsonx Orchestrate OpenAPI 生成器 来完成这项任务。 有关详细信息,请参阅 watsonx Orchestrate 文档中的 为技能构建 OpenAPI 规范

之后,您可以使用 watsonx Assistant 导入技能端点 来导入技能。 完成后,您就可以在助手中使用该技能。

通过UI创建技能

您还可以使用 watsonx Assistant创建基于技能的交互。

要从用户界面创建基于技能的操作,您的技能提供程序的 API 必须实现 list 对话技能 端点。

技能中的操作不支持从其他操作获取输入值或将输出值映射到其他操作。

要创建基于技能的操作,请完成以下步骤:

  1. 在 watsonx Assistant,依次点击 “操作” > “新建操作”> “基于技能的操

  2. 从技能建立动作页面中,单击要将动作链接到的技能,使该技能成为动作的基础。

    您必须连接到该技能的应用程序,它才会在此步骤中显示为选项。 有关更多信息,请参阅 管理连接和连接应用程序

  3. Name your action 字段中,输入操作名称。

  4. 添加操作条件 中,您可以添加或编辑操作触发器的条件。

    有关更多信息,请参阅 为操作添加条件

  5. Enter a phrase 字段中,输入客户必须键入或询问才能触发技能的短语。 例如,I want to pay my electricity bills

  6. 您可以使用页面右上角的以下选项来改善助手体验:

    • 行动响应模式

      定义助手的响应模式,例如 ClarifyingConfident

    • 行动说明

      打开操作注释窗口,添加说明、文档、注释或任何其他注释,以帮助您在创建操作时跟踪工作。

    • 操作设置

      打开操作设置窗口,以启用或禁用操作中的提出澄清问题更改对话主题配置。

  7. 点击 “保存”按钮保存操作。

您的助手现在可以使用新创建的操作。

使用基于技能的行动

要测试和使用基于技能的操作,可以与助手开始新对话,并按照创建操作时定义的条件进行操作。 满足条件后,输入触发操作的短语。

然后,助手会尝试将该操作转化为对话,您可以在对话中查看任务状态,并与助手互动,以成功完成操作。