在处理信息前拨打电话
每当客户提交输入时,预消息网络挂钩都会调用外部服务或应用程序。 外部服务可以先于助手处理信息。
如果您希望在助手处理每条新消息之前触发网络挂钩,请为助手添加一条预消息网络挂钩。
您可以在以下用例中使用预发消息网络钩子:
将客户的输入翻译成助理使用的语言。
检查并删除客户可能提交的任何个人身份信息,如电子邮件地址或社会保险号。
您可以将此网络挂钩与消息后网络挂钩配合使用。 例如,消息后的网络挂钩可以执行一些操作,例如将响应翻译回客户的语言,或者添加因隐私原因而被删除的信息。 如需更多信息,请参阅 “处理消息后发起呼叫 ”。
注意:在使用私有端点的环境中,请注意 Webhook 会通过互联网传输数据。
如果需要在对话期间执行一次性操作,请使用对话 webhook。 例如,当助手收集到所有必需的详细信息(如账号、用户 ID 和账户保密信息)时,就满足了条件。 如需了解更多信息,请参阅 《从对话框发起程序化调用》。
定义 Webhook
您可以定义一个网络钩子 URL ,用于对每条传入消息进行预处理。
准备工作
对外部服务的程序性调用必须满足以下要求:
请勿在部署了助手并与客户互动的生产环境中设置和测试 webhook。
调用必须是 POST HTTP 请求。
请求体必须是一个 JSON 对象(
Content-Type: application/json)。呼叫必须在 30 秒或更短时间内返回。
注意:如果您的外部服务仅支持 GET 请求,或者您需要在运行时动态指定 URL 参数,请考虑创建一个中间服务,该服务接受包含任何运行时值的 JSON 有效载荷的 POST 请求。 然后,中间服务可以向目标服务发送请求,将这些值作为 URL 参数传递,并将其响应返回给对话框。
选择部署方法
选择您使用的部署方法,查看设置消息后 webhook 的正确步骤。
要查看您正在使用的部署类型,请点击“管理 ”菜单 。 如果您看到切换到经典体验 ,说明您正在使用新体验。 如果您看到 “切换到新体验” ,则表示您正在使用经典体验。
注意:此部署类型不适用于 watsonx Orchestrate。
使用以下链接,根据您的部署类型了解相关程序: