出問題時

依這些問題實際發生的頻率排序。

頁面上什麼都沒出現

打開瀏覽器主控台。被擋或載入失敗的 script 會在那裡說出來,在頁面本身看不見。

• 被 CSP 擋住。主控台會點名是哪個指令。需要的三個,見 嵌入指南。
• 標籤只在一頁上。貼進了文章或單一區塊,而不是全站共用的頁尾。
• 標籤根本没渲染。有些編輯器會從富文字欄位剝掉 <script>。檢視原始碼,確認它真的在。

出現了,但顯示網站未授權

你所在的網域不在允許清單裡。最常見的原因是 www.:example.com 和 www.example.com 是不同的 origin,兩個都要列。staging 或預覽網域是第三個。

也檢查金鑰是不是現行的。換金鑰立即生效,所以舊的嵌入會一直送一把已經不存在的金鑰。

有回答,但答錯了

先檢查 Context。問同一個問題,再讀一遍你提供的內容:如果答案沒有用直白的方式寫在裡面,機器人就是沒有它需要的那個事實。

補上缺的事實,或加一條 Guardrail,告訴它不知道時要說,並提供聯繫你的方式。存成 draft、Preview,然後 Publish;只有已發布的 prompt 變更會影響訪客。

它拒絕了你想讓它回答的事

通常是一條 Guardrail 寫得比意圖更廣。「絕對不要談價格」也會把「上門大概是幾錢」拒掉——而那正是多數訪客想問的問題。把它收窄:「未經實地查看,不報固定價格;但可以給標準時薪。」

它完全不回答了

到控制台查看本月計數。達到每日安全上限或每月額度,回覆就會暫停——這是設計如此,帳單才能保持固定。每日窗口會先重置;升級方案會同時提高兩個上限。

回覆很慢

幾秒鐘是正常的;回覆邊寫邊串流,所以還沒寫完就開始出現。如果一直比這慢很多,值得告訴我們——通常代表我們這邊有事,不是你那邊。

還是卡住

問這個頁面上的 agent。它知道這些指南。如果它幫不上,寄信到 hello@kavilo.cloud。