构建您的智能体
精选答案和 CTA
精选答案和 CTA 是小部件支持的两种"确定性"行为——它们绕过 LLM, 支持确切的文本或结构化的行动号召。在您不能容忍模型改写或偏离脚本的地方使用它们。
何时使用精选答案
精选答案适用于响应必须确切的问题:
- 价格——访客想要数字,而不是"大约 $99/月"。
- 法律/合规——退货政策、GDPR 声明、合同条款。
- 路由——"我如何联系您?",您希望推送特定的 URL。
- 品牌关键 FAQ——您最高风险的 5-10 个问题。
编写
从 /app/agents/{id}/curated:
- 触发短语 ——每行一个。子字符串匹配,不区分大小写。添加变体("price"、"pricing"、"how much does it cost")。
- 答案 ——要流式返回的确切文本。支持 Markdown(粗体、链接、列表)。
- 引用 URL ——可选。如果设置,消息将获得链接到那里的引用 chip。
- 优先级 ——当多个精选条目匹配相同输入时,更高者获胜。
匹配工作原理
在 RAG 管道运行之前,消息通过 CuratedAnswerMatcher。
如果任何触发器匹配,则返回精选文本,我们永远不会调用检索或 LLM。
这使得精选答案快速——通常端到端低于 100ms——并且便宜
(无推理成本)。
流式行为与 LLM 的匹配:token 以小的间隔一次一个地流式传输, 因此访客看到相同的打字动画。他们无法分辨精选答案和生成答案之间的区别。
CTA
CTA 是访客可以点击的卡片——按钮、链接或两者——在聊天面板内联渲染。 每个 CTA 有:
| 字段 | 目的 |
|---|---|
title | 单行标题。 |
description | 可选的支持文本。 |
buttons | 1 或 2 个按钮。每个都有标签和操作(URL、send_message、lead_capture、dismiss)。 |
conditions | 何时显示。与行为规则条件相同的形状。 |
常见 CTA 模式
- 价格揭示 ——当访客询问成本时,显示带有"比较套餐"/"与销售对话"按钮的卡片。
- 演示追加销售 ——在 3 轮产品问答后,显示"预订 15 分钟演示"。
- 退出意图救援 ——当光标离开朝向地址栏时,显示"在您离开之前——快速问题?"并带有一键潜在客户表单。
- 滚动深度提示 ——在 80% 页面滚动时,提供"查看实际操作"→ 演示 URL。
编辑
/app/agents/{id}/ctas 是管理页面。表单是一个结构化构建器——
您不需要编写 JSON。保存创建或更新带有 kind=cta 的行为规则。
禁用以保留规则但停止显示它。
测试 CTA 和精选答案
Playground(/app/agents/{id}/playground)是您的沙盒。
它运行与实时小部件相同的管道,但对话上有 is_playground=true,
因此它不计入您的每月配额并且不在分析报告中。
输入触发短语并确认精选答案触发。输入接近但不完全的内容并确认它不触发 (否则您的触发器太宽松)。