Liigu põhisisu juurde
ChattyBox Logo

Veaotsing

Kasutage seda lehte, kui vidin on installitud, kuid see ei käitu ootuspäraselt.

Vidin ei ilmu​

Kõigepealt kontrollige brauseri konsooli. ChattyBox teatab, et seal puuduvad kohustuslikud atribuudid.

Levinud põhjused:

  • Skripti juurutatud lehe allikas pole.
  • Skript lisati valele mallile, paigutusele, märgendihalduri konteinerisse või CMS koodialale.
  • Skript on nõusolekureegli või märgendihalduri päästiku taga, mis ei käivitunud.
  • Rakenduse komponent ei käivitu sellel marsruudil või configi kaudu on widget.enabled: false.
  • Sisu turvapoliitika blokeerib https://chattybox.ai/widget.js.
  • CSS või mõni muu vidin kattub käivitusprogrammiga.

Väikseim parandus:

  1. Avage juurutatud avalik leht inkognito aknas.
  2. Otsi lehe allikast chattybox.ai/widget.js.
  3. Kinnitage, et skript ilmub üks kord ja sisaldab data-api-key ja data-api-url.
  4. Teisaldage skript globaalsele jalusele, rakenduse paigutusele, Docusaurus juur- või GTM-i All Pages päästikule, kui see puudub.

Configiga hallatud projektis keelab widget.enabled: false hostitud vidina ning paneb avaliku POST /chat päringu, ka peata SDK kaudu, tagastama 403 Widget is disabled. Muutke seda seadistuse juurutamise töövoos, mitte võtit roteerides. Algkäivituse järel skripti eemaldamine ei eemalda juba renderdatud vidinat.

Puudub data-api-url​

Vidin väljub varakult, kui data-api-url puudub.

Kasutage armatuurlaua täielikku väljavõtet või lisage nõutav atribuut:

<script
  src="https://chattybox.ai/widget.js"
  data-api-key="YOUR_API_KEY"
  data-api-url="YOUR_WIDGET_API_URL"
  async
></script>

Kui teie armatuurlaud kuvab teistsugust API URL-i, kasutage näidisväärtuse asemel armatuurlaua väärtust.

Üldine 401 Invalid API key​

Turvalisuse huvides kasutatakse tundmatu, aegunud või origin’i tõttu tagasi lükatud avaliku võtme korral sama üldist 401 Invalid API key vastust; vastus ei tuvasta põhjust.

Levinud põhjused:

  • Avalik vidina võti kopeeriti valesti.
  • Võti kustutati, aegus või loodi teise projekti jaoks.
  • Lavastusvõti kasutati tootmises või tootmisvõti lavastuses.
  • Valikuline origin’i piirang on võtmel lubatud ja praegune saidi origin pole lisatud.

Parandused:

  1. Avage projekt ChattyBox armatuurlaual.
  2. Kopeerige vahekaardilt Manusta värske väljavõte.
  3. Kontrollige Public Keys > Edit origins ainult siis, kui Restrict this key to specific origins on lubatud. Lisage lehte teenindav täpne origin või lülitage valikuline piirang välja. Skeem, hostinimi ja port peavad ühtima; teed ei vaja eraldi kirjeid.
  4. Paigutage või avaldage sait uuesti ja testige uuesti inkognito aknas.

Vale keel​

Usaldusväärne allikapõhine RAG-vestlusrobot vajab iga vastuse jaoks selget allikasisu.

Vidin valib kasutajaliidese keele järgmises järjekorras:

  1. data-locale vidina skriptis, ainult siis, kui Allow script override on lubatud.
  2. Fixed-režiimis projekti vaikekeel.
  3. Auto-režiimis lehe <html lang>, seejärel brauseri keel ja lõpuks projekti vaikekeel.

Parandused:

  • Kui leht peaks keele automaatselt tuvastama, eemaldage vale data-locale väärtus.
  • Määrake lokaliseeritud lehtedel <html lang="de">, <html lang="fr"> või vastav keelekood.
  • Lisa data-locale="de" ainult siis, kui leht peab sundima konkreetse vidina kasutajaliidese keele.
  • Salvestage seaded, laadige paigaldatud vidin uuesti ja testige uuesti. Lokaal määratakse algkäivitamisel, mitte igal kliendipoolsel marsruudimuutusel.
  • Kui vastused tsiteerivad või toovad sisu valest keelest, kraapige uuesti kõik keeleversioonid. Vidina UI-lokaal ei määra vastuse keelt ega tõlgi allikaid.

Pole tsitaate ega nõrku vastuseid​

ChattyBox vastuseid indekseeritud sisust. Puuduvad tsitaadid või nõrgad vastused tähendavad tavaliselt, et vajalikku lähtesisu ei leitud või see ei vasta küsimusele selgelt.

Parandused:

  • Esitage sama küsimus armatuurlaua testvestluses ja võrrelge viidatud lehti.
  • Veenduge, et lähteleht oleks avalik ja kaasatud roomamisse.
  • Lisage lähtelehele selged pealkirjad, näited, KKK ja otsevastuse tekst.
  • Vältige ekraanipiltide, videote, peidetud akordionide või iframe sisu ainsa allikana lootmist.
  • Kraapige värskendatud leht uuesti ja testige seejärel uuesti.

Lehed pole kraabitud või sisu on vananenud​

Levinud põhjused:

  • Leht puudub esitatud saidikaardil.
  • Käsitsi URL-i režiim ei sisaldanud lehte.
  • Leht suunab ebaõnnestunult või ohtlikult ümber, blokeerib tavapärase HTML-päringu, nõuab autentimist või tagastab CAPTCHA/error-lehe.
  • Lehe sisu muutus pärast viimast kraapimist.
  • Sisu renderdatakse nii, et roomaja ei saa kasulikku teksti välja tõmmata.
  • Valitud URL-id ületasid saadaoleva lehe- või igakuise värskenduse mahu või include/exclude-reegel filtreeris need välja.

Parandused:

  1. Kinnitage, et leht avaneb privaatses brauseriaknas avalikult.
  2. Kasutage saidikaardi režiimi laia katvuse jaoks, crawl’i tavapäraste saidikaartide või linkide avastamiseks või käsitsi URL-e kureeritud komplekti jaoks.
  3. Jälgimis-URL-i, ümbersuunamise URL-i või sisselogimise URL-i asemel esitage kanooniline URL.
  4. Pärast sisumuudatuste avaldamist kraapige uuesti.
  5. Võrrelge töö salvestatud/valitud arve ning Content-loendit kavandatud URL-idega. Completed võib sisaldada vahele jäetud või nurjunud URL-e; Completed with warnings tähistab konkreetselt osaliselt säilinud leheteksti, mitte kõiki crawl’i tõrkeid.

Ikka ummikus​

Enne toega ühenduse võtmist koguge need andmed:

  • Avaliku lehe URL, kus vidin peaks ilmuma.
  • Brauseri konsooli vea ekraanipilt või koopia.
  • Kas leht kasutab tavalist HTML, Next.js, Docusaurus, WordPress, CMS või Google Tag Manager.
  • Kas koodilõik sisaldab data-api-key ja data-api-url.
  • Üks testküsimus, mis peaks töötama ja sellele vastav lähteleht.

Privaatsusvalikud

Kasutame valikulisi analüütika- ja sildihaldustööriistu, et mõista veebisaidi kasutamist. Valige, kas lubate järgmised tööriistad: Ahrefs Web Analytics, PostHog ja Google Tag Manager. Analüütika väljalülitamisel laaditakse see leht uuesti, et muudatus jõustuks korrektselt. Veebisaidi põhifunktsioonid ja veaseire ei sõltu sellest valikust. Lugege meie privaatsuspoliitikat.