동작하지 않을 때

실제로 일어나는 순서대로입니다.

페이지에 아무것도 안 보일 때

브라우저 콘솔을 열어 보세요. 차단되거나 실패한 크립트는 그곳에 기록되어 있고, 페이지에서는 보이지 않습니다.

• CSP에 의해 차단됨. 콘솔이 그 directive 이름을 명시합니다. 필요한 세 가지는 임베드 가이드에 있습니다.
• 태그가 한 페이지에만 있음. 사이트 전체 푸터가 아니라, 게시글이나 블록 하나에 붙여넣어 둔 경우.
• 태그가 아예 렌더링되지 않았음. 일부 에디터는 리치 텍스트 필드에서 <script>를 지워 버립니다. 소스를 확인해, 진짜로 있는지 보세요.

보이는데, 사이트가 승인되지 않았다고 할 때

지금 있는 도메인이 allowlist에 없습니다. 가장 흔한 원인은 www.입니다: example.com과 www.example.com은 다른 origin이고, 둘 다 등록해야 합니다. staging 또는 preview 도메인은 세 번째입니다.

키가 지금 유효한 것인지도 확인하세요. 키를 rotate하면 즉시 적용되므로, 오래된 임베드는 이미 존재하지 않는 키를 계속 보내게 됩니다.

답은 하는데, 답이 잘못됐을 때

먼저 Context를 확인하세요. 같은 질문을 해 보고, 당신이 준 내용을 읽어 보세요: 평이한 말로 답이 거기에 없다면, 봇은 필요한 사실을 갖지 못한 것입니다.

빠진 사실을 추가하거나, 모르면 없다고 말하고 연락 창구를 제시하라는 Guardrail을 추가하세요. draft를 저장하고, Preview하고, Publish합니다 — Publish된 프롬프트 변경만 방문자에게 영향을 줍니다.

답해 주길 바라는 것을 거절할 때

대개, Guardrail이 의도보다 넓게 쓰인 경우입니다. "가격 이야기는 절대 하지 않는다"는, "출장비가 대략 얼마나 되죠"도 거절합니다 — 방문자가 가장 많이 찾아 묻는 것이 바로 그 질문이니까요. 좁혀 주세요: "조사 없이 고정 가격을 제시하지 마되, 표준 시간당 단가는 알려 줘."

전혀 답을 안 할 때

포털에서 이번 달 사용량을 확인하세요. 일일 안전 상한이든 월 할당량이든, 도달하면 설계상 답변이 잠시 멈춥니다 — 그래서 청구서가 그대로 유지됩니다. 일일 윈도우가 먼저 초기화되고, 플랜을 올리면 두 한도가 함께 오릅니다.

답이 느릴 때

몇 초는 정상입니다 — 답변은 쓰이는 대로 스트리밍되므로, 끝나기 전에 이미 나타나고 있을 것입니다. 계속 그것보다 훨씬 느리다면, 알려 주실 가치가 있습니다 — 대개 당신의 쪽이 아니라, 우리의 쪽에서 무언가 일어나고 있다는 뜻입니다.

여전히 막힐 때

이 페이지의 에이전트에 물어 보세요. 이 가이드들을 알고 있습니다. 그것도 해결이 안 되면, hello@kavilo.cloud로 메일 주세요.