Juhtpaneel → Integratsioonid — sisuallikate ja teadmustele juurdepääsu kanalite ühendamine.


#Sisuallikad

#Ühendatud (alati aktiivsed)

Allikas Kirjeldus
LiKE redaktor Sisseehitatud AI-redaktor artiklite loomiseks
Failide import PDF-, DOCX-, TXT-, MD-, RTF- ja ZIP-failide üleslaadimine
Import lingi kaudu Google Docs, Dropbox, otselingid failidele

#Saadaolevad ühendajad

Allikas Kirjeldus Režiim
Wiki.js Artiklite import või sünkroonimine Sünkroonimine / import
Confluence Import Atlassian Confluence Cloudist (OAuth) Sünkroonimine / import
Notion Lehtede ja andmebaaside import Sünkroonimine / import
GitHub Wiki ja Markdown-failide sünkroonimine hoidlatest Sünkroonimine / import
GitLab Wiki ja Markdown-failide sünkroonimine projektidest Sünkroonimine / import
Gitea Wiki ja Markdown-failide sünkroonimine ise majutatud Giteast Sünkroonimine / import
Veebikonnektor Teie avaliku veebisaidi lehed: saidikaardi järgi või linke mööda läbides Sünkroonimine

Ühendatud allikate arv on paketiga piiratud. Kui piir on täis, on allikate nupp „Ühenda“ mitteaktiivne — lahutage üks või minge kõrgemale paketile. Slacki ja Telegrami robotid sellesse piiri ei lähe.


#GitHubi ühendamine

#1. samm — autoriseerimine

  1. Avage LiKE-s Integratsioonid → GitHub → „Ühenda“
  2. Valige autoriseerimisviis:
Viis Kirjeldus
Personal Access Token (PAT) Looge luba: GitHub → Settings → Developer settings → Personal access tokens. Fine-grained (soovitatav): Repository access + Permissions → Contents: Read-only (Metadata: Read lisandub ise); organisatsiooni hoidlate puhul peab loa kinnitama selle omanik. Classic: skoop repo. Enterprise: märkige Base URL https://HOST/api/v3
OAuth Autoriseerimine GitHub Appi kaudu — vajutage „Autoriseeri“ ja kinnitage juurdepääs

#2. samm — sisu valik

  1. Pärast ühendamist kuvatakse hoidlate puu koos kaustade ja failidega
  2. Märkige linnukestega konkreetsed failid või kaustad impordiks (valikuline sünkroonimine)
  3. Toetatud vormingud: .md, .mdx, Wiki-lehed

#3. samm — sünkroonimise käivitamine

  1. Vajutage „Sünkrooni“
  2. Edenemist näidatakse reaalajas
  3. Pärast lõpetamist ilmuvad artiklid loendisse märgisega GitHub

#GitLabi ühendamine

#1. samm — autoriseerimine

  1. Avage LiKE-s Integratsioonid → GitLab → „Ühenda“
  2. Valige autoriseerimisviis:
Viis Kirjeldus
Personal Access Token (PAT) Looge luba: GitLab → Preferences → Access Tokens. Skoobid: api ja read_user; loa roll vähemalt Reporter (Guest koodi ei näe). Sobib nii GitLab.com-ile kui ise majutatule (ise majutatu puhul märkige eksemplari Base URL)
OAuth Autoriseerimine GitLab Applicationi kaudu — vajutage „Autoriseeri“

#2. samm — sisu valik

  1. Kuvatakse projektide puu koos Wiki-lehtede ja Markdown-failidega
  2. Märkige konkreetsed lehed impordiks (valikuline sünkroonimine)

#3. samm — sünkroonimise käivitamine

Nagu GitHubi puhul — vajutage „Sünkrooni“ ja oodake lõpetamist.


#Gitea ühendamine

Gitea on ise majutatav git-platvorm. Ühendatakse Personal Access Tokeni ja kohustusliku eksemplari aadressiga (pilve-Giteat vaikimisi ei ole).

#1. samm — looge Giteas luba

  1. Avage Giteas Settings → Applications → Generate New Token
  2. Andke skoobid read:repository ja read:user
  3. Kopeerige luba

#2. samm — ühendage LiKE-s

  1. Avage LiKE-s Integratsioonid → Gitea → „Ühenda“
  2. Märkige oma eksemplari Base URL (näiteks https://gitea.company.com) — väli on kohustuslik, ilma selleta ühendamine ei õnnestu
  3. Kleepige luba
  4. Valige, kuhu artiklid panna (Ala ja kaust selle sees — või looge uued), ja režiim (Sünkroonimine — pidev peegel / Import — ühekordne koopia)

OAuth 2.0 on samuti toetatud, kui Gitea administraator on OAuth-rakenduse ette seadistanud. Peamine tee on luba.

#3. samm — sisu valik ja sünkroonimine

  1. Kuvatakse hoidlate puu koos Wiki-lehtede ja Markdown-failidega (.md, .mdx)
  2. Märkige vajalikud sõlmed (valikuline sünkroonimine) ja vajutage „Sünkrooni“
  3. Pushi järel automaatseks uuendamiseks seadistage veebihaak — saladus luuakse ühendaja kaardil. Gitea artiklid on ainult lugemiseks (nagu GitHubis ja GitLabis)

#Failide valik ja sünkroonimise filtrid (GitHub, GitLab, Gitea)

Git-allikate (GitHub, GitLab ja Gitea) puhul on sünkroonitava valimine peenem kui lihtne „hoidla sisse või välja“:

#Mis sünkroonimisse läheb

Allikas hoidla sees Kas kaasatakse
Wiki-lehed (<repo>.wiki) Vaikimisi kõik valitud hoidla Wiki-lehed
Markdown-failid põhipuus (*.md, *.mdx) Vaikimisi kõik Markdown-failid, kui filtreid pole seatud
README.md Kaasatakse eraldi artiklina nimega <repo-name> · README
Dokumentatsioon kaustas /docs/** Kaasatakse, kui kaust on olemas; artikli nimi võetakse pealkirjast # ... või failinimest
Mitte-Markdown-failid (.txt, .rst, .json, kood) Ei sünkroonita automaatselt — LiKE ei loe suvalisi vorminguid

#Teefiltrid (valikuline sünkroonimine)

Saab täpsustada, mida hoidlast võtta:

Path filters
+ docs/** + guides/*.md − internal/**
Ainult failid kaustadest docs/ ja guides/, välja arvatud internal/
Eesliide Toiming
+ path/pattern Kaasa — lisa mustrile vastavad failid (glob-süntaks)
- path/pattern Välista — jäta failid sünkroonimisest välja
(tühi) Filtriteta: kõik Wiki-lehed + kõik .md/.mdx hoidlas

#Muudatuste tuvastamine

LiKE ei tõmba iga sünkroonimise ajal kõike uuesti. Kasutatakse muudatuste tuvastamist:

  • GitHub — veebihaagi kaudu (soovitatav) või küsitlemisega, kasutades päist If-Modified-Since. Veebihaak reageerib pushile kohe, küsitlemine toimub iga 6, 12, 24 või 48 tunni järel (oleneb automaatsest sünkroonimisest).
  • GitLab — samamoodi: veebihaak või küsitlemine välja last_activity_at järgi Projects API kaudu.
  • Gitea — veebihaak (allkiri X-Gitea-Signature) või küsitlemine. Pushi päästik rakendub ainult failide *.md/*.mdx muutumisel.

Pärast muudatuse tuvastamist sünkroonitakse ainult puudutatud failid, ülejäänud kogu üle ei arvutata. See säästab tublisti GitHubi ja GitLabi API-kvoote ning aega.

#Haru ja sildid

Parameeter Vaikeväärtus
Haru Hoidla vaikeharu (tavaliselt main või master)
Muu haru Saab otse määrata (näiteks sünkroonida haruga release/v2)
Sünkroonimine sildi järgi Valikuline: sünkroonimine versioonisildi järgi (näiteks versiooni v3.0 dokumentatsioon)
Mitu haru Pro+: mitut haru saab sünkroonida korraga eri artiklitena

#Ajalugu ja konfliktid

  • Sünkroonimiste ajalugu — ühendaja kaardil vahekaart „Ajalugu“: kuupäev, olek ( ok / warnings / viga), lisatud, uuendatud ja kustutatud artiklite arv, prooviaeg. Kasulik selgitamaks, miks hoidla artikkel ei ilmunud.
  • Muutmiskonfliktid — kui allikast pärit artiklit muudeti LiKE-s (GitHubi ja GitLabi puhul on see vaikimisi keelatud — artiklid on ainult lugemiseks). Režiimis Import (ühekordne koopia) muutuvad artiklid muudetavaks ja side allikaga katkeb.

#Valikuline sünkroonimine teiste ühendajate puhul

Notionil, Confluence'il ja Wiki.js-il on oma valikuloogika (lehtede puu), kuid põhimõte on sama:

  1. Ühendamisel kuvatakse allika sisupuu
  2. Märkeruutudega märgitakse vajalikud sõlmed
  3. Ülejäänut ei impordita
  4. Kordussünkroonimisel uuendatakse ainult valitud elemente

#Wiki.js-i ühendamine

#1. samm — hankige Wiki.js-i API-luba

  1. Avage oma Wiki.js → Administration → API Access
  2. Lülitage API sisse (kui see on väljas)
  3. Vajutage New API Key
  4. Andke võtmele nimi (näiteks LiKE Integration)
  5. Rühm: Administrators (vaja on juurdepääsu kõigile lehtedele)
  6. Expiration: tähtajatu või üks aasta
  7. Kopeerige loodud luba

#2. samm — ühendage LiKE-s

  1. Avage LiKE-s Integratsioonid → Wiki.js → „Ühenda“
  2. Sisestage oma Wiki.js-i aadress (näiteks https://wiki.company.com)
  3. Kleepige API-luba
  4. Valige režiim:
Režiim Kirjeldus
Sünkroonimine Pidev side — Wiki.js-i muudatused ilmuvad LiKE-sse ise
Import Kõigi artiklite ühekordne kopeerimine
  1. Vajutage Salvesta

#3. samm — seadistage sünkroonimine

Parameeter Kirjeldus
Automaatne sünkroonimine Lülitab automaatse uuendamise sisse või välja
Sagedus Iga 6, 12, 24 või 48 tunni järel
Keel Artiklite keelefilter (kõik või konkreetne)

#Confluence'i ühendamine

Confluence ühendatakse OAuth 2.0 kaudu — turvaline autoriseerimine ilma paroole sisestamata.

#1. samm — ühendage oma Confluence'i sait

  1. Vajalik on Confluence Cloud — aadress kujul teie-ettevote.atlassian.net. Confluence Server ja Data Center ei ole toetatud
  2. Klõpsake „Ühenda“ ja logige sisse oma Atlassiani kontole
  3. Valige juurdepääsuaknas oma Confluence'i sait ja klõpsake „Accept“. LiKE näeb ainult seda, mis on Teile kättesaadav
  4. Näete „Access denied“? Kontrollige aadressil start.atlassian.com, et Teie kontol on Confluence'i sait. Kui sait on olemas, paluge Atlassiani administraatoril lubada rakenduste ühendamine: admin.atlassian.com → Apps → Teie sait → Connected apps → Settings → lülitage välja „Block user apps“

Kontrollige õigusi — LiKE taotleb ainult lugemist: lehtede sisu ja alade loendit

#2. samm — kuhu artiklid panna ja mida tuua

Avage Confluence'i kaardil „Seadista“:

Parameeter Kirjeldus
Artiklite sihtala Ala ja Kuhu panna — kaust ala sees, kuhu artiklid lähevad. Sobivat pole — Loo kogu sisse või Loo uus ala. Ala ise sihtkoht olla ei saa
Mida sünkroonida Confluence'i puu paremal: alad ja nende lehed. See loetakse igal avamisel uuesti
Ajakava Märkeruut „Lubatud“ — automaatne uuendamine valitud intervalli järel
Sünkroonimise intervall Iga 1, 2, 4, 6, 12 või 24 tunni järel
Kustuta artiklid, kui need allikast eemaldatakse Sees — Confluence'is kustutatud leht kustutatakse ka LiKE-s, sealhulgas juba märgistatud. Väljas — artikkel jääb alles märkega „Allikast eemaldatud“ ja otsustate teie

Klõpsake „Sünkrooni“.

#Kuidas valik toimib

Mis on märgitud Mida sünkroonimine toob
Terve ala Kõik selle lehed — ka need, mis ilmuvad Confluence'i hiljem. Ala artiklid lähevad oma kausta
Üksikud lehed Ainult märgitud; ala uusi lehti ei tooda

Kuni midagi pole märgitud, pole midagi sünkroonida — kaart annab sellest teada. Märkimata jäetud ala eemaldatakse LiKE-st koos oma kaustaga.

#Mida me üle ei too

  • Isiklikud alad — neid puus pole: need on töötajate isiklikud märkmed ja nende nimi on inimese nimi.
  • Inimeste mainimised — sildiga mainimisest jääb alles sildi tekst, sildita mainimine eemaldatakse; ülesannete täitjaid üle ei tooda. LiKE ei salvesta Atlassiani kasutajate tunnuseid ega profiile.

Confluence'i artiklid on ainult lugemiseks. Muutmiseks parandage originaali Confluence'is, LiKE uuendab selle järgmisel sünkroonimisel.

Confluence'i lahutamisel saate artiklite koopia LiKE-sse alles jätta (muutuvad muudetavaks) või need kustutada.


#Notioni ühendamine

#1. samm — looge Notionis integratsioon

  1. Avage Notion, klõpsake oma avataril (vasakul ülal) ja valige Settings
  2. Valige vasakust menüüst My connections (või Integrations)
  3. Vajutage Develop or manage integrations → New integration
  4. Sisestage nimi (näiteks LiKE Import) ja valige tööruum
  5. Vajutage Submit ja kopeerige Internal Integration Secret (algab ntn_; vanematel integratsioonidel secret_)

#2. samm — andke integratsioonile juurdepääs lehtedele

Integratsioonil ei ole vaikimisi juurdepääsu ühelegi lehele. Selle peab eraldi lubama:

  1. Avage Notionis iga leht (või ülemleht või andmebaas), mida soovite importida
  2. Vajutage ⋯ (kolm punkti paremal ülal) → Connect to ja valige oma integratsioon LiKE Import
  3. Kinnitage juurdepääs
Nõuanne. Andke juurdepääs juurlehele — kõik alamlehed muutuvad integratsioonile ise kättesaadavaks. Iga lehte eraldi ühendada pole vaja.

#3. samm — ühendage LiKE-s

  1. LiKE-s Juhtpaneel → Integratsioonid → Notion → „Ühenda“
  2. Kleepige Integration Secret (kopeeritud 1. sammul)
  3. Valige, kuhu artiklid panna: Ala ja kaust selle sees — või looge siinsamas uus kaust või uus ala
  4. Valige režiim:
Režiim Kirjeldus
Sünkroonimine Pidev side — Notioni muudatused ilmuvad LiKE-sse ise. Artiklid on ainult lugemiseks
Import Ühekordne kopeerimine. Artiklid muutuvad LiKE-s muudetavaks
  1. Märkige sammul „Valige sisu“, mida tuua: terveid katalooge või üksikuid lehti. Kataloog on juurleht või andmebaas, millele andsite 2. sammul juurdepääsu. Kuni midagi pole märgitud, ei lase viisard edasi minna
  2. Vajutage „Ühenda ja sünkrooni“ — iga kataloogi artiklid lähevad oma kausta 3. sammus valitud kausta sees

#Kuidas valik toimib

Mis on märgitud Mida sünkroonimine toob
Terve kataloog Kõik selle lehed — ka need, mis ilmuvad Notionisse hiljem
Üksikud lehed Ainult märgitud; selle kataloogi uusi lehti ei tooda

Tekstita lehed — näiteks andmebaasi kirjed, millel on ainult omadused — artikliteks ei muutu. Notioni kaart näitab, mitu neist vahele jäeti: „tühje lehti vahele jäetud: N“.

#4. samm — seaded

Avage Notioni kaardil „Seadista“:

Parameeter Kirjeldus
Artiklite sihtala Ala ja Kuhu panna — kaust, milles asuvad kataloogide kaustad. Saate valida teise või luua uue
Mida sünkroonida Notioni puu paremal. See loetakse igal avamisel uuesti — valitud kataloogide uued lehed on juba märgitud. Märkeid saab igal ajal muuta: märkimata jäetud kataloog eemaldatakse LiKE-st koos oma kaustaga
Ajakava Märkeruut „Lubatud“ — automaatne uuendamine valitud intervalli järel
Sünkroonimise intervall Iga 1, 2, 4, 6, 12 või 24 tunni järel
Kustuta artiklid, kui need allikast eemaldatakse Sees — Notionis kustutatud leht kustutatakse ka LiKE-s, sealhulgas juba märgistatud. Väljas — artikkel jääb alles märkega „Allikast eemaldatud“ ja otsustate teie

Notioni lahutamisel saate artiklite koopia LiKE-sse alles jätta (muutuvad muudetavaks) või need kustutada.


#Veebikonnektor

Veebikonnektor ühendab teie veebisaidi lehed LiKE-ga paari minutiga. Kleepige aadress — LiKE leiab lehed saidikaardi (sitemap) järgi või linke mööda läbides, toob nende teksti ja hoiab koopiat ajakohasena. LiKE AI-otsing töötab nende lehtedega kohe ning vajaduse korral saab saidile paigaldada otsinguvidina — klientidele või töötajatele.

Sobib, kui teie dokumentatsioon või abikeskus on juba avaldatud — oma domeenil, Docusauruses, GitBookis, Docsifys ja sarnastes. Sait peab olema avalik. Üks organisatsioon ühendab ühe saidi.

#1. samm — aadress ja lehtede leidmise viis

Integratsioonid → Veebikonnektor → Ühenda. Kleepige aadress — sobib ükskõik milline leht, saidi võtame tervikuna.

Kuidas lehti otsida:

  • Saidikaardi järgi — vaikimisi. Kaardi otsime ise üles: kõigepealt failist robots.txt, seejärel aadressilt /sitemap.xml;
  • Saidikaarti pole — läbi linke mööda — liigume esilehelt linke mööda selle saidi piires; määrake läbimise sügavus. Lehti, mille sait joonistab skriptiga, läbimine ei näe.

Vajutage Kontrolli saiti. Kui kaarti ei leitud, pakub viisard linke mööda läbimise sisselülitamist ja uut kontrolli.

#2. samm — mida võtame

Kontroll ei salvesta midagi: see näitab, kui palju lehti leiti ja kui palju lisatakse. Kui maht paketti ei mahu, ütleb viisard seda kohe, mitte pärast läbimist.

  • Keeleversioon — ilmub, kui sait annab lehti mitmes keeles. Valige, millise võtate; arvud ja kaustad arvutatakse selle järgi ümber.
  • Mida saidilt võtame — loend kaustadest, mis baasi tekivad, koos lehtede arvuga igaühes. Märgitud kaustad võtame; märke saab tagasi panna. Loendur Valitud arvestab ainult märgituid.
  • Rubriikide ja siltide arhiivid — loendid linkidest artiklitele, mis niikuinii baasi jõuavad — jäetakse vaikimisi võtmata; märkige, kui vajate.
  • Kui sait on jaotatud aastate kaupa, saab igast aastast oma kaust. Kolme või enama aasta puhul on märgitud kaks saidi värskeimat aastat; ülejäänud saab märkida käsitsi.
  • Saidi esileht saab eraldi artikliks kaustas „Esileht“.
  • Mitu lehte ühe prooviga võtta on meie seadistus, mitte saidi suurus: ülejäänu võtavad järgmised proovid.

Lehe kuuluvus kausta on näha ainult lehelt endalt, seepärast kontrollitakse rohkem lehti, kui lisatakse; viisard näitab mõlemat arvu.

Vihje: mida võtta (ainult linke mööda läbimisel). Nupp Küsi mudelilt pakub koos põhjendustega, milliseid aadressirühmi võtta ja milliseid mitte. See on ettepanek, mitte otsus: märkige see, millega nõustute. Kulu arvestatakse nagu redaktori AI-toimingute puhul; vastus jäetakse meelde ja arvutatakse ümber ainult nupuga Arvuta uuesti.

#3. samm — kuidas salvestada ja kuhu panna

Kuidas lehti salvestada:

  • Sisemistena — näeb ainult meeskond — vaikimisi;
  • Avalikena — nähtavad kõigile.

Kui valitud kaust on juba kõigile avatud, hoiatab viisard teid ja pakub valikut Avalikena: sellises kaustas olevad lehed on kõigile kättesaadavad. Et neid näeks ainult teie meeskond, valige Sisemistena — siis jäävad need peidetuks ka avatud kaustas. Suletud kaustas järgivad sisemised lehed kausta juurdepääsu: kui muudate kausta hiljem avalikuks, avanevad need koos sellega — pärast isikuandmete kontrolli.

Avaliku juurdepääsu jaoks on vaja mõlemat märget: et teil on õigused saidile ja selle sisule ning et saidil olevad isikuandmed on avaldatud seaduslikult ja teil on õigus teha need otsingus ja assistendi vastustes kättesaadavaks. Ilma nendeta ei ole nupp Ühenda aktiivne. Nõusolek kirjutatakse üles — kes, millal ja millise teksti kinnitas — ning kehtib selle saidi kõigile artiklitele: nende avaldamisel ei ole vaja isikuandmeid iga artikli kohta eraldi kinnitada. Redaktoris kirjutatud artiklitele see ei laiene. Nõusoleku tagasivõtmiseks lahutage sait ja ühendage see uuesti, valides „Sisemistena“.

Kuhu panna: valige Ala ja kaust selle sees. Sobivat kausta pole — Loo kogu sisse; sobivat ala pole — Loo uus ala: need luuakse ühendamisel. Ala ise sihtkoht olla ei saa ja kaust peab olema tühi: allika kausta paneb ainult ühendaja ise.

Pärast nuppu Ühenda algab läbimine kohe: edenemine on näha ühendaja kaardil („Sünkroonime 22 valitud 92-st“) ja taustatööde üldnäidikul.

#Mida võetakse ja mida mitte

  • võetakse lehe sisu — ilma saidi menüü, päise ja jaluseta;
  • kaustad märgitakse viisardis ja hiljem ühendaja seadetes (Seadista → Saidi kaustad);
  • teenindusjaotised nagu otsing ja sildid jäetakse vaikimisi vahele;
  • Mitu lehte ühe prooviga võtta piirab üht proovi — kaitse hiiglaslike saitide vastu;
  • failis robots.txt suletud lehti ei võeta; nende arv on näha proovi kokkuvõttes;
  • assistendi vastuses ja artikli päises on link Ava saidil, mis viib algsele lehele.

#Korduvad uuendused

Kui Uuenda automaatselt on sees, loeme saidi ajakava järgi uuesti läbi. Uuesti indekseeritakse ainult muutunud lehed — nii on ka proovi kokkuvõttes kirjas: „lisatud“, „uuendatud“, „muutusteta“. Muutumatud indekseerimise piiri ei kuluta.

Kustuta artiklid, mis allikast kadusid on vaikimisi väljas: kui leht saidilt kadus, jääb artikkel baasi märkega „kadus allikast“. Lülitage sisse, kui koopia peab saiti täpselt kordama.

Keeleversiooni vahetamine pärast ühendamist (Seadista → Keeleversioon) muudab allika koosseisu. Endise versiooni artikleid sait enam ei uuenda, seepärast küsib LiKE, mida nendega teha: Kustuta või Jäta omadeks (muutuvad muudetavaks). Ilma vastuseta seadistust ei salvestata.

#Millised saidid sobivad ja millised mitte

Sobib avalik sait — kas saidikaardiga, nagu enamikul dokumentatsioonigeneraatoritel, või ilma selleta linke mööda läbimisel. Ülejäänu lükkame ausalt tagasi juba kontrollisammul, mitte ei selgita välja pärast ühendamist:

Mis takistab Mida näete
Saidikaarti pole ei failis robots.txt ega aadressil /sitemap.xml Viisard pakub üleminekut linke mööda läbimisele
Kaardi aadressil ei ole XML — tavaliselt vastab nii robotikaitse Ühendamine ei alga
Kaart on olemas, kuid pärast filtreid ei jäänud sinna ühtki lehte Ühendamine ei alga
robots.txt keelab kogu saidi läbimise Ühendamine ei alga
robots.txt ei ole serveri vea tõttu kättesaadav Ühendamine ei alga: „vastust ei ole“ ei tähenda „lubatud“
Sait on parooliga suletud või kättesaadav ainult sisevõrgust Lehti ei saa lugeda
Sisu joonistavad skriptid alles brauseris Leht võib jääda peaaegu tühjaks — loeme HTML-i sellisena, nagu server selle andis

Üksikud lehed võivad baasi mitte jõuda ka siis, kui sait ühendus: failis robots.txt suletud, veaga vastavad, üle 10 MB suurused või mitte-HTML-i andvad. Kõik need jõuavad proovi kokkuvõttesse koos põhjusega — „vahele jäetud“ ja „suletud robots.txt-ga“.

Faile (PDF, ZIP, pildid) saidilt ei võeta. Nende jaoks on eraldi tee — failide import koos oma töötlusega.

#Piirangud

  • üks sait organisatsiooni kohta;
  • sait peab olema avalik — parooli taga olevaid lehti ei loeta;
  • saidikaart ei ole kohustuslik: ilma selleta töötab linke mööda läbimine, kuid see näeb ainult seda, millele saidil link viitab;
  • järgime faili robots.txt, sealhulgas selles määratud pausi päringute vahel.

Lahutamine. Sünkroonimine lõpeb ning juba laaditud artiklid saab kustutada või jätta tavalisteks — LiKE küsib seda lahutamisel.


#Pärast ühendamist: AI-otsing ja vidin teie saidil

  1. Kui läbimine on lõppenud, osalevad saidi lehed LiKE AI-otsingus võrdselt redaktoris kirjutatud artiklitega ning vastus viitab algsele lehele — Ava saidil.
  2. Et otsida otse oma saidil, looge vidin: Integratsioonid → Kanalid → JS Widget → Halda vidinaid → Loo vidin. Väljale Selle saidi aadress, kus vidin asuma hakkab sisestage selle saidi aadress.
  3. Valige vidina tüüp:
    • Avalik — otsib ainult avalikest artiklitest ja on avatud kõigile külastajatele. Sobib klientidele; selleks salvestage saidi lehed Avalikena (3. samm).
    • Ettevõtte — otsib valitud aladest, sealhulgas sisemistest artiklitest, ning nõuab sisselogimist. Sobib töötajatele.
  4. Lisage otsingu ulatus ja lülitage vidin sisse. Tüübi Avalik puhul — Kõik avalikud artiklid või kaust (kollektsioon), kuhu konnektor lehed pani: avalik vidin ei saa hõlmata tervet ruumi. Tüübi Ettevõtte puhul — ruum või kaust saidi lehtedega.
  5. Kopeerige Manustamiskood ja kleepige see oma saidile. Kus seda WordPressis, Tildas, Wixis, Webflow's, Squarespace'is, Shopifys, Frameris, Google Tag Manageris ja Docusauruses teha — vt API ja vidin, jaotis Kuhu kood saidiehitajates kleepida.

#Failide import

#Failide üleslaadimine

  1. Juhtpaneel → Import
  2. Lohistage failid kohale või klõpsake üleslaadimisalal
  3. Toetatud vormingud: PDF, DOCX, TXT, MD, RTF, ZIP
  4. AI loob igale failile ise nime ja slugi
  5. Enne avaldamist saab nime muuta või faili redaktoris avada
Parameeter Kirjeldus
Suurim maht 20 MB faili kohta, ZIP-arhiiv — 24,8 MB (rohkem ühe üleslaadimisega ei mahu)
Hulgi üleslaadimine Kuni 50 faili korraga; suur valik saadetakse automaatselt osade kaupa
Keel Tuvastatakse automaatselt

#ZIP-arhiivid

Laadige üles ZIP-arhiiv paljude dokumentidega — LiKE pakib selle ise lahti ja töötleb iga faili. Mugav terve teadmusbaasi ületoomiseks.

ZIP-i sees toetatud failid: PDF, DOCX, TXT, MD, RTF. Ülejäänud failid (pildid, käivitatavad) jäetakse vahele.

#Import lingi kaudu

Kleepige dokumendi link — LiKE laadib selle alla ja impordib:

  1. Juhtpaneel → Import → jaotis „Import lingi kaudu“
  2. Kleepige aadress ja vajutage „Lisa“
  3. Korraga saab lisada kuni 10 linki
  4. Vajutage „Impordi“

Toetatud allikad:

  • Google Docs — eksporditakse ise DOCX-ina
  • Google Sheets — eksporditakse CSV-na
  • Dropbox — otselink failile
  • Ükskõik milline otselink PDF-, DOCX-, TXT-, MD- või RTF-failile

#Vaikimisi nähtavus

Igale allikale saab seada vaikimisi nähtavuse:

  • Mustand — artiklid luuakse peidetuna
  • Meeskonnale — näevad sisse loginud kasutajad
  • Avalik — näevad kõik, ka anonüümsed

Seadistatakse: Integratsioonid → allika kaart → Nähtavus.


#Juurdepääsukanalid

Kanalid lubavad teie töötajatel otsida teavet harjumuspäraste tööriistadega.

#Slacki robot

Slacki ühendamine:
1. Vajutage jaotises Integratsioonid „Ühenda Slack“
2. Autoriseerige rakendus LiKE oma Slacki tööruumis
3. Valige kanal teavituste jaoks
4. Valmis — töötajad kasutavad käsku /like küsimus või mainivad @LiKE

Võimalused:

  • /like kuidas seadistada SSO? → AI-vastus otse Slackis
  • Mainimine @LiKE ükskõik millises kanalis → vastus lõimes
  • Lingid allikaartiklitele (klõpsatavad)

#Telegrami robot

Robot vastab töötajate küsimustele otse Telegramis, tuginedes teie teadmusbaasile.

#1. samm. Looge Telegramis robot

Roboteid ei looda saidil, vaid Telegrami sees — teenindusroboti @BotFather kaudu. See on Telegrami ametlik tööriist: see väljastab uusi roboteid ja haldab nende seadeid.

Kuidas leida. Avage Telegramis otsing ja sisestage BotFather. Valige see, kelle nime kõrval on sinine linnuke — sarnaste nimedega roboteid on palju ja linnuke on ainus usaldusväärne tunnus, et tegu on õigega.

Kuidas luua. Avage vestlus, vajutage „Käivita“ ja saatke tavalise sõnumina:

/newbot

BotFather esitab kaks küsimust:

  1. Roboti nimi — näevad vestluses osalejad. Võib olla ükskõik mis keeles ja tühikutega, näiteks Lynkora abiline.
  2. Roboti aadress — selle järgi leitakse robot otsingust. Ainult ladina tähed, numbrid ja alakriipsud ning see peab lõppema tähtedega bot: näiteks lynkora_help_bot. Kui aadress on võetud, palub BotFather teist.

Vastuseks tuleb luba — sõne kujul 8123456789:AAEhBOwe…. Seda läheb järgmisel sammul vaja.

Luba on roboti parool. Ärge seda edasi saatke ega avaldage. Kui see sattus valesse kohta: käsk /revoke BotFatheris — vana lakkab töötamast ja saate uue.

Kui robot on varem loodud, aga luba kadus, kasutage käsku /mytoken.

#2. samm. Ühendage robot LiKE-ga

Avage Integratsioonid → Telegram, kleepige luba väljale Bot Token ja vajutage „Ühenda“. Vaja on omaniku või administraatori õigusi.

Kui luba vastu ei võetud, kontrollige, et sõne on kopeeritud tervikuna koos kooloni ees olevate numbritega ja ilma tühikuteta äärtes. Teise roboti luba ei sobi: igaühel on oma.

Pärast ühendamist ilmuvad kaardile roboti aadress ja märge „Aktiivne“.

#3. samm. Valige vastuste allikas

Vajutage „Seadista“ ja märkige ala, kust robot vastuseid võtab — saab piirduda ka üksikute kogudega. Ilma selle seadistuseta vastab robot igale küsimusele, et ei tea.

Sealsamas valitakse, kas anda ainult üldkättesaadavaid artikleid või ka sisemisi. Sisemiste jaoks peab vestluskaaslane olema tuvastatud — vt järgmist sammu.

#4. samm. Otsustage, kus robot töötab

Isiklikus vestluses — kahekesi robotiga. Et robot mõistaks, kes kirjutab, seotakse vestlus kontoga: portaali esilehel vajutage „Küsi vestluses“, seejärel „Hangi sidumiskood“ ja saatke kood robotile ühe sõnumina. Kood on ühekordne ja kehtib 10 minutit. Pärast sidumist vastab robot selle inimese õiguste järgi, sealhulgas sisemistest artiklitest. Sidumise teeb iga töötaja endale ise.

Rühmavestluses vastab robot kõigile osalejatele, kuid ainult üldkättesaadavate artiklite põhjal: ühises vestluses ei ole võimalik tuvastada, kes küsimuse esitas.

Et robot rühmas tööle hakkaks:

  1. Lülitage sõnumite peitmine välja: BotFatheris käsk /setprivacy, valige robot ja vajutage Disable. Vaikimisi peidab Telegram rühmade sõnumid robotite eest ja robot lihtsalt ei näe küsimusi.
  2. Eemaldage robot rühmast ja lisage uuesti — muidu seadistus ei rakendu: Telegram rakendab seda roboti rühma liitumise hetkel.
  3. Lisage rühmavestlus integratsiooni seadetes lubatute loendisse.

#5. samm. Kontrollige

Esitage robotile küsimus teemal, mis baasis olemas on. Vastus tuleb samasse vestlusesse koos linkidega allikaartiklitele.

Vastuse keel tuleneb küsimuse keelest — küsisite saksa keeles, vastab saksa keeles. Seadistus „Teenindusvastuste keel“ määrab keele ainult teenindussõnumitele: keeldumistele ja sidumise kinnitusele.

#Lahutamine ja kustutamine

LiKE-st lahutamine: Integratsioonid → Telegram → „Lahuta“. Robot lakkab vastamast, side katkeb, robot ise jääb Telegrami alles ja selle saab uuesti ühendada.

Roboti vahetamine: lahutage kõigepealt praegune, seejärel ühendage uus. Vastupidises järjekorras jääb vana robot LiKE-le seadistatuks ja saadab asjata sõnumeid, mida keegi ei töötle.

Roboti täielik kustutamine: käsk /deletebot BotFatheris. Toiming on pöördumatu — aadress vabaneb ja robotit tagasi saada ei ole võimalik.

#Kui robot ei vasta

Mis toimub Põhjus Mida teha
Vaikib rühmas, isiklikus vestluses vastab Telegram peidab rühma sõnumid roboti eest /setprivacy → Disable, seejärel eemaldage robot rühmast ja lisage uuesti
Vaikib kõikjal, kuigi on ühendatud Kirjutate teisele robotile — sarnaseid nimesid on lihtne segi ajada Võrrelge vestluses oleva roboti aadressi sellega, mis on integratsiooni kaardil
Vastab „vestlus ei ole seotud“ Isiklik vestlus ei ole kontoga seotud Võtke portaalist sidumiskood ja saatke see robotile sõnumina
Rühmas vastab ainult üldkättesaadavate artiklite põhjal Nii on mõeldud: ühises vestluses ei ole näha, kes küsib Sisemiste artiklite jaoks kirjutage robotile isiklikus vestluses
Lakkas vastamast pärast roboti vahetust Uus ühendati vana lahutamata Lahutage integratsioon ja ühendage vajalik robot uuesti
Vastab kõigele „ei tea“ Vastuste allikas on valimata Integratsioonid → Telegram → „Seadista“ → valige ala

#JS-vidin (teie saidi jaoks)

Hõljuv AI-otsingu nupp ükskõik millisele saidile lisamiseks. Kõige populaarsem integratsioon: kasutaja näeb lehe nurgas nuppu, klõpsab ja avaneb vestlus AI-ga ning otsing teie teadmusbaasist.

#Lihtne paigaldus

Paigaldus kolme sammuga:
1. Integratsioonid → Kanalid → kaart „JS Widget“ → „Halda vidinaid“ → „Loo vidin“ → andke nimi, märkige saidi aadress ja salvestage
2. Kopeerige lisamiskood (silt `<script>` ainulaadse api-võtmega)
3. Kleepige see oma saidi ükskõik millisel lehel sildi </body> ette

Kui AI-vastuste maht on otsas. Avalikku vidinat lehel üldse ei näidata — ei nuppu ega teadet piiri kohta; kiirklahv ei rakendu. Kui maht on jälle saadaval, ilmub vidin lehe järgmisel laadimisel.

#Põhiparameetrid

Parameeter Kirjeldus
Nimi Vidina sisemine nimi (haldusliidese jaoks, kasutajad ei näe)
Asukoht Vasak või parem alanurk
Rõhuvärv Nupu ja vestluse rõhuvärv (võetakse vaikimisi brändiseadetest)
Kiirklahv Näiteks Ctrl+K või ⌘K vestluse avamiseks klaviatuurilt
Nupp saidil Rinni (vaikimisi), jutumull või oma ikoon — PNG-, JPEG- või WebP-pilt kuni 512 KB: see luuakse meie serveris uuesti, nuppu jõuavad ainult pikslid. Muutub saidil kohe, lisamiskood jääb samaks. Kui pilt ei laadi, näitab sait jutumulli
Ikooni taust Rinni jaoks: taustata (vaikimisi) või valge ring — Rinni jääb tervikuna sisse ega kao kirjul saidil. Jutumull ja oma ikoon on juba ringis
Vihje külastajatele Mull (vaikimisi): 3 sekundi pärast ilmub nupu kõrvale kutse küsida, 15 sekundi pärast muutub see nupul täpiks. Silt: „Esitage küsimus“ libiseb nupu kõrvale 9 sekundiks. Väljas — vihjet pole. Üks kord külastuse jooksul; ristiga suletud mulli ei näidata 7 päeva. Ei näidata, kui vidin on avatud, saidi väli on fookuses või vahekaart on peidetud Nimega ikooni puhul tervitab mull selle nimel: „Tere, mina olen Rinni!“; telefonis on teine rida „Küsige minult!“.
Meenuta Signaalide järgi (vaikimisi): rõngad nupu ümber, kui külastaja otsib vastust — 25 sekundit tegevuseta, lehe kerimine üles ja alla, külastuse kolmas leht; muidu iga 60–90 sekundi järel. Aeg-ajalt — ainult iga 60–90 sekundi järel. Mitte kunagi. Kõige rohkem 3 korda lehe kohta, pärast vidina avamist enam mitte. Süsteemi seadega „vähenda liikumist“ rõngaid ega hüppeid pole
Oma vihjetekst Iga keele jaoks oma, kuni 140 tähemärki. Keel ilma oma tekstita saab standardteksti külastaja keeles
Abilise nimi Kuni 7 märki (tähed, numbrid, tühik, sidekriips), üks kõigile keeltele, iga ikooniga: abiline tervitab mullis „Tere, mina olen …!“ ja tutvustab end vidina aknas. Tühi — Rinni nimi on „Rinni“, jutumullil ja oma ikoonil nime pole
Telefonis ja saidi ribade kohal Telefonis on nupp väiksem ja nurgale lähemal; mull näitab pealkirja ja lühikest rida, ilmub 5 sekundi pärast ja sulgub 8 sekundi pärast. Igas seadmes: kui ekraani allservas nupu all on saidi kinnitatud riba (küpsiste bänner, alumine menüü), tõuseb nupp selle kohale ja vihje ootab, kuni riba kaob
Vaikekeel Rakendub ainult siis, kui külastaja keel ei ole teada: külastaja valik vidina aknas ja tema brauseri keeled on tugevamad. Saidi lehe keelt ei arvestata
Saidi aadress Kus vidin töötab; mitu aadressi eraldatakse komaga. Ilma aadressita vidinat sisse ei lülita
Jalus „Powered by Lynkora“ Saab peita pakettides, kus on oma bränd

#Kaks autentimisrežiimi (ADR 0032)

LiKE-s saab vidin töötada ühes kahest režiimist — valitakse loomisel:

1. režiim — lubatud aadressid
Avalike saitide jaoks
Vidin maandumislehel, turunduslehtedel, kasutajatoe keskuses. Autentimine on anonüümne — kasutada saab iga külastaja.
Kaitse:
  • Lubatud aadresside loend, kus api-võti kehtib
  • Ulatus __public__ või konkreetsed avalikud kogud
  • Päringupiir iga api-võtme kohta
2. režiim — seansi JWT
Sisselogimisega ettevõttesaidi jaoks
Vidin ettevõtte sisevõrgus või SaaS-rakenduses. Vidin võtab vastu kasutaja seansi JWT ja näeb täpselt seda, millele tal on juurdepääs.
Kasutus:
  • Ettevõtte sisemine portaal
  • SSO-d arvestav vidin oma tootes
  • Näeb kasutaja alasid

Mõlema režiimi seadistamisest ja teie taustasüsteemiga liidestamisest lähemalt — API ja vidin.

#Ulatus: mida vidin leida saab

Vidina loomisel määratakse ulatus — mille seast ta otsib:

Ulatuse kirjed
public_umbrella — organisatsiooni kõik avalikud artiklid (lubatud aadressidega vidina jaoks)
space:<id> — konkreetne ala (seansi-JWT vidina jaoks)
collection:<id> — konkreetne kogu (kitsas ulatus, näiteks ainult KKK)

Ühes vidinas saab ulatuse kirjeid kombineerida (näiteks kaks kogu ühest alast).

#Mitu vidinat ühel organisatsioonil (ADR 0029, 4. etapp)

Organisatsioonis saab luua mitu sõltumatut vidinat eri ulatuste ja režiimidega:

Vidin Ulatus Kuhu lisatud
Marketing site widget public_umbrella (avalik teadmusbaas) Saidil yourcompany.com — anonüümne
Support center widget collection:faq-coll Saidil support.yourcompany.com — ainult KKK
Intranet widget space:eng-space (JWT järgi) Saidil intranet.yourcompany.com — ettevõttesisene, näeb alasid õiguste järgi

Igaühel on oma api-võti ja kasutusstatistika ning võtme saab eraldi tühistada. Haldus: Integratsioonid → Kanalid → JS Widget → „Halda vidinaid“.

#Seansside haldamine (seansi-JWT režiim)

Seansi-JWT režiimis on igal kasutajaseansil ainulaadne sessionId. Administraator näeb konkreetse vidina aktiivseid seansse ja saab loa sunniviisiliselt tühistada (näiteks kui kahtlustatakse lekkimist). Loend: Integratsioonid → Vidinad → [vidin] → Seansid.

#iframe ja otselink

Lisage LiKE täielik otsinguliides ükskõik millisele lehele:

  1. Integratsioonid → iframe → kopeerige kood
  2. Kleepige <iframe src="..."> oma lehele
  3. Või kasutage üleminekuks otselinki (terve leht, mitte lisatud plokk)

Ka iframe ja otselink toetavad mõlemat autentimisrežiimi — valitakse loomisel.

#REST API

Täisväärtuslik API programmiliseks liidestamiseks (näiteks teie oma kasutajaliides või liides teiste süsteemidega):

  1. Integratsioonid → Public API → „Loo võti“
  2. Märkige nimi ja lubatud domeenid
  3. Kopeerige võti — seda näidatakse ainult üks kord, uuesti avades on see varjatud

Kasutage võtit päises X-API-Key. Võtme järgi antakse ainult avalikke artikleid.

Peamised otspunktid:

Otspunkt Mida teeb
POST /api/public/search AI-otsing teadmusbaasist (kogu tee: leidmine, vastus, allikad)
GET /api/public/toc Avalike artiklite sisukord
GET /api/public/articles Avalike artiklite loend
GET /api/public/articles/{id} Artikli sisu

Piirid: päringud on iga võtme kohta piiratud; ületamisel tuleb HTTP 429 koos päisega Retry-After.

API täielik dokumentatsioon: API ja vidin.


#Keeled

LiKE toetab AI-otsingus ja keeltevahelises otsingus üle 25 keele (liides ise on saadaval 12 keeles):

Eesti, Русский, English, Deutsch, Français, Español, Português, Italiano, Nederlands, Polski, Čeština, Svenska, Dansk, Suomi, Română, Magyar, Hrvatski, Türkçe, Afrikaans, Kiswahili, Bahasa Indonesia, Tiếng Việt, Українська, Српски, Български, Ελληνικά, 한국어, 日本語, 中文, हिन्दी, ไทย, עברית, العربية.

Keeltevaheline otsing: küsimus ühes keeles → vastus teises keeles kirjutatud artiklitest.