Kaj je baza znanja?
Baza znanja za AI agenta je v Koliu en strukturiran dokument z dejstvi o vašem podjetju, ki ga AI zgradi iz vaših virov ali ga napišete ročno in ki ga agent dobi v vsakem pogovoru.
Bazo znanja urejate v AI pomočniki → Baza znanja (dovoljenje baza-znanja). Stran ima tri dele: dodajanje virov (Spletna stran, XML sitemap, PDF dokument), kartico Zgrajena baza znanja z gumbom Zgradi oziroma Osveži ter urejevalnik z Zgodovina verzij. Aktivna je vedno najnovejša verzija.
Kako baza znanja pride do agenta
Aktivna verzija baze znanja se ob vsakem pogovoru vstavi v navodila agenta na mesto ograjevalnika {{BAZA_ZNANJA}} (glej Navodila za agenta). Poleg tega ima agent orodje search_knowledge_base, ki za vprašanje stranke poišče do 3 najustreznejše razdelke baze (največ 1 500 znakov) po ključnih besedah — brez vektorskih vdelav, ker gre za en dokument na račun.
Kateri viri so na voljo?
Baza znanja v Koliu nastane iz treh vrst virov: zajete spletne strani, PDF dokumenta in ročno napisanega ali popravljenega besedila. Spletna stran in PDF sta »viri« na seznamu Viri, iz katerih AI zgradi bazo; ročno besedilo vpišete neposredno v urejevalnik.
| Vir | Kako ga dodate | Stanje |
|---|---|---|
| Spletna stran | Spletna stran → vpišite URL (lastna ali tuja domena, npr. navodila proizvajalca) → izberite Samo ta stran ali Tudi najdene podstrani → Preveri → označite strani → Prenesi izbrane | deluje; virov je lahko več |
| XML sitemap | XML sitemap → vpišite naslov sitemapa (npr. https://podjetje.si/sitemap.xml; podprto tudi kazalo sitemapov in .xml.gz) → Preveri → označite strani → Prenesi izbrane | Kolio našteje vse URL-je iz sitemapa brez sledenja povezavam; prenese samo označene, v seznamu virov pokaže »izbranih X od Y najdenih« |
| PDF dokument | PDF dokument → Naloži PDF (največ 20 MB, samo PDF z besedilno plastjo) | Kolio datoteko preveri, iz nje izlušči besedilo in vir doda na seznam; skenirani PDF brez besedila je zavrnjen |
| Ročno besedilo | Urejanje baze znanja → vpišite ali popravite Vsebina → Shrani novo verzijo | deluje; brez virov lahko celotno bazo napišete ročno |
Skupna velikost vseh virov je omejena na 20 MB; porabo kaže vrstica »Porabljeno … od 20 MB« pod seznamom virov.
Kako Kolio zajame spletno stran?
Kolio spletne strani ne prehodi slepo: najprej prebere kazalo strani (sitemap), nato kandidate razvrsti po koristnosti za pogovor s strankami in zajame največ 15 strani z največ 12 000 znaki besedila na stran. Strani z dejstvi imajo prednost pred katalogom, tujejezične različice in nakupovalne poti pa se preskočijo.
- Sitemap ima prednost. Kolio poišče kazalo v
robots.txt(vrsticaSitemap:), na/sitemap.xmlin/sitemap_index.xml; prebere največ 5 datotek kazala in oceni največ 5 000 naslovov. Kadar kazala ni, kandidati pridejo iz povezav, odkritih med obiskom (BFS). - Razvrščanje po koristnosti. Vsak naslov dobi oceno: zadetki vzorcev z dejstvi (o nas, kontakt, dostava, plačilo, reklamacije in vračila, garancija, pogoji, pogosta vprašanja, delovni čas, storitve, cenik, lokacije, povpraševanje) prinesejo velik bonus, strani prve ravni (
/kontakt) pavšalni bonus, globoke podstrani in poizvedbeni parametri pa odbitek. Vstopni URL je vedno prvi. - Preskok neuporabnih strani. Košarica, blagajna, prijava, iskanje, kategorije in oznake, posamezni izdelki (
/izdelek/…,/product/…), letni arhivi bloga, avtorji in sistemske poti (/wp-json,/feed) se ne zajemajo; enako poti z jezikovno predpono (/en/,/de/,/hr/…), ker so za agenta podvojena vsebina v drugem jeziku. - Meja 15 strani. Kadar je spletišče večje, oznaka vira pove, da gre za »prvih 15 strani«, in pod virom je seznam Zajete strani. Zajem se konča z napako, če na strani ni vsaj 50 znakov uporabnega besedila.
Kako zgradite bazo znanja?
Gradnja baze znanja v Koliu iz vseh virov z besedilom naredi en strukturiran dokument: AI iz virov izlušči dejstva, koristna za pogovor s strankami (ponudba, postopki, pogoji, delovni čas, lokacije, kontakt, pogosta vprašanja), in odstrani navigacijo, gumbe, obvestila o piškotkih in marketinško besedilo. Rezultat se shrani kot nova verzija z izvorom zgrajeno z AI.
Dodajte vir
V razdelku Spletna stran vpišite naslov spletišča (na primer
AI pomočniki → Baza znanja → Spletna stranhttps://www.vase-podjetje.si) in kliknite Zajemi vsebino. Vir se najprej pokaže v stanju čakanja, po zajemu pa z oznako števila strani; ob napaki je pod virom izpisan vzrok.Preverite zajete strani
Razprite Zajete strani pod virom. Če manjka pomembna podstran, jo dodajte kot ločen vir; če se več virov nanaša na isto spletišče, se pokaže opozorilo Viri se prekrivajo.
Zgradite bazo
V kartici Zgrajena baza znanja kliknite Zgradi (pri obstoječi bazi Osveži). Gradnja traja od nekaj sekund do približno minute, odvisno od števila virov (vsaki 4 viri pomenijo en klic modela). Ob napaki se izpiše Gradnja ni uspela z vzrokom.
AI pomočniki → Baza znanja → Zgrajena baza znanja → ZgradiPreglejte in popravite
V urejevalniku preberite zgrajeno vsebino. Manjkajoče ali napačne podatke popravite in shranite z Shrani novo verzijo (izvor ročno urejeno). Meta vrstica pove število znakov, število virov in datum gradnje.
Preizkusite v simulatorju
V AI pomočniki → Klicni simulator postavite vprašanja o ceni, delovnem času in lokaciji. Odgovori morajo priti iz baze; na vprašanje brez odgovora mora agent ponuditi predajo vaši ekipi.
AI pomočniki → Klicni simulator
Kaj se med gradnjo zgodi s podvojenimi stranmi
Pred pošiljanjem v AI Kolio odstrani strani, ki se ponovijo v več virih — po naslovu URL, pri starejših zapisih pa po podpisu vsebine (prvih 2 000 znakov). Obdrži prvi pojav; vir, ki po tem ostane brez strani, izpade. Število virov po tem koraku določa ceno gradnje, število unikatnih strani pa je zapisano pri verziji.
Gradnja teče po skupinah: po 4 viri na en klic modela, iz vsakega vira največ 16 000 znakov besedila; če nastane več delnih povzetkov, jih drugi klic združi v en dokument. Vsi klici ene gradnje so v pregledu Poraba ena skupina.
Kako urejate bazo in obnovite starejšo verzijo?
Vsaka sprememba baze znanja v Koliu je nova verzija: gradnja ustvari verzijo z izvorom zgrajeno z AI, shranjevanje v urejevalniku verzijo ročno urejeno, obnovitev pa staro vsebino zapiše kot novo verzijo. Zgodovina se nikoli ne briše in nikoli ne prepisuje.
| Dejanje | Kje | Kaj nastane |
|---|---|---|
| Gradnja / osvežitev | Zgrajena baza znanja → Zgradi / Osveži | nova verzija zgrajeno z AI; nadomesti ročne popravke (stara verzija ostane v zgodovini) |
| Ročni popravek | Urejanje baze znanja → Vsebina + Opomba k verziji → Shrani novo verzijo | nova verzija ročno urejeno; najmanj 20 in največ 200 000 znakov |
| Razveljavitev neshranjenih sprememb | Razveljavi spremembe | urejevalnik se vrne na aktivno verzijo, nič se ne shrani |
| Obnovitev | Zgodovina verzij → Obnovi pri izbrani verziji | nova verzija ročno urejeno z opombo »Obnovljena verzija z dne …«; zgodovina se ne izgubi |
V zgodovini je prikazanih zadnjih 10 verzij z datumom, izvorom, opombo, številom znakov in e-naslovom osebe, ki jo je shranila.
Kako se gradnja šteje v kredite?
Gradnja baze znanja v Koliu stane 50 kreditov na vsakih začetih 10 virov (po odstranitvi podvojenih strani) in se zaračuna enkrat na gradnjo, ne glede na število klicev modela v njej. Zajem spletne strani, ročno urejanje in obnovitev verzije kreditov ne porabijo.
| Virov v gradnji | Krediti na gradnjo | Primer: vključeni krediti paketa |
|---|---|---|
| 1–10 | 50 | Poskusno obdobje: 250 kreditov → do 5 gradenj, če ni druge porabe |
| 11–20 | 100 | Zagon: 2 500 kreditov na mesec |
| 21–30 | 150 | Rast: 10 000 kreditov na mesec |
Vključeni krediti paketov so iz cenika Kolia; celoten pregled porabe je v Poraba in naročnina.
Kadar so krediti izčrpani, gradnja ni mogoča in gumb vrne napako s kodo quota_credits; agent v tem času deluje v omejenem načinu (sprejema le sporočila). Kredite dokupite ali počakate na novo obračunsko obdobje — glej Naročnina.
Omejitve in kaj se zgodi, ko jih presežete
Omejitve baze znanja v Koliu so določene v kodi in enake v vseh paketih: 20 MB skupne velikosti virov, 15 strani na spletni vir, 12 000 znakov na stran pri zajemu, 16 000 znakov na vir pri gradnji in 200 000 znakov ročno urejene vsebine. Število virov samo po sebi ni omejeno.
| Omejitev | Vrednost | Kaj se zgodi ob preseganju |
|---|---|---|
| Skupna velikost virov | 20 MB (besedilo v UTF-8) | nov vir se zavrne z napako »Preseženo skupno omejitev virov (max 20 MB)«; izbrišite odvečne vire |
| Posamezen PDF | 20 MB | prevelika datoteka se zavrne že v brskalniku; velikost PDF-ja se šteje v skupno omejitev virov in v prostor paketa |
| Strani na spletni vir | 15 najkoristnejših | preostale strani se ne zajamejo; oznaka vira pove »prvih 15 strani« |
| Besedilo na zajeto stran | 12 000 znakov | daljše besedilo se odreže |
| Besedilo na vir pri gradnji | 16 000 znakov na vir, 4 viri na klic modela | rep vira ne gre v AI; dolge vire razdelite na več virov (podstrani) |
| Ročno urejena vsebina | 20 do 200 000 znakov | shranjevanje se zavrne z obvestilom o prekratki oziroma predolgi vsebini |
| Odgovor orodja search_knowledge_base | 3 razdelki, 1 500 znakov | agent dobi le najustreznejše razdelke; celotna baza je sicer v pozivu |
Pogoste težave in kako jih rešite
Večina težav z bazo znanja izvira iz virov: spletišče brez kazala strani, zajete napačne podstrani ali dejstva, ki jih na spletni strani ni. Spodaj so najpogostejši primeri in rešitev v Koliu.
- »Na strani ni najdenega uporabnega besedila.« Spletišče vsebino izriše šele z JavaScriptom ali blokira samodejne obiske. Vpišite besedilo ročno v urejevalnik ali dodajte podstran, ki vsebino vrne kot HTML.
- Zajete so napačne strani (blog, izdelki). Dodajte kot ločene vire natančno tiste podstrani, ki jih želite (
/kontakt,/cenik,/pogoji), in vstopni vir s korenom spletišča odstranite. - »Gradnja ni uspela: Ni virov z besedilom za gradnjo baze znanja.« Noben vir nima vsaj 50 znakov zajetega besedila. Preverite stanje virov in odpravite napake zajema.
- Agent trdi, da poslovalnice ni. Lokacije in ponudba so v Nastavitve → Storitve; seznam storitev ima prednost pred bazo znanja. Dodajte storitev z lokacijo, ne le besedilo v bazo.
- Agent pove zastarelo ceno. Baza znanja je posnetek ob gradnji. Po spremembi na spletni strani znova zajemite vir (izbrišite in dodajte) in kliknite Osveži, ali pa ceno popravite ročno in shranite novo verzijo.
- Ročni popravki so izginili. Osvežitev iz virov je ustvarila novo verzijo. V Zgodovina verzij najdite verzijo ročno urejeno in kliknite Obnovi, nato vanjo prenesite nove podatke.