摘要
本文将指导您如何在 Wati 中设置 REST API 操作。您将了解如何选择正确的触发器、在需要时选择事件类型，以及如何正确将操作添加到您的 AI 代理的指令中，使其按预期工作。
说明
REST API 操作只有在配置正确并添加到您的 AI 代理的指令中时才能正常工作。设置过程包含 3 个主要步骤：
选择操作的触发方式
选择事件类型（如适用）
将 REST API 操作添加到您的 AI 代理的指令中
请按照以下步骤完成设置。
步骤 1：选择触发器类型
创建 REST API 操作时，首先要决定的是如何触发它。
有两种可用的触发器类型：
基于意图的触发器
当您希望操作基于用户所说的话运行时，将使用此触发器。
在 AI 代理在对话中检测到用户特定意图时触发
适用于发送数据等操作，例如当用户请求演示或表达兴趣时
参数行为：API 配置中可以使用动态占位符。
触发模式：目前仅支持 agent_decides。这意味着 AI 代理将根据对话上下文决定何时执行操作。
基于事件的触发器
当发生预定义事件时，此触发器会自动运行。
触发时无需依赖用户意图
适用于系统驱动的操作，例如反馈或表单提交
步骤 2：选择事件类型（仅限基于事件）
如果您选择事件作为触发器类型，则必须选择一种支持的事件类型。
目前，Astra 支持以下事件类型：
收到正面反馈（点赞）
当用户点击“点赞”选项时触发
仅支持静态参数
收到负面反馈（点踩）
当用户点击“点踩”选项时触发
仅支持静态参数
表单已提交
当用户提交自定义表单时触发
支持从表单字段传递的动态参数
捕获到潜在客户
在对话过程中收集潜在客户信息时触发
使用固定的请求体结构
选择最符合您希望 REST API 操作运行时机的事件类型。
步骤 3：将 REST API 操作添加到 AI 代理指令
创建 REST API 操作本身是不够的。在将其添加到您的 AI 代理的指令之前，该操作将无法工作。
所有 REST API 操作的必需项
将 REST API 操作添加到您的代理的指令配置中
如果操作未包含在指令中，它将永远不会触发。
“表单已提交”的附加要求
如果您使用的是表单已提交事件类型，则有一个额外的要求：
您还必须将相关的自定义表单添加到代理的指令中
必须同时包含 REST API 操作和自定义表单
如果其中任何一个缺失，REST API 操作将无法正确触发。
以下是根据事件类型要集成的各项内容的快速概述：
事件类型 | 要集成的内容 |
点赞/点踩 | 仅 REST API 操作 |
表单已提交 | REST API 操作 + 自定义表单 |
捕获到潜在客户 | 仅 REST API 操作 |
意图 | 仅 REST API 操作 |
最终检查清单
在发布您的 AI 代理之前，请确保：
已选择触发器类型
已选择事件类型（如果基于事件）
REST API 操作已添加到代理的指令中
使用表单已提交时，已添加自定义表单
完成所有这些步骤后，您的 REST API 操作即可在对话中自动运行。