IBM Cloud Docs
watsonx Assistant API 概述

watsonx Assistant API 概述

您可以使用 watsonx Assistant REST API 和相应的 SDK 来开发与服务进行交互的应用程序。

客户机应用程序

要构建虚拟助手或其他客户端应用程序,以便在运行时与助手通信,请使用 v2 应用程序接口。 您可以开发面向客户的客户机 (可以部署以用于生产),用于代理助手与另一个服务之间的通信的应用程序或测试应用程序。

通过使用 V2 运行时 API 与助手进行通信,应用程序可以利用以下功能:

  • 自动状态管理 v2 运行时应用程序接口可管理与用户的每次会话,存储并维护助手进行完整对话所需的所有上下文数据。

  • 轻松部署助手。 除了支持定制客户机外,还可以轻松地将助手部署到 Slack 和 Facebook Messenger 等常用消息传递通道。

  • 版本控制。 您可以保存内容的快照,并将助理链接到该特定版本。 然后,可以继续更新开发版本,而不会影响生产助手。

  • 搜索功能。 v2 运行时 API 可用于接收来自搜索集成的响应。 提交助手无法回答的查询时,搜索集成可以从配置的数据源中找到最佳答案。

有关更多信息,请参阅 watsonx Assistant v2 API 参考

watsonx Assistant v1 API 支持 /message 方法,可将用户输入直接发送到对话框使用的工作区。 支持 v1 运行时应用程序接口主要是为了兼容。 如果使用 V1 /message 方法,那么必须实现您自己的状态管理,而无法利用助手的版本控制或其他任何功能。

编写应用程序

v1 应用程序接口提供的方法可使应用程序创建或修改对话技能,而不是使用经典的 Watson Assistant 用户界面以图形方式创建技能。 编写应用程序使用该 API 来创建和修改技能、意向、实体、对话节点和其他构成对话技能的工件。 如需了解更多信息,请参阅《 v1 应用程序接口参考 》。

v1创作方法创建和修改的是工作区而不是技能。 工作空间是用于对话技能中对话和训练数据(如意向和实体)的容器。 如果使用应用程序接口创建了新的工作区,它将作为一个新的对话框技能出现在经典的 Watson Assistant 用户界面中。

有关可用 API 方法的列表,请参阅 API 方法摘要