指南
不工作的时候
按这些情况实际发生的频率排序。
页面上什么都没出现
打开浏览器控制台。被挡住或加载失败的脚本会在那里说明,页面本身却看不到。
- 被 CSP 挡了。 控制台会指明是哪条指令。嵌入里有你需要的三条。
- 标签只在一个页面上。 粘进了单篇文章或单个区块,而不是站点级的页脚。
- 标签根本没渲染出来。 有些编辑器会把富文本字段里的
<script>剥掉。查看源代码,确认它真的在那里。
出现了,但提示站点未授权
你所在的域名不在白名单里。最常见的原因是 www.:example.com 和 www.example.com 是不同的源,都需要列出来。测试或预览域名算第三个。
也要检查密钥是不是当前这一把。轮换密钥立即生效,旧的嵌入会一直发已经不存在的密钥。
有回答,但答错了
先查 Context。问同样的问题,然后读你提供的内容:如果答案里没有明说,就是机器人没有它需要的事实。
补上缺失的事实,或者加一条 Guardrail,告诉它不知道就明说并提供联系你的方式。保存 draft,Preview,然后 Publish;只有发布的提示词改动会影响访客。
它拒绝回答你想让它回答的
通常是护栏写得比意图宽了。“永不讨论价格”也会把“上门大概多少钱”拒掉——而这恰恰是大多数访客来问的问题。收窄它:“未经勘察不报固定价,但可以报标准时薪。”
完全不回复了
查控制台里本月的计数。触到每日安全上限或月度配额都会暂停回复,这是设计行为,账单才能保持平稳。先清的是每日窗口;升级套餐两个限制都会提高。
回复很慢
几秒是正常的;回复是边写边流式出现的,没写完就开始显示。一直明显更慢就值得告诉我们——通常是我们这边的问题,不是你的。
还是卡住
问本页面的代理。它熟悉这些指南。它解决不了,发邮件到 hello@kavilo.cloud。