Dechrau Arni
Rhennir y lwfansau dogfenedig ar gyfer tudalennau a gynhwysir rhwng prosiectau perchennog. Gweler brisiau am lwfansau'r cynlluniau a Cyfrif a Bilio yn y dangosfwrdd am ddefnydd cyfredol eich cyfrif a'r lwfans sydd ar gael.
Adeiladwch chatbot defnyddiol cyn ei roi ar eich gwefan. Y dilyniant craidd yw creu → ychwanegu cynnwys → adolygu → profi → addasu → integreiddio.
1. Creu Cyfrif a Phrosiect
Mewngofnodwch i ddangosfwrdd ChattyBox, dewiswch Sgwrsfot newydd, a rhowch enw a URL y wefan dewisol i’r prosiect. Ar ôl creu’r prosiect, mae Gwybodaeth → Mewnforio ac adnewyddu yn agor. Os agorwch brosiect heb ddewis tab, Trosolwg yw’r tab diofyn. Nid yw creu’r prosiect ar ei ben ei hun yn dechrau mewnforio.
Gweler brisiau am derfynau cyfredol prosiectau, tudalennau a defnydd.
2. Ffurfweddu Eich Ffynhonnell Gynnwys
Yn Gwybodaeth → Mewnforio ac adnewyddu, cysylltwch y wefan gyhoeddus, adolygwch y tudalennau a ddarganfuwyd, addaswch y detholiad a argymhellir neu un personol, a dechreuwch fewnforio neu adnewyddu’r tudalennau a ddewiswyd. Caiff newidiadau i osodiadau’r ffynhonnell eu cadw’n awtomatig: gwiriwch statws cadw ac atgyweiriwch wallau dilysu neu rhowch gynnig arall ar gadw a fethodd cyn parhau. Mae gosodiadau ffynhonnell uwch hefyd yn cynnig gweithred Sgrapio nawr ar wahân sy’n defnyddio’r modd darganfod sydd wedi’i ffurfweddu. Mae rheolau cynnwys/eithrio a dyfnder cropian ar gael drwy ffurfweddiad fel cod, nid rheolyddion y dangosfwrdd.
Mae ChattyBox yn echdynnu cynnwys HTML darllenadwy ac yn ciwio cynnwys sydd wedi newid i’w fynegeio. Nid yw darganfod ac awtogadw yn dechrau’r mewnforio eu hunain. Nid yw’n rendro JavaScript nac yn gorfodi robots.txt; defnyddiwch dudalennau cyhoeddus y mae gennych hawl i’w mynegeio a dewiswch gwmpas y lansiad yn fwriadol. Mae’r amseru’n dibynnu ar ddarganfod, nifer y tudalennau a’r gwaith mynegeio.
Defnyddiwch Ychwanegu ac adnewyddu cynnwys pan fydd angen arweiniad ar fapiau gwefan, URLau llaw, cropian, cynnwys amlieithog, neu ail-sgrapio arnoch.
3. Adolygu Cynnwys Wedi’i Fynegeio
Agorwch Gwybodaeth → Tudalennau a chymharwch y tudalennau gwirioneddol â’ch ffynonellau disgwyliedig. Agorwch y swydd scrape i adolygu cyfrifon a rhybuddion cynnwys rhannol, a gwiriwch y swydd embeddings ar wahân cyn gwerthuso atebion. Nid yw scrape wedi’i gwblhau yn gwarantu bod pob tudalen neu bob adran y gofynnwyd amdani wedi’i mynegeio. Gweler cynnydd a mynegeio rhannol.
4. Profi Ansawdd Atebion
Agorwch Profi'r sgwrsfot a gofynnwch gwestiynau cynrychioliadol y bydd ymwelwyr go iawn yn eu defnyddio. Gwiriwch fod atebion:
- yn defnyddio’r ddogfennaeth a fynegeiwyd yn hytrach na thybiaethau heb gefnogaeth;
- yn cysylltu â thudalennau ffynhonnell defnyddiol;
- yn delio â gwybodaeth goll gan ddefnyddio’r ymddygiad wrth gefn bwriadedig;
- yn gweithio ar gyfer ieithoedd a therminoleg bwysig.
Gwellwch y cynnwys neu’r dewis ffynhonnell ac adnewyddwch eto pan fydd cooldown y cynllun yn caniatáu: dim mwy nag unwaith yr wythnos ar Free ac unwaith y dydd ar gynlluniau taledig. Mae Profi'r sgwrsfot yn defnyddio lwfans negeseuon y perchennog ac yn cadw sgyrsiau. Gall rhyngweithiadau prawf ymddangos yn Sgyrsiau → Dadansoddeg ac, os cânt eu canfod yn ddi-ateb, yn Sgyrsiau → Cwestiynau heb eu hateb; mae bilio a chofnodi bylchau yn dibynnu ar y canlyniad. Peidiwch â gosod y chatbot dim ond am fod y mewnforio cyntaf wedi’i gwblhau.
5. Mireinio’r Profiad
Yn Addasu → Ymddygiad, dewiswch Cynorthwyydd defnyddiol, Cynrychiolydd gwerthu, Cymorth technegol, Bot coeglyd neu Persona personol a golygwch y cyfarwyddiadau. Caiff newidiadau eu cadw’n awtomatig; gwiriwch y statws cadw cyn parhau. Mae golygu rhagosodiad yn newid y dewis i Persona personol. Mae’r cyfarwyddiadau’n ategu rheolau sylfaenu a fformatio ChattyBox; ychwanegir cynnwys a adferir yn awtomatig, felly peidiwch â gludo’ch sylfaen wybodaeth i’r anogwr.
Nid yw testun Persona yn disodli’r fallback gorfodedig ar gyfer cyd-destun/cynnwys coll. Mae’r gosodiad ar wahân assistant.fallbackMessage ar gael drwy ffurfweddiad fel cod, nid maes Persona. Profwch gwestiynau a gefnogir ac ymddygiad fallback ar ôl cadw.
Os ydych yn bwriadu defnyddio’r widget lletyol, agorwch Addasu → Golwg i ragweld teitl, neges groeso, lliwiau, eicon, safle ac ymddygiad iaith y widget. Caiff newidiadau eu cadw’n awtomatig; gwiriwch y statws cadw. Mae modd Sefydlog a diystyriadau sgript yn effeithio ar iaith UI y widget, nid ar iaith y tudalennau a fynegeir; gweler datrys problemau iaith. Mae Free yn cynnwys arddullio ond rhaid cadw brandio ChattyBox; gall Starter ac uwch ei guddio.
Daw’r dewisiadau hyn ar ôl profi’r cynnwys, fel na fydd gosodiad gweledol yn cuddio problemau adalw neu ddogfennaeth.
6. Dewis Integreiddiad
| Nod | Cam nesaf |
|---|---|
| Atodi rhyngwyneb ChattyBox a gynhelir o god eich rhaglen | SDK JavaScript |
| Adeiladu a chynnal eich rhyngwyneb eich hun | SDK JavaScript di-ben |
| Gadael i gynorthwyydd codio AI integreiddio’r pecyn npm | Integreiddiad gyda chymorth AI |
| Rheoli ffurfweddiad y prosiect o Git a CI | CLI a defnyddio ffurfweddiad |
| Defnyddio’r rhyngwyneb a gynhelir heb npm na cham adeiladu | Sgript widget lletyol |
| Ychwanegu’r widget a gynhelir at WordPress heb olygu’r thema | Ategyn WordPress |
| Ychwanegu’r widget a gynhelir at Drupal 10 neu 11 gyda Composer | Modiwl Drupal |
Mae angen allwedd API widget gyhoeddus ar integreiddiadau porwr. Gwiriwch osodiadau tarddiad yr allwedd: gall allwedd a baratowyd ar gyfer gwefan fod eisoes wedi’i chyfyngu i’r tarddiad hwnnw, tra bo allweddi heb gyfyngiadau’n gweithio ar draws tarddiadau. O dan Gosod → Allweddi a pharthau, defnyddiwch Golygu tarddiadau i reoli cyfyngiadau dewisol ac ychwanegu’r tarddiadau cynhyrchu, rhagolwg, llwyfannu a localhost sydd eu hangen arnoch. Mae tarddiadau cyfyngedig yn cyfateb yn union yn ôl cynllun, enw gwesteiwr a phorth (er enghraifft, mae https://example.com a http://localhost:3000 yn darddiadau gwahanol). O dan Gosod ar wefan, dewiswch yr allwedd a chopïwch y pyt a’r URL API a gynhyrchir.
Mae allweddi widget cyhoeddus wedi’u cynllunio i ymddangos mewn cod porwr. Mae tocynnau defnyddio cyfluniad a manylion rheoli eraill yn breifat ac ni ddylid byth eu hychwanegu at wefan. Caledu dewisol yw cyfyngiadau tarddiad, nid dilysu ymwelwyr.
I adfer allwedd gyhoeddus sy’n bodoli eisoes, rhowch URL gwefan HTTP(S) o dan Gosod ar wefan a dewiswch yr allwedd yn y pyt. Mae’r dewiswr yn cynnig allweddi sydd heb ddod i ben ac sydd naill ai heb gyfyngiad neu wedi’u caniatáu ar gyfer tarddiad yr URL. I ddewis allwedd gyfyngedig, rhowch darddiad a ganiateir; defnyddiwch Rheoli allweddi a pharthau a ganiateir i archwilio ei chyfyngiadau. Os nad yw’r ffurflen gosod ar gael, cwblhewch y cam paratoi a ddangosir yn y dangosfwrdd yn gyntaf. I’w chylchdroi, crëwch allwedd newydd, diweddarwch a phrofwch eich gosodiad, ac yna dileuwch yr hen allwedd. Mae dileu’n atal gosodiadau sy’n dal i’w defnyddio ar unwaith. Mae allwedd yn perthyn i un sgwrsfot; nid yw ei henwi’n "staging" neu’n "production" yn gorfodi ffin amgylchedd.
7. Dilysu Cyn Lansio
Gosodwch yr integreiddiad a ddewiswyd ar wefan ragolwg neu lwyfannu yn gyntaf. Profwch y tarddiad a ddefnyddir, llywio rhwng llwybrau, dyfyniadau, ymddygiad wrth gefn, cynllun symudol a chonsol y porwr cyn cyhoeddi’n eang.
Cwblhewch y rhestr wirio lansio, yna defnyddiwch Sgyrsiau → Hanes ar bob cynllun a Sgyrsiau → Dadansoddeg a Cwestiynau heb eu hateb ar Pro/Business i wella’r ddogfennaeth ar ôl i gwestiynau go iawn gyrraedd.
Map y dangosfwrdd
Agorwch brosiect yn /chatbot/<projectId>. Mae tabiau’n defnyddio’r paramedr ymholiad tab, nid is-dudalennau ar wahân:
| Golwg gweithle | Gwerth tab | Beth i’w wneud yno |
|---|---|---|
| Trosolwg | overview | Adolygu cynnydd y gosodiad a gweithgarwch diweddar |
| Gwybodaeth → Mewnforio ac adnewyddu | settings | Darganfod, dewis, mewnforio ac adnewyddu tudalennau; addasu gosodiadau’r ffynhonnell |
| Gwybodaeth → Tudalennau | content | Adolygu tudalennau a swyddi scrape, dileu cynnwys ac ailadeiladu embeddings |
| Profi'r sgwrsfot | test | Gofyn cwestiynau ac ailymweld â sgyrsiau sydd wedi’u cadw |
| Sgyrsiau → Hanes | logs | Darllen sgyrsiau sydd wedi’u cadw a dileu sgyrsiau unigol neu’r cyfan |
| Sgyrsiau → Dadansoddeg | analytics | Adolygu rhyngweithiadau cofnodedig y 30 diwrnod diwethaf, hyd at 5,000 cofnod; Pro/Business |
| Sgyrsiau → Cwestiynau heb eu hateb | gaps | Adolygu a datrys cwestiynau heb eu hateb a ganfuwyd; Pro/Business |
| Addasu → Ymddygiad | prompts | Dewis neu olygu cyfarwyddiadau’r cynorthwyydd |
| Addasu → Golwg | appearance | Rhagweld ac addasu golwg ac iaith y widget lletyol |
| Gosod → Allweddi a pharthau | keys | Creu/dileu allweddi widget cyhoeddus a golygu cyfyngiadau tarddiad dewisol |
| Gosod → Gosod ar wefan | embed | Paratoi gosodiad a chopïo pyt allwedd |
| Gosodiadau'r sgwrsfot | manage | Rheoli manylion y sgwrsfot, tocynnau defnyddio a chlo config, neu ddileu’r sgwrsfot |
Mae Pob sgwrsfot yn dychwelyd i /dashboard. Mae trosolwg y cyfrif yn /dashboard/overview; mae Cyfrif a Bilio yn /settings/account, gyda phroffil, cynllun, defnydd negeseuon, porth bilio a rheolyddion PAYG. Mae /settings a /settings/billing yn ailgyfeirio yno. Mae gan /settings/keys ddewiswr prosiect ar gyfer creu/dileu allweddi cyhoeddus; golygir cyfyngiadau tarddiad dewisol yng ngolwg Allweddi a pharthau y sgwrsfot.
Caniatâd a chlo config
Perchennog yn unig sydd â mynediad i brosiect drwy’r dangosfwrdd (neu’r defnyddiwr sy’n berchen ar weithle etifeddol). Nid yw allwedd widget gyhoeddus yn rhoi mynediad i osodiadau’r prosiect na hanes sgyrsiau sydd wedi’u storio; nid yw aelodaeth sefydliad ar ei phen ei hun yn rhoi’r caniatâd prosiect hwn.
Ar gyfer rheoli Git/CI, mae Gosodiadau'r sgwrsfot yn darparu tocynnau defnyddio config gyda chwmpas datblygu, rhagolwg a/neu gynhyrchu, terfyn amser dewisol a’r gallu i’w dirymu. Yn wahanol i allweddi widget cyhoeddus, dim ond wrth greu y dangosir gwerth llawn tocyn defnyddio. Mae’r adran hefyd yn dangos hanes defnyddio.
Mae’r weithred Galluogi clo ffurfweddiad yn anghildroadwy. Mae’n blocio ysgrifennu ffurfweddiad o’r dangosfwrdd a gweithrediadau cynnwys â llaw, gan gynnwys cadw Persona a rhedeg Sgrapio nawr, hyd yn oed os yw rheolydd yn dal i’w weld. Defnyddiwch y llif gwaith CLI i ddefnyddio ffurfweddiad yn lle hynny. Mae rheoli allweddi cyhoeddus, glanhau sgyrsiau a’r dewis brandio a ganiateir gan y cynllun yn parhau ar wahân i’r meysydd ffurfweddu sydd wedi’u cloi. Nid yw cwmpasau amgylchedd tocynnau’n creu sgwrsfotau neu amgylcheddau allweddi porwr ar wahân.
Mae ffurfweddiad fel cod hefyd yn datgelu widget.enabled. Mae ei osod i false yn analluogi sgwrs gyhoeddus, gan gynnwys y SDK di-ben, nid y widget arnofiol yn unig. Nid oes switsh galluogi/analluogi cyfatebol yn y ffurflen olwg gyfredol.
Cynlluniau a chyllidebau
| Cynllun | Sgwrsfotau | Tudalennau sydd wedi’u cynnwys | Negeseuon y mis |
|---|---|---|---|
| Free | 1 | 10 | 100 |
| Starter | 3 | 150 | 1,000 |
| Pro | 10 | 5,000 | 10,000 |
| Business | 25 | 25,000 | 50,000 |
Mae negeseuon a thudalennau wedi’u storio sydd wedi’u cynnwys yn lwfansau lefel perchennog a rennir gan sgwrsfotau’r perchennog, gan gynnwys Profi'r sgwrsfot. Mae gwaith adnewyddu tudalennau misol a cooldowns adnewyddu’n derfynau ar wahân; darllenwch am gyllidebau adnewyddu cyn mewnforio neu ailadeiladu’n fawr. Gweler brisiau am lwfansau cynllun a rennir wedi’u dogfennu a Cyfrif a Bilio am ddefnydd cyfredol y cyfrif a’r lwfans sydd ar gael.
Mae PAYG ar gyfer negeseuon, tudalennau a gwefannau’n ddewisol ar Pro/Business ac wedi’i ddiffodd yn ddiofyn. Yn Cyfrif a Bilio, gosodwch gyllidebau gor-ddefnyddio misol fesul nodwedd neu dewiswch Dim cap gwariant yn benodol. Mae cyllideb sero yn cadw terfyn caled ar y nodwedd honno; mae Dim cap gwariant yn caniatáu costau defnydd heb derfyn. Nid yw PAYG yn datgloi nodweddion ar Free/Starter nac yn osgoi cooldowns adnewyddu’r crawler. Gellir golygu enw'r proffil yno; rheolir e-bost drwy osodiadau cyfrif eich darparwr mewngofnodi.