Liigu põhisisu juurde

Alustamine

Dokumenteeritud paketti kuuluvate lehtede kvoodid on jagatud omaniku projektide vahel. Pakettide kvoote vaadake hinnakirjast ning konto praegust kasutust ja saadaolevat kvooti juhtpaneeli jaotisest Konto ja arveldus.

Looge kasulik vestlusrobot enne, kui selle oma veebisaidil kasutusele võtate. Põhijärjekord on loo → lisa sisu → vaata üle → testi → kohanda → integreeri.

1. Looge konto ja projekt​

Logige sisse ChattyBoxi juhtpaneelile, valige Uus vestlusrobot, andke projektile nimi ning soovi korral lisage Veebisaidi URL. Pärast loomist avaneb projekt vaates Teadmised → Impordi ja värskenda. Kui avate projekti ilma vahekaarti valimata, on vaikevaade Ülevaade. Projekti loomine üksi importimist ei käivita.

Kehtivad projekti-, lehe- ja kasutuspiirangud leiate hinnakirjast.

2. Seadistage sisuallikas​

Avage Teadmised → Impordi ja värskenda, ühendage avalik veebisait, vaadake leitud lehed üle, kohandage soovitatud või enda valikut ning käivitage valitud lehtede importimine või värskendamine. Allikasätete muudatused salvestatakse automaatselt: kontrollige enne jätkamist salvestamise olekut, lahendage valideerimisvead või proovige ebaõnnestunud salvestamist uuesti. Täpsemates allikasätetes on eraldi toiming Kraabi kohe, mis kasutab seadistatud tuvastusrežiimi. Kaasamis-/välistamisreeglid ja crawl-sügavus on saadaval konfiguratsioon koodina kaudu, mitte juhtpaneelil.

ChattyBox eraldab loetava HTML-sisu ja lisab muutunud sisu indekseerimisjärjekorda. Lehtede tuvastamine ja automaatne salvestamine ei käivita iseenesest importimist. Teenus ei renderda JavaScripti ega jõusta robots.txt-i; valige avalikud lehed, mille indekseerimiseks teil on luba, ning määrake käivituse ulatus teadlikult. Ajakulu sõltub tuvastamisest, lehtede arvust ja indekseerimisest.

Kui vajate juhiseid saidikaardi, käsitsi URL-i, roomamise, mitmekeelse sisu või uuesti kraapimise kohta, kasutage lehte Sisu lisamine ja värskendamine.

3. Vaadake indekseeritud sisu üle​

Avage Teadmised → Lehed ja võrrelge tegelikke lehti oodatud allikatega. Avage importimistöö, kontrollige loendusi ja osalise sisu hoiatusi ning enne vastuste hindamist ka eraldi embedding-tööd. Lõpetatud importimine ei taga, et iga soovitud leht või selle jaotis indekseeriti. Vaadake edenemist ja osalist indekseerimist.

4. Testige vastuste kvaliteeti​

Avage Testi vestlusrobotit ja esitage näidisküsimusi, mida päris külastajad kasutavad. Kontrollige, et vastused:

  • kasutaksid indekseeritud dokumentatsiooni, mitte toetamata oletusi;
  • viitaksid kasulikele lähtesisu lehtedele;
  • käsitleksid puuduva teabe korral ettenähtud varulahendust;
  • toimiksid oluliste keelte ja terminoloogiaga.

Kui vastus on nõrk, parandage lähtesisu või lehevalikut ja värskendage seda pärast paketi sageduspiirangu möödumist: Free lubab värskendada kõige rohkem kord nädalas ja tasulised paketid kord päevas. Vaates Testi vestlusrobotit tehtavad testid kasutavad omaniku sõnumikvooti ja vestlused salvestatakse. Testsuhtlused võivad ilmuda analüütikas ning vastuseta küsimusena tuvastatud küsimused sisulünkades; arveldamine ja sisulünga salvestamine sõltuvad tulemusest. Ärge paigaldage vestlusrobotit ainult seetõttu, et esimene importimine lõppes.

5. Viimistlege kasutuskogemust​

Valige või muutke assistendi juhiseid jaotises Kohanda → Käitumine. Saate valida Helpful Assistant, Sales Representative, Technical Support, Sarcastic Bot või Custom Persona. Muudatused salvestatakse automaatselt; kontrollige enne jätkamist salvestamise olekut. Eelseadistuse muutmine lülitab selle olekule Custom. Juhised täiendavad sisseehitatud allikapõhiseid vastamisreegleid; hangitud sisu lisatakse automaatselt, seega ärge kleepige teadmistebaasi prompti. Persona tekst ei asenda puuduva konteksti või sisulünga korral jõustatud varuvastust. Eraldi seade assistant.fallbackMessage on saadaval konfiguratsioon koodina kaudu, mitte Persona vormiväljana. Pärast salvestamist testige nii toetatud küsimusi kui ka varuvastust.

Kui plaanite kasutada hostitud vidinat, vaadake selle pealkirja, tervitussõnumit, värve, ikooni, asukohta ja keelekäitumist jaotises Kohanda → Välimus. Muudatused salvestatakse automaatselt; kontrollige enne jätkamist salvestamise olekut. Režiim Fikseeritud ja skripti ülekirjutused muudavad vidina kasutajaliidese keelt, mitte indekseeritud lehtede keelt; vaadake keele tõrkeotsingut. Free võimaldab stiili muuta, kuid nõuab ChattyBoxi brändingut; Starter ja kõrgemad paketid võimaldavad selle peita.

Tehke need valikud pärast sisu testimist, et visuaalne seadistus ei varjaks otsingu- või dokumentatsiooniprobleeme.

6. Valige integratsioon​

EesmärkJärgmine samm
Laadida ChattyBoxi hallatav kasutajaliides rakendusekoodistJavaScripti SDK
Luua ja hallata oma liidestPeata JavaScripti SDK
Lasta AI-koodiassistendil npm-pakett integreeridaAI abil integreerimine
Hallata projekti konfiguratsiooni Gitist ja CI-stKonfiguratsiooni juurutamine CLI abil
Kasutada hallatavat kasutajaliidest ilma npm-i või ehitusetapitaHostitud vidina skript
Lisada hallatav vidin WordPressi ilma teemafaile muutmataWordPressi plugin
Lisada hallatav vidin Drupal 10 või 11 saidile ComposerigaDrupali moodul

Brauseriintegratsioonid vajavad avalikku vidina API-võtit. Jaotises Paigalda → Veebisaidi paigaldamine valmistage veebisaidi jaoks paigaldus ette või hallake brauseris turvalist võtit jaotises Paigalda → Võtmed ja domeenid. Kontrollige origin’i piiranguid: veebisaidi domeeni jaoks ettevalmistatud võti võib juba olla sellele origin’ile piiratud, samas kui piiranguteta loodud võtmed töötavad kõigist origin’idest. Jaotises Muuda origine saate piirangud valikuliselt sisse lülitada või lisada tootmise, eelvaate, testkeskkonna ja localhosti origin’id. Sisselülitatud piirangu korral peab origin täpselt ühtima skeemi, hostinime ja pordi järgi (näiteks https://example.com ja http://localhost:3000 on eri origin’id). Jaotises Veebisaidi paigaldamine valige võti ja kopeerige loodud koodilõik ning API URL.

Avalikud vidinavõtmed on mõeldud brauserikoodis kuvamiseks. Konfiguratsiooni juurutamise tokenid ja muud halduse juurdepääsuandmed on privaatsed ning neid ei tohi kunagi veebisaidile lisada.

Origin’i piirangud on valikuline lisakaitse, mitte külastajate autentimine. Olemasoleva võtme leidmiseks sisestage jaotises Veebisaidi paigaldamine veebisaidi HTTP(S) URL ja valige võti koodilõigus. Valik näitab aegumata võtmeid, mis on piiranguteta või lubatud selle URL-i origin’i jaoks. Piiratud võtme valimiseks sisestage lubatud origin; piiranguid saate vaadata jaotises Võtmete ja lubatud domeenide haldamine. Kui paigaldusvorm pole saadaval, lõpetage esmalt juhtpaneelil näidatud seadistussamm. Võtme vahetamiseks looge uus võti, uuendage ja testige paigaldust ning kustutage seejärel vana; kustutamine peatab kohe kõik paigaldused, mis seda endiselt kasutavad. Võti kuulub ühele vestlusrobotile — nimi „staging” või „production” ei loo keskkonnapiiri.

7. Kontrollige enne käivitamist​

Paigaldage valitud integratsioon esmalt eelvaate- või testsaidile. Enne laiemat avaldamist testige juurutatud origin’i, marsruutide vahelist navigeerimist, viiteid, varukäitumist, mobiilipaigutust ja brauserikonsooli.

Täitke käivitamise kontrollnimekiri, seejärel kasutage Vestlused → Ajalugu igas paketis ning Vestlused → Analüütika / Vastamata küsimused Pro ja Business pakettides, et päris küsimuste põhjal dokumentatsiooni parandada. Lisateavet leiate lehelt Analüütika ja sisulüngad.

Juhtpaneeli navigeerimine​

Avage projekt aadressil /chatbot/<projectId>. Vaated kasutavad ühes tööruumis URL-i parameetrit tab, mitte eraldi alamlehti:

Vaadetab-i väärtusMida seal teha
ÜlevaadeoverviewVaadake seadistuse edenemist ja hiljutist tegevust
Teadmised → Impordi ja värskendasettingsTuvastage, valige, importige ja värskendage lehti ning muutke allikasätteid
Teadmised → LehedcontentVaadake lehti ja imporditöid, kustutage sisu või looge embedding’ud uuesti
Testi vestlusrobotittestEsitage küsimusi ja naaske salvestatud vestluste juurde
Vestlused → AjalugulogsLugege salvestatud vestlusi ja kustutage üksikuid või kõik vestlused
Vestlused → AnalüütikaanalyticsVaadake viimase 30 päeva salvestatud suhtlusi, kuni 5 000 kirjet; Pro/Business
Vestlused → Vastamata küsimusedgapsVaadake üle ja lahendage tuvastatud vastamata küsimusi; Pro/Business
Kohanda → KäituminepromptsValige või muutke assistendi juhiseid
Kohanda → VälimusappearanceVaadake hostitud vidina välimust ja keelt ning muutke neid
Paigalda → Võtmed ja domeenidkeysLooge/kustutage avalikke võtmeid ja muutke valikulisi origin’i piiranguid
Paigalda → Veebisaidi paigaldamineembedValmistage paigaldus ette ja kopeerige võtmega koodilõik
Vestlusroboti seadedmanageHallake vestlusroboti üksikasju, juurutustokeneid ja konfiguratsioonilukku või kustutage vestlusrobot

Vestlusrobotite loend on aadressil /dashboard, konto ülevaade aadressil /dashboard/overview ja Konto ja arveldus aadressil /settings/account. Aadressid /settings ja /settings/billing suunavad sinna edasi. /settings/keys võimaldab avalike võtmete loomiseks või kustutamiseks projekti valida; valikulisi origin’i piiranguid muudetakse vestlusroboti vaates Võtmed ja domeenid.

Paketid ja piirangud​

PakettVestlusrobotidKonto lehedSõnumeid kuus
Free110100
Starter31501 000
Pro105 00010 000
Business2525 00050 000

Sõnumi- ja salvestatud lehtede limiidid on omaniku kvoodid, mida omanik jagab oma vestlusrobotite vahel, sealhulgas vaates Testi vestlusrobotit tehtavate testide puhul. Lehtede värskendamise kuupõhine töölimiit ja värskenduste sageduspiirangud on eraldi; enne suurt importi või ümberehitust vaadake värskenduslimiite. Vaadake hinnakirjast paketi limiite ning lehelt Konto ja arveldus konto praegust kasutust ja saadaolevat limiiti.

Sõnumite, lehtede ja saitide PAYG on Pro/Business pakettides valikuline ning vaikimisi välja lülitatud. Jaotises Konto ja arveldus seadke funktsioonipõhised kuupõhised ülekulude eelarved või valige selgesõnaliselt Kulupiiranguta. Null-eelarve hoiab vastava funktsiooni kõva limiidi all; kululimiidi puudumine lubab piiramatuid kasutustasusid. PAYG ei ava Free/Starter pakettide funktsioone ega möödu roomaja värskenduste sageduspiirangutest. Profiili nime saab seal muuta; e-posti aadressi hallatakse sisselogimisteenuse pakkuja kontoseadetes.

Õigused ja konfiguratsioonilukk​

Projektile pääseb juhtpaneelil ligi ainult selle omanik (või kasutaja, kes on pärandatud tööruumi omanik). Avalik vidinavõti ei anna juurdepääsu projekti seadetele ega salvestatud vestlusajaloole; üksnes organisatsiooni liikmesus neid projektiõigusi ei anna.

Giti/CI kaudu haldamiseks pakub Vestlusroboti seaded konfiguratsiooni juurutustokeneid, millele saab määrata development-, preview- ja/või production-keskkonna ulatuse, valikulise aegumise ning tühistamise. Erinevalt avalikest vidinavõtmetest kuvatakse juurutustokeni täielik väärtus ainult loomisel. Selles jaotises kuvatakse ka juurutuste ajalugu.

Jaotises Vestlusroboti seaded on konfiguratsiooniluku sisselülitamine pöördumatu. See blokeerib juhtpaneelilt konfiguratsiooni salvestamise ja käsitsi sisutoimingud, sealhulgas Persona salvestamise ning toimingu Kraabi kohe, isegi kui juhtnupp jääb nähtavale. Juurutage konfiguratsioon selle asemel CLI töövoo kaudu. Avalike võtmete haldamine, vestluste kustutamine ja paketiga lubatud brändieelistus jäävad lukustatud konfiguratsiooniväljadest eraldi. Juurutustokeni keskkonnaulatused annavad juurutusõiguse, kuid ei loo eraldi vestlusroboteid ega brauserivõtmete keskkondi.

Konfiguratsioon koodina pakub ka seadet widget.enabled. Selle seadmine väärtusele false keelab avaliku vestluse, sealhulgas headless SDK, mitte ainult ujuva vidina. Praegusel välimuse vormil pole vastavat sisse-/väljalülitamise lülitit.