Liigu põhisisu juurde

Veaotsing

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

Vidin ei ilmu​

Kõigepealt kontrollige brauseri konsooli. ChattyBox teatab seal kohustuslike atribuutide puudumisest.

Levinud põhjused:

  • Skripti pole ei juurutatud HTML-is ega aktiivses DOM-is.
  • Skript lisati valele mallile, paigutusele, märgendihalduri konteinerisse või CMS-i koodialasse.
  • Skripti käivitamist takistas nõusolekureegel või märgendihalduri päästik, mis ei käivitunud.
  • Loaderi paigaldav rakenduse komponent ei käivitu sellel marsruudil.
  • Sisu turvapoliitika blokeerib https://chattybox.ai/widget.js.
  • CSS või mõni muu vidin kattub käivitusnupuga.
  • Juurutatud konfiguratsioonis on widget.enabled: false.

Väikseim parandus:

  1. Avage juurutatud avalik leht inkognito aknas.
  2. Otsige chattybox.ai/widget.js nii lehe allikast kui ka brauseri Elements-paneelist; SDK või JavaScripti lisatud loader võib olla nähtav ainult aktiivses DOM-is.
  3. Veenduge, et skript ilmub üks kord ning sisaldab data-api-key ja data-api-url.
  4. Kui skript puudub, teisaldage see globaalsesse jalusesse, rakenduse paigutusse, Docusauruse juurkausta või GTM-i All Pages päästikusse.

Konfiguratsiooniga hallatavas projektis takistab widget.enabled: false hostitud vidina käivitumist ja paneb avaliku POST /chat päringu vastama veaga 403 Widget is disabled; see kehtib ka headless SDK päringutele. Muutke seda seadistust konfiguratsiooni juurutamise töövoos, mitte avalikku võtit roteerides. Loaderi skripti eemaldamine pärast käivitumist ei eemalda juba renderdatud vidinat.

data-api-url puudub​

Vidin lõpetab töö enneaegselt, kui data-api-url puudub.

Kasutage armatuurlaua täielikku koodinäidet 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>

Ärge arvake API URL-i ise, vaid kasutage armatuurlaual näidatud aadressi. Tootmiskeskkonnas peaks see olema stabiilne https://...convex.site/chat aadress.

Üldine viga 401 Invalid API key​

Turvalisuse huvides tagastavad vidina API lõpp-punktid tundmatu, aegunud või origini tõttu tagasi lükatud avaliku võtme puhul sama üldise vea 401 Invalid API key. Vastuse põhjal põhjust tuvastada ei saa.

Levinud põhjused:

  • Avalik vidina võti kopeeriti valesti.
  • Võti kustutati, aegus või pärineb API URL-ist erinevast backend’i juurutusest.
  • Võtme projekti või omanikku kustutatakse.
  • Võtmel on valikuline origin’i piirang lubatud, kuid praegune saidi origin pole loendis.

Parandused:

  1. Avage projekt ChattyBoxi armatuurlaual.
  2. Avage Paigalda → Veebisaidi paigaldamine, sisestage veebisaidi URL ja kopeerige sobiv koodinäide, kui see on saadaval.
  3. Kasutage samal lehel jaotises Võtmed ja domeenid paigaldatud koodinäites kasutatud võtme jaoks valikut Muuda origine. Kui Piira see võti kindlate originidega on lubatud, lisage lehte teenindav täpne origin või lülitage valikuline piirang välja. Skeem, hostinimi ja port peavad ühtima: https://example.com, https://preview.example.com ja http://localhost:3000 on erinevad origin’id. Teedele pole vaja eraldi kirjeid.
  4. Juurutage või avaldage sait uuesti ning testige inkognito aknas.

Sama backend’i teise vestlusroboti kehtiv võti valib tavaliselt selle vestlusroboti, mitte ei põhjusta viga 401; kui vastused pole teemakohased, kontrollige projekti. Võtmete nimed, näiteks „production” ja „staging”, ei määra keskkonda. HTTP API kasutab Origin-päist, kui see on olemas; ainult selle puudumisel kasutab see Referer-päisest saadud origin’i. Piiranguga võti lükkab päringu tagasi, kui valitud origin puudub, on vigane või pole lubatud. Lubatud Referer ei tühista keelatud Origin-it. Origin’i piirangud ei asenda külastaja autentimist.

Sõnumi- ja päringupiirangud​

Kontrollige lehel Konto ja arveldus aadressil /settings/account sõnumikasutust, paketti ning valikulisi Pro/Business PAYG eelarveid. Testvestlus ja avalik vestlus kasutavad omaniku ühist sõnumilimiiti. Vestluste kustutamine ega uue võtme loomine seda limiiti ei lähtesta.

Kuu sõnumilimiidi vead ja lühiajalised päringupiirangud on erinevad. HTTP 429 vastuse korral järgige päist Retry-After, kui see on olemas, selle asemel et päringuid korduvalt uuesti saata. Kuu sõnumilimiidi vea korral oodake limiidi lähtestumist või muutke paketti või sobivat PAYG eelarvet. Vestlused → Ajalugu sisaldab vestluste ajalugu, mitte üksikute päringute veakonsooli; HTTP tõrkeid uurige brauseri Network-paneelis.

Vale keel​

Kontrollige esmalt vidina keelesätteid jaotises Kohanda → Välimus. Praeguse lähtekoodiga hostitud vidin valib kasutajaliidese keele järgmises järjekorras:

  1. Vidina skripti data-locale — ainult siis, kui Allow script override on lubatud.
  2. Režiimis Fixed seadistatud vaikekeel.
  3. Režiimis Auto-detect lehe <html lang>, seejärel brauseri toetatud keelekandidaadid ja lõpuks seadistatud vaikekeel.

Toetamata kandidaadid jäetakse vahele. Kui ükski kandidaat pole toetatud, kasutatakse viimase varuvariandina inglise keelt; esialgne vaikekeel on inglise keel.

Parandused:

  • Automaatse keelevaliku korral valige Auto-detect ning eemaldage vale data-locale või keelake skripti ülekirjutus.
  • Määrake lokaliseeritud lehtedel <html lang="de">, <html lang="fr"> või sobiv keelekood.
  • Seadistatud keele sundimiseks valige Fixed ja lülitage Allow script override välja. Kui ülekirjutus on lubatud, on data-locale prioriteetne ka Fixed-režiimis.
  • Kontrollige, kas sätted salvestati, algatage paigaldatud vidin uuesti, et see armatuurlaua konfiguratsiooni laadiks, ja testige uuesti. Praeguse lähtekoodi hostitud widget.js v16 saab toote enda silte värskendada, kui <html lang> või loaderi data-locale muudab tuvastatud keelt. Enne reaalajas värskendustele lootmist kontrollige juurutatud loaderi versiooni; see hostitud loaderi käitumine ei sõltu avaldatud npm SDK paketist 0.1.4. mountWidget()-ile antud locale muutub data-locale väärtuseks ja järgib samu projektisätteid.
  • Kui vidin pole saadaval, kontrollige /widget-config päringut ja avalikku võtit. Kui konfiguratsiooni laadimine ebaõnnestub, jätab praeguse lähtekoodi hostitud widget.js v16 vidina kättesaamatuks, mitte ei käivita seda vaikesätetega. Enne sellele käitumisele lootmist kontrollige juurutatud loaderi versiooni.
  • Kui vastused viitavad või hangivad sisu vales keeles, indekseerige iga vajalik keeleversioon. Vastusegeneraator tuvastab keele küsimuse, mitte vidina kasutajaliidese keele põhjal; Fixed-režiim ei sunni vastuse keelt ega tõlgi lähtesisu. Kui kohandatud assistant.fallbackMessage pole määratud, kasutab sisseehitatud puuduva sisu varuvastus sobivuse korral küsimuse tuvastatud keelt; kui keele tuvastamine on ebakindel, kasutab see vidina kasutajaliidese keelt ning inglise keel on viimane varuvariant.

Viited puuduvad või vastused on nõrgad​

ChattyBox kasutab vastuste genereerimiseks hangitud lähtesisu. Puuduvad viited või nõrgad vastused võivad tuleneda puuduvast või sobimatust lähtesisust, otsinguprobleemidest või genereerimise nurjumisest; need ei näita iseenesest põhjust.

Allikapõhisele RAG-vestlusrobotile on selge hangitud lähtesisu kasulik, kuid viide üksi ei kinnita vastuse õigsust. Võrrelge iga olulist väidet viidatud lehega.

Parandused:

  • Esitage sama küsimus armatuurlaua testvestluses ja võrrelge viidatud lehti.
  • Veenduge, et lähteleht on avalik ja kaasatud roomamisse.
  • Lisage lähtelehele selged pealkirjad, näited, KKK ja otsesed vastused.
  • Ärge lootke ainsa allikana ekraanipiltidele, videotele, välistatud peidetud märgistusele, ainult JavaScriptiga kuvatavale sisule ega iframe’idele.
  • Kraapige uuendatud leht uuesti, kui jahutusaeg seda lubab, oodake manustamistöö valmimist ja testige seejärel uuesti.
  • Otsige hoiatusi Osaliselt indekseeritud; üle 512 KiB suurust leheteksti ei säilitata. Jagage pikad lähtetekstid osadeks, selle asemel et sama kärbitud teksti korduvalt uuesti indekseerida.
  • Sõnastage iga küsimus võimaluse korral selgelt ja iseseisvalt. Vastusegeneraator saab kasutada kuni 12 viimast salvestatud sõnumit, igaüks kuni 2000 tähemärki; kogu vestluse transkripti see ei saa.

Persona lisab sisseehitatud maandamisreeglitele saidipõhiseid juhiseid; see ei asenda puuduvaid indekseeritud tekste ega puuduva konteksti või sisulünga varuvastust, kui see käivitub. Sisulünga tuvastaja on heuristiline ega pruugi kõiki põhjendamata vastuseid märgata. Sellel varuvastusel on eraldi säte assistant.fallbackMessage jaotises configuration as code.

Lehti ei kraabita või sisu on aegunud​

Levinud põhjused:

  • Leht puudub esitatud saidikaardilt.
  • Käsitsi URL-ide režiim ei sisaldanud seda lehte.
  • Leht blokeerib tavalise HTTP-päringu, nõuab autentimist, tagastab CAPTCHA-/vealehe või suunab blokeeritud sihtkohta.
  • Lehe sisu muutus pärast viimast kraapimist.
  • Sisu renderdatakse ainult JavaScriptiga või asub väljaspool valitud semantilist sisujuurt.
  • Valitud URL-id ületasid lehtede limiidi, igakuine värskenduseelarve sai otsa või include/exclude-reegel filtreeris need välja.

Parandused:

  1. Veenduge, et leht avaneb privaatses brauseriaknas avalikult.
  2. Laia katvuse jaoks kasutage saidikaardi režiimi, valitud URL-ide kogumi jaoks käsitsi URL-e. Crawl-režiim proovib esmalt tavapäraseid saidikaarte; kui kumbki neist URL-e ei tagasta, järgib see alguslehelt sama origin’i linke.
  3. Esitage kanooniline URL, mitte jälgimis-, ümbersuunamis- või sisselogimis-URL.
  4. Kraapige pärast sisumuudatuste avaldamist uuesti ja alles pärast värskenduse jahutusaja möödumist: Free-paketis vähemalt seitse päeva viimase töö loomise ajast, tasulistes pakettides 24 tundi — ka siis, kui viimane töö ebaõnnestus.
  5. Avage Teadmised → Lehed, laiendage Impordi ajalugu, kui töid on olemas, ja valige töö jaotises Kraapimistööd. Võrrelge töö salvestatud/valitud arve ja loendit Lehed soovitud URL-idega. Lõpetatud töö võib sisaldada vahele jäetud või nurjunud URL-e. Lõpetatud hoiatustega märgib konkreetselt osaliselt säilinud leheteksti, mitte kõiki crawl’i tõrkeid. Kasutajaliides ei näita täielikku URL-põhist tõrgete loendit.

ChattyBox ei jõusta robots.txt-i roomamisdirektiive, kuid võib seda faili lugeda saidikaardi deklaratsioonide leidmiseks. Ärge käsitlege robots.txt-i juurdepääsukontrollina. ChattyBox järgib ohutuid HTTP ümbersuunamisi, seega pole ümbersuunamine iseenesest tõrge. Ärge eemaldage juurdepääsukaitset ega tehke privaatset sisu avaliku URL-i kaudu kättesaadavaks selle roomatavaks muutmiseks.

Kui URL eemaldati saidilt või allikate valikust, võidakse salvestatud lehte endiselt kasutada. Kustutage see ka jaotisest Teadmised → Lehed ja välistage see tulevasest avastamisest. Ehita indeks uuesti kasutab salvestatud teksti, mitte uut võrgupäringut; sel on paketipõhine jahutusaeg ja see kasutab igakuist värskenduseelarvet.

Seaded ei salvestu​

Vestlusroboti üksikasjade ja allikaseadete muudatused salvestatakse automaatselt. Enne jätkamist kontrollige salvestuse olekut, lahendage valideerimisvead või proovige nurjunud salvestamist uuesti. Armatuurlaud nõuab salvestatud Website URL-i ka siis, kui sisestate Manual URLs. Avastamine ja automaatsalvestus ei käivita importi; vaadake valitud lehed üle ja käivitage import selgesõnaliselt.

Kui projekti olek on Config locked, tuleb konfiguratsioon juurutada CLI töövoo kaudu. Lukk on pöördumatu; Persona salvestamine, kraapimisseadistus, Scrape Now, sisu kustutamine ja indeksi uuesti ehitamine lükatakse tagasi ka siis, kui vastavad juhtelemendid on endiselt nähtavad. Hostitud vidina konfiguratsioonis jääb armatuurlaual muudetavaks ainult brändingu eelistus, sõltuvalt paketist. Avalikud vidinavõtmed ja juurutustokenid on eraldi mandaadid.

Kui projekt puudub või juurdepääs keelati, veenduge, et logisite sisse omanikuna. Vidinavõti, juurutustoken ega organisatsiooni liikmesus ei anna armatuurlaua omaniku õigusi. Jaotises Vestlused sisalduvad Analüütika ja Vastamata küsimused Pro ja Business paketis; kui vaade pole saadaval, kuvatakse paketi uuendamise soovitus. Ajalugu on saadaval kõigis pakettides.

Ikka hädas?​

Enne toega ühenduse võtmist koguge järgmine teave:

  • Avaliku lehe URL, kus vidin peaks ilmuma.
  • Brauseri konsooli vea ekraanipilt või koopia.
  • Kas leht kasutab tavalist HTML-i, Next.js-i, Docusaurust, WordPressi, CMS-i või Google Tag Managerit.
  • Kas koodinäide sisaldab data-api-key ja data-api-url.
  • Üks testküsimus, mis peaks toimima, ja sellele vastav allikaleht.