行为规则和触发器

行为规则让智能体超越回答而做某事——当访客匹配意图时弹出 CTA， 在阈值后提示输入邮箱，当关键词匹配时建议精选答案。它们在每一轮运行， 包括服务器端（在提示词组装期间）和客户端（用于可见 UI 如 CTA）。

规则的组成

每个规则是 behavior_rules 中的一行，包含三个部分：

• kind ——规则类型。目前：cta、lead_capture、route、curated。
• conditions ——描述规则何时触发的 JSON（意图关键词、页面 URL 匹配、滚动深度、空闲时间、消息数）。
• action ——描述做什么的 JSON（显示 CTA 卡片、询问邮箱、路由到人工、返回精选文本）。

规则还有 enabled（布尔值）和 priority （整数）字段。当多个规则匹配时，更高优先级获胜。 禁用的规则保留用于历史记录，不删除。

编辑规则

打开 /app/agents/{id}/behavior。表单是一个感知类型的构建器—— 选择类型，填写条件和操作，保存。最多 20 个启用的规则在 init 时加载到小部件中； 超出部分在运行时被忽略（因此定期修剪禁用列表）。

触发器（访客端）

小部件跟踪轻量级信号以在访客不说话时触发规则：

• 滚动深度 ——当访客通过页面的百分比时触发。
• 空闲 ——当 N 秒内没有输入或滚动时触发。
• 退出意图 ——当光标离开视口朝向屏幕顶部时触发。
• URL 匹配 ——当当前页面 URL 匹配正则表达式时触发。

这些在小部件本地评估，因此触发器立即触发。实际操作（显示 CTA 卡片等） 也在客户端发生——无需往返。

CTA

CTA 操作在聊天面板内渲染一个带有标题、描述和一两个按钮的卡片。按钮可以：

• 在新标签页中打开 URL。
• 发送消息，就像访客输入的一样。
• 捕获潜在客户（打开内联潜在客户表单）。
• 关闭。

在 /app/agents/{id}/ctas 管理 CTA。它们存储为 kind=cta 的行为规则，但专用 UI 比原始规则编辑器更友好。

精选答案

精选答案短路 RAG 管道。如果访客的问题匹配精选触发器（子字符串或正则表达式）， 精选文本流式返回而不是经过检索和 LLM。适用于：

• 价格问题，您需要确切的数字，从不改写。
• 退款/法律语言，必须逐字逐句。
• "我如何联系支持？"，您希望控制路由。

在 /app/agents/{id}/curated 管理它们。每个条目有一个触发短语列表、 预设答案和可选引用。在运行时，智能体逐 token 流式传输精选文本以模仿 LLM 的行为—— 访客不会看到突兀的弹出。

潜在客户捕获规则

lead_capture 规则触发内联潜在客户表单。常见触发器：

• N 条消息回合后（访客的意图看起来真实）。
• 检测到低置信度时（"我们将跟进"）。
• 退出意图时（"在您离开之前……"）。

表单字段可配置——姓名、邮箱、电话和您定义的任何自定义字段。 详见 语音、潜在客户和持久化 了解访客端流程。

路由规则

route 规则 ping 人工操作员。在以下情况下使用它升级：

• 访客明确要求人工。
• 置信度低于阈值。
• 对话达到复杂性启发式（长消息、多个未回答的主题）。

路由在 /app/inbox 中显示为未读线程；操作员可以认领它并继续内联。 详见 收件箱和人工接管。

实验

行为规则可以进行 A/B 测试。实验页面（/app/agents/{id}/experiments） 允许您在两个规则变体之间分割流量并观察转化增量。分割是按访客的，不是按对话的—— 一旦访客被分桶，他们在对话的生命周期内都留在该桶中。