Neidio i'r prif gynnwys

Datrys problemau

Defnyddiwch y dudalen hon pan fydd y teclyn wedi'i osod ond nid yw'n ymddwyn yn ôl y disgwyl.

Nid yw Widget yn Ymddangos​

Gwiriwch y consol porwr yn gyntaf. Mae ChattyBox yn adrodd ar goll priodoleddau gofynnol yno.

Achosion cyffredin:

  • Nid yw'r sgript yn bresennol yn yr HTML a ddefnyddiwyd nac yn y DOM byw.
  • Ychwanegwyd y sgript at y templed anghywir, gosodiad, cynhwysydd rheolwr tag, neu ardal cod CMS.
  • Mae'r sgript y tu ôl i reol gydsynio neu sbardun rheolwr tag nad oedd yn tanio.
  • Nid yw cydran yr ap sy'n atodi'r loader yn rhedeg ar y llwybr hwnnw.
  • Mae Polisi Diogelwch Cynnwys yn blocio https://chattybox.ai/widget.js.
  • Mae CSS neu declyn arall yn gorgyffwrdd â'r lansiwr.
  • Mae gan y ffurfweddiad a ddefnyddir widget.enabled: false.

Atgyweiriad lleiaf:

  1. Agorwch y dudalen gyhoeddus a ddefnyddir mewn ffenestr anhysbys.
  2. Chwiliwch ffynhonnell y dudalen a phanel Elements am chattybox.ai/widget.js; gall loader SDK neu JavaScript ymddangos yn y DOM byw yn unig.
  3. Cadarnhewch fod y sgript yn ymddangos unwaith ac yn cynnwys data-api-key a data-api-url.
  4. Os yw'r sgript ar goll, symudwch hi i'r troedyn byd-eang, gosodiad yr ap, gwraidd Docusaurus neu sbardun All Pages yn GTM.

Ar gyfer prosiectau a reolir drwy ffurfweddiad, mae widget.enabled: false yn atal y widget a gynhelir rhag cychwyn ac yn peri i geisiadau cyhoeddus POST /chat ddychwelyd 403 Widget is disabled, gan gynnwys ceisiadau'r SDK di-ben. Newidiwch y gosodiad drwy'r llif gwaith defnyddio ffurfweddiad, nid drwy gylchdroi'r allwedd gyhoeddus. Nid yw tynnu sgript y loader ar ôl cychwyn yn tynnu'r widget sydd eisoes wedi'i rendro.

Ar goll data-api-url​

Mae'r teclyn yn gadael yn gynnar pan fydd data-api-url ar goll.

Defnyddiwch y pyt llawn o'r dangosfwrdd neu ychwanegwch y priodoledd gofynnol:

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

Defnyddiwch URL API eich dangosfwrdd yn hytrach na dyfalu. Mewn cynhyrchu, disgwylir URL sefydlog https://...convex.site/chat.

401 Invalid API key cyffredinol​

Am ddiogelwch, mae endpointau API widget yn dychwelyd yr un 401 Invalid API key ar gyfer allwedd anhysbys, wedi dod i ben neu a wrthodwyd yn ôl tarddiad. Peidiwch â dibynnu ar yr ymateb i nodi'r achos.

Achosion cyffredin:

  • Cafodd allwedd y teclyn cyhoeddus ei chopïo'n anghywir.
  • Cafodd yr allwedd ei dileu, ei dirwyn i ben, mae ei phrosiect/perchennog yn cael ei dileu, neu cafodd ei chopïo o deployment backend gwahanol i'r URL API.
  • Mae cyfyngiad tarddiad dewisol wedi'i alluogi ac nid yw tarddiad y safle presennol wedi'i gynnwys.

Atgyweiriadau:

  1. Agorwch y prosiect yn y dangosfwrdd ChattyBox.
  2. Agorwch Gosod → Gosod ar wefan, rhowch URL y wefan a chopïwch ddarn cod cymwys os oes un ar gael.
  3. O dan Allweddi a pharthau ar yr un dudalen, defnyddiwch Golygu tarddiadau ar gyfer yr allwedd yn y darn cod sydd wedi'i osod. Os yw Cyfyngu'r allwedd hon i darddiadau penodol wedi'i alluogi, ychwanegwch yr union darddiad sy'n gwasanaethu'r dudalen, neu analluogwch y cyfyngiad dewisol. Rhaid i gynllun yr URL, enw'r gwesteiwr a'r porth gyfateb: mae https://example.com, https://preview.example.com a http://localhost:3000 yn darddiadau gwahanol. Nid oes angen cofnodion ar wahân ar gyfer llwybrau.
  4. Ail-leoli neu ailgyhoeddi'r wefan a phrofi eto mewn ffenestr anhysbys.

Mae allwedd ddilys ar gyfer sgwrsfot arall ar yr un backend fel arfer yn dewis y sgwrsfot hwnnw yn hytrach na chynhyrchu 401; gwiriwch y prosiect os yw'r atebion yn annisgwyl. Nid yw enwau allweddi fel "production" a "staging" yn gorfodi amgylcheddau. Mae'r API HTTP yn defnyddio pennyn Origin pan fydd yn bresennol; dim ond os yw'n absennol y defnyddir origin y pennyn Referer. Mae allwedd gyfyngedig yn gwrthod y cais os yw'r origin a ddewiswyd ar goll, yn annilys neu heb ei ganiatáu. Ni all origin Referer a ganiateir drechu Origin na chaniateir. Nid yw cyfyngiadau origin yn cymryd lle dilysu ymwelwyr.

Terfynau negeseuon neu gyfradd ceisiadau​

Gwiriwch Account & Billing yn /settings/account am ddefnydd negeseuon, cynllun a chyllidebau PAYG dewisol Pro/Business. Mae Test Chat a'r sgwrs gyhoeddus yn defnyddio lwfans negeseuon cyffredin y perchennog. Nid yw dileu sgyrsiau na chreu allwedd arall yn ailosod y lwfans hwnnw.

Mae gwallau terfyn misol negeseuon a therfynau cyfradd ceisiadau tymor byr yn wahanol. Ar gyfer ymatebion HTTP 429, dilynwch Retry-After os caiff ei anfon, yn hytrach nag ailgeisio dro ar ôl tro. Ar gyfer gwall terfyn misol negeseuon, arhoswch i'r lwfans ailosod neu addaswch y cynllun/cyllideb PAYG gymwys. Hanes sgyrsiau yw Sgyrsiau → Hanes, nid consol gwallau fesul cais; defnyddiwch banel Network y porwr i archwilio methiannau HTTP.

Iaith Anghywir​

Gwiriwch osodiadau iaith y widget yn gyntaf o dan Addasu → Golwg. Mae'r widget a gynhelir yn y ffynhonnell gyfredol yn dewis iaith UI yn y drefn hon:

  1. data-locale ar sgript y widget, dim ond os yw Caniatáu i'r sgript ei wrthwneud wedi'i alluogi a bod y gwerth yn cael ei gefnogi.
  2. Yn y modd Sefydlog, defnyddir yr iaith ddiofyn a ffurfweddwyd.
  3. Yn y modd Canfod yn awtomatig, rhoddir cynnig ar <html lang> y dudalen, yna ymgeiswyr iaith y porwr, ac yna'r iaith ddiofyn a ffurfweddwyd.

Caiff ymgeiswyr heb eu cefnogi eu hepgor. Saesneg yw'r dewis olaf os na chefnogir yr un ymgeisydd; Saesneg yw'r iaith ddiofyn i ddechrau.

Atgyweiriadau:

  • Ar gyfer dewis iaith awtomatig, dewiswch Canfod yn awtomatig a thynnwch werth data-locale anghywir neu analluogwch ddiystyru sgript.
  • Gosodwch <html lang="de">, <html lang="fr">, neu'r cod iaith cyfatebol ar dudalennau lleoledig.
  • I orfodi'r iaith a ffurfweddwyd, dewiswch Sefydlog ac analluogwch Caniatáu i'r sgript ei wrthwneud. Pan fydd diystyru wedi'i alluogi, mae data-locale yn dal i gael blaenoriaeth.
  • Gwiriwch fod y gosodiadau wedi'u cadw ac ailgychwynwch y widget sydd wedi'i osod i ddefnyddio gosodiadau'r dashboard. Gall y widget hostiedig widget.js v16 yn y ffynhonnell gyfredol ddiweddaru labeli'r cynnyrch pan fydd newid i <html lang> neu data-locale y loader yn newid yr iaith a ddatryswyd. Gwiriwch fersiwn y loader a ddefnyddir cyn dibynnu ar ddiweddariadau byw; mae hyn yn wahanol i fersiwn 0.1.4 y cyhoeddiad npm SDK. Mae locale a roddir i mountWidget() yn dod yn data-locale ac yn dilyn yr un polisi prosiect.
  • Os nad yw'r widget ar gael, gwiriwch y cais /widget-config a'r allwedd gyhoeddus. Yn y widget.js v16 hostiedig yn y ffynhonnell gyfredol, mae methiant i nôl y ffurfweddiad yn gadael y widget heb fod ar gael yn hytrach na'i gychwyn gyda gosodiadau diofyn. Gwiriwch fersiwn y loader a ddefnyddir cyn dibynnu ar yr ymddygiad hwn.
  • Nid yw locale UI'r widget yn gorfodi iaith ateb nac yn cyfieithu cynnwys ffynhonnell; mae'r atebwr yn canfod iaith o'r cwestiwn. Mynegeiwch a phrofwch bob fersiwn iaith sydd ei hangen os yw atebion yn defnyddio cynnwys yn yr iaith anghywir. Os nad yw assistant.fallbackMessage wedi'i addasu drwy config-as-code, mae'r ymateb wrth gefn ar gyfer cynnwys coll, pan gaiff ei sbarduno, yn defnyddio'r iaith a ganfyddir yn y cwestiwn pan fo hynny'n briodol; os yw canfod iaith yn ansicr, defnyddir locale UI y widget, a Saesneg yw'r dewis olaf yn unig.

Dim Dyfyniadau nac Atebion Gwan​

Mae ChattyBox yn defnyddio cynnwys ffynhonnell a adalwyd i gynhyrchu atebion. Gall dyfyniadau coll neu atebion gwan ddeillio o gynnwys ffynhonnell coll neu anaddas, problemau adalw neu fethiannau cynhyrchu; nid ydynt ar eu pen eu hunain yn nodi'r achos.

Mae chatbot RAG wedi'i seilio ar ffynonellau yn elwa ar gynnwys ffynhonnell clir a adalwyd, ond nid yw dyfyniad ar ei ben ei hun yn gwirio ateb. Cymharwch bob honiad pwysig â'r dudalen a ddyfynnir.

Atgyweiriadau:

  • Gofynnwch yr un cwestiwn yn y sgwrs prawf dangosfwrdd a chymharwch y tudalennau a ddyfynnwyd.
  • Sicrhewch fod y dudalen ffynhonnell yn gyhoeddus ac wedi'i chynnwys yn y cropian.
  • Ychwanegu penawdau clir, enghreifftiau, Cwestiynau Cyffredin, a thestun ateb uniongyrchol i'r dudalen ffynhonnell.
  • Peidiwch â dibynnu ar sgrinluniau, fideos, marcio cudd a eithrir, cynnwys JavaScript yn unig neu iframes fel yr unig ffynhonnell.
  • Ail-sgrapiwch y dudalen wedi'i diweddaru pan fo'r cyfnod aros yn caniatáu, arhoswch i'r gwaith embeddings orffen, yna profwch eto.
  • Gwiriwch rybuddion Wedi’i fynegeio’n rhannol: ni chaiff testun y tu hwnt i'r terfyn 512 KiB fesul tudalen ei gadw. Rhannwch dudalennau ffynhonnell hir yn rhai llai yn hytrach nag ailadeiladu'r un testun sydd wedi'i dorri dro ar ôl tro.
  • Gwnewch bob cwestiwn yn glir ac yn hunangynhwysol pan fo modd. Gall yr atebwr dderbyn hyd at 12 o negeseuon diweddar sydd wedi'u cadw, hyd at 2,000 nod yr un; nid yw'n derbyn trawsgrifiad llawn y sgwrs.

Mae Persona yn ychwanegu cyfarwyddiadau sy'n benodol i'r safle at reolau seilio ar ffynonellau sydd eisoes yn bodoli; ni all ddarparu cynnwys coll sydd wedi'i fynegeio na disodli'r ymateb wrth gefn ar gyfer cyd-destun coll neu fwlch cynnwys pan gaiff ei sbarduno. Mae'r synhwyrydd bylchau cynnwys yn defnyddio heuristeg ac efallai na fydd yn canfod pob ateb heb gefnogaeth. Mae gan yr ymateb hwnnw osodiad assistant.fallbackMessage ar wahân mewn ffurfweddu fel cod.

Tudalennau Heb eu Crafu neu Hen Gynnwys​

Achosion cyffredin:

  • Mae'r dudalen ar goll o'r map gwefan a gyflwynwyd.
  • Nid oedd modd URL â llaw yn cynnwys y dudalen.
  • Mae'r dudalen yn blocio nôl HTML cyffredin, yn gofyn am fewngofnodi/CAPTCHA, yn ailgyfeirio i darged wedi'i flocio, neu cafodd ei hidlo neu aeth dros gyllideb.
  • Newidiodd cynnwys y dudalen ar ôl y sgrapio diwethaf.
  • Mae'r cynnwys ar gael trwy JavaScript yn unig neu y tu allan i'r gwreiddyn cynnwys semantig a ddewiswyd.

Atgyweiriadau:

  1. Cadarnhewch fod y dudalen yn agor yn gyhoeddus mewn ffenestr porwr preifat.
  2. Defnyddiwch y modd map gwefan ar gyfer sylw eang neu URLau â llaw ar gyfer set wedi'i churadu.
  3. Cyflwyno'r URL canonaidd yn hytrach nag URL olrhain, ailgyfeirio URL, neu URL mewngofnodi.
  4. Ail-sgrapiwch ar ôl cyhoeddi newidiadau ac ar ôl y cyfnod aros: o leiaf 7 diwrnod ers creu'r swydd ddiweddaraf ar Free neu 24 awr ar gynlluniau taledig, hyd yn oed os methodd y swydd honno.
  5. Yn Gwybodaeth → Tudalennau, ehangwch Hanes mewnforio pan fydd tasgau'n bodoli a dewiswch dasg o dan Tasgau sgrapio. Cymharwch ei chyfrifon tudalennau a gadwyd/dewiswyd a'r rhestr Tudalennau â'r URLau a fwriadwyd. Gall Wedi cwblhau gynnwys URLau a hepgorwyd neu a fethodd; mae Wedi’i gwblhau gyda rhybuddion yn dynodi testun tudalen a gadwyd yn rhannol yn benodol, nid pob methiant crawl. Nid yw'r rhyngwyneb yn darparu rhestr gyflawn o fethiannau fesul URL.

Nid yw ChattyBox yn gorfodi cyfarwyddebau crawl robots.txt, ond gall ddarllen y ffeil i ddod o hyd i ddatganiadau sitemap. Peidiwch â thrin robots.txt fel rheolaeth mynediad. Mae'n dilyn ailgyfeiriadau HTTP diogel, felly nid yw ailgyfeiriad ar ei ben ei hun yn fethiant. Peidiwch â dileu amddiffyniadau mynediad na rhoi cynnwys preifat ar URL cyhoeddus er mwyn ei wneud yn crawladwy. Nid yw'r crawler yn rhedeg JavaScript. Os tynnwyd URL o'r wefan neu'r dewis ffynhonnell, mae'n bosibl y bydd y dudalen sydd wedi'i chadw'n dal i gael ei defnyddio; dilëwch hi o Gwybodaeth → Tudalennau hefyd a'i heithrio o ddarganfod yn y dyfodol. Mae Ailadeiladu'r mynegai yn defnyddio testun sydd wedi'i gadw, nid fetch rhwydwaith newydd. Mae ganddo ei cooldown ei hun yn ôl y cynllun ac mae'n defnyddio'r gyllideb adnewyddu tudalennau fisol a rennir.

Ni fydd gosodiadau'n cael eu cadw​

Mae newidiadau i fanylion y sgwrsfot a gosodiadau ffynhonnell yn cael eu cadw'n awtomatig. Gwiriwch statws y cadw a datryswch wallau dilysu neu rhowch gynnig arall ar gadw a fethodd. Mae angen Website URL wedi'i gadw ar y dashboard hyd yn oed wrth ddefnyddio Manual URLs. Nid yw darganfod ac awtogadw yn dechrau mewnforio; adolygwch y tudalennau a ddewiswyd a dechreuwch y mewnforio'n benodol.

Os yw'r prosiect yn Config locked, rhaid defnyddio'r ffurfweddiad drwy'r llif gwaith CLI. Ni ellir dadwneud y clo; gwrthodir cadw Persona, ffurfweddiad scraping, Scrape Now, dileu cynnwys ac ailadeiladu'r mynegai hyd yn oed os yw rheolydd yn dal yn weladwy. Dim ond y dewis brandio sy'n parhau'n olygadwy o'r dashboard o fewn ffurfweddiad y widget hostiedig, yn amodol ar y cynllun. Mae allweddi widget cyhoeddus a thocynnau deployment yn gymwysterau ar wahân.

Os yw prosiect ar goll neu os gwrthodir mynediad, gwiriwch eich bod wedi mewngofnodi fel ei berchennog. Nid yw allwedd widget, tocyn deployment nac aelodaeth sefydliad yn rhoi caniatâd perchnogaeth dashboard. O dan Sgyrsiau, mae Dadansoddeg a Cwestiynau heb eu hateb wedi'u cynnwys gyda Pro a Business; mae gweddau nad ydynt ar gael yn dangos neges uwchraddio. Mae Hanes ar gael ar bob cynllun.

Dal yn Sownd​

Casglwch y manylion hyn cyn cysylltu â chymorth:

  • URL y dudalen gyhoeddus lle dylai'r teclyn ymddangos.
  • Ciplun neu gopi o unrhyw wall consol porwr.
  • A yw'r dudalen yn defnyddio HTML plaen, Next.js, Docusaurus, WordPress, a CMS, neu Google Tag Manager.
  • A yw'r pyt yn cynnwys data-api-key a data-api-url.
  • Un cwestiwn prawf a ddylai weithio a'r dudalen ffynhonnell sy'n ei ateb.