Интеграције

Контролна табла → Интеграције — повежите изворе садржаја и канале за приступ знању.

#Извори садржаја

#Повезани (увек активни)

#Доступни конектори

#Повезивање GitHub-а

#Корак 1 — Ауторизација

1. У LiKE идите на Интеграције → GitHub → „Повежи“
2. Изаберите метод ауторизације:

#Корак 2 — Избор садржаја

1. Након повезивања приказује се стабло репозиторијума са фасциклама и фајловима
2. Штиклирајте одређене фајлове или фасцикле за увоз (Selective Sync)
3. Подржани формати: .md, .mdx, Wiki странице

#Корак 3 — Покретање синхронизације

1. Кликните „Sync“
2. Напредак се приказује у реалном времену
3. По завршетку, чланци се појављују на листи са ознаком GitHub

#Повезивање GitLab-а

#Корак 1 — Ауторизација

1. У LiKE идите на Интеграције → GitLab → „Повежи“
2. Изаберите метод ауторизације:

#Корак 2 — Избор садржаја

1. Приказује се стабло пројекта са Wiki страницама и Markdown фајловима
2. Штиклирајте одређене странице за увоз (Selective Sync)

#Корак 3 — Покретање синхронизације

Исто као GitHub — кликните „Sync“ и сачекајте да се заврши.

#Повезивање Gitea

Gitea је self-hosted git платформа. Повезује се преко Personal Access Token-а и обавезног URL-а Ваше инстанце (подразумевано не постоји cloud Gitea).

#Корак 1 — Креирајте токен у Gitea

1. У Gitea отворите Settings → Applications → Generate New Token
2. Доделите scope-ове read:repository и read:user
3. Копирајте токен

#Корак 2 — Повежите у LiKE

1. У LiKE идите на Интеграције → Gitea → „Повежи“
2. Наведите Base URL Ваше инстанце (на пример https://gitea.company.com) — ово поље је обавезно, без њега повезивање неће проћи
3. Налепите токен
4. Изаберите простор/колекцију и режим (Sync — непрекидно огледало / Import — једнократна копија)

Подржан је и OAuth 2.0 ако је администратор Gitea унапред подесио OAuth апликацију. Примарна путања је токен.

#Корак 3 — Избор садржаја и синхронизација

1. Приказује се стабло репозиторијума са Wiki страницама и Markdown фајловима (.md, .mdx)
2. Штиклирајте потребне чворове (Selective Sync) и кликните „Sync“
3. За аутоматска ажурирања при push-у, подесите webhook — тајна се генерише у картици конектора. Чланци из Gitea су read-only (као код GitHub/GitLab)

#Избор фајлова и филтери синхронизације (GitHub, GitLab, Gitea)

За git изворе (GitHub, GitLab и Gitea) логика избора онога што се синхронизује сложенија је од простог „репозиторијум укључен/искључен“:

#Шта се синхронизује

#Филтери путања (selective sync)

Можете прецизно сузити шта да се узме из репозиторијума:

#Откривање промена (recent changes)

LiKE не „преузима све“ при сваком покретању. Користи се откривање промена:

• GitHub — преко webhook-а (препоручено) или polling-ом уз If-Modified-Since заглавља. Webhook реагује на push истог тренутка, polling — сваких 6/12/24/48 сати (зависи од аутоматске синхронизације).
• GitLab — исто тако: webhook или polling по last_activity_at преко Projects API.
• Gitea — webhook (X-Gitea-Signature потпис) или polling. Push окидач се активира само када се промени *.md/*.mdx.

Када се промена открије, синхронизују се само погођени фајлови; остатак корпуса се не прерачунава. Ово штеди много GitHub/GitLab API квоте и времена извршавања.

#Грана и тагови

#Историја и конфликти

• Историја синхронизације — картица „Историја“ у картици конектора: датум, статус (✅ ok / ⚠ упозорења / ❌ грешка), број додатих / ажурираних / обрисаних чланака, трајање покретања. Корисно за отклањање грешака „зашто се чланак из репозиторијума није појавио“.
• Конфликти уређивања — ако је чланак из извора уређен у LiKE (за GitHub/GitLab то није дозвољено подразумевано — чланци су read-only). Ако је режим Import (једнократна копија), чланци постају уредиви, а веза са извором се прекида.

#Selective Sync за друге конекторе

Notion, Confluence, Wiki.js — они имају сопствену логику избора (стабло страница), али је принцип исти:

1. При повезивању приказује се стабло садржаја извора
2. Квадратићи за штиклирање — означите потребне чворове
3. Остало се не увози
4. При поновној синхронизацији ажурирају се само изабране ставке

#Повезивање Wiki.js

#Корак 1 — Набавите Wiki.js API токен

1. Отворите свој Wiki.js → Administration → API Access
2. Омогућите API (ако је онемогућен)
3. Кликните New API Key
4. Именујте кључ (на пример LiKE Integration)
5. Group: Administrators (потребан је приступ свим страницама)
6. Expiration: без истека или 1 година
7. Копирајте генерисани токен

#Корак 2 — Повежите у LiKE

1. У LiKE идите на Интеграције → Wiki.js → „Повежи“
2. Унесите URL Вашег Wiki.js (на пример https://wiki.company.com)
3. Налепите API токен
4. Изаберите режим:

5. Кликните Save

#Корак 3 — Подесите синхронизацију

#Повезивање Confluence

Confluence се повезује преко OAuth 2.0 — безбедна ауторизација без уноса лозинки.

#Корак 1 — Кликните „Connect Confluence“

1. У LiKE идите на Контролну таблу → Интеграције
2. Пронађите картицу Confluence → кликните „Повежи“
3. Отвара се Atlassian прозор за ауторизацију

#Корак 2 — Ауторизујте се у Atlassian

1. Пријавите се на свој Atlassian налог (ако већ нисте)
2. Atlassian приказује захтев: „LiKE тражи приступ Вашем Confluence-у“
3. Прегледајте дозволе — LiKE тражи read-only: садржај страница и листу простора
4. Кликните „Accept“

#Корак 3 — Враћате се у LiKE

Након потврде аутоматски се преусмеравате назад на Интеграције. Картица Confluence приказује:

• Статус: Повезано
• Име Вашег Confluence сајта
• Дугме „Sync“

#Корак 4 — Покрените синхронизацију

1. Кликните „Sync“ за први увоз
2. LiKE учитава све странице из доступних Confluence простора
3. Чланци се појављују у каталогу знања

#Корак 5 — Подесите аутоматску синхронизацију

Отворите подешавања (икона зупчаника на картици Confluence):

Чланци из Confluence-а су read-only. За уређивање, промените оригинал у Confluence-у, а LiKE ће ажурирати при следећој синхронизацији.

При искључивању Confluence-а можете задржати копију чланака у LiKE (постају уредиви) или их обрисати.

#Повезивање Notion

#Корак 1 — Креирајте интеграцију у Notion

1. Отворите Notion → кликните свој аватар (горњи леви угао) → Settings
2. У левом менију изаберите My connections (или Integrations)
3. Кликните Develop or manage integrations → New integration
4. Унесите име (на пример LiKE Import), изаберите workspace
5. Кликните Submit → копирајте Internal Integration Secret (почиње са ntn_; за старије интеграције — са secret_)

#Корак 2 — Дајте интеграцији приступ страницама

Подразумевано, интеграција нема приступ ниједној страници. Морате јој експлицитно дозволити:

1. У Notion отворите сваку страницу (или родитељску страницу/базу података) коју желите да увезете
2. Кликните ⋯ (три тачке, горњи десни угао) → Connect to → изаберите своју LiKE Import интеграцију
3. Потврдите приступ

#Корак 3 — Повежите у LiKE

1. У LiKE → Контролна табла → Интеграције → Notion → „Повежи“
2. Налепите Integration Secret (копиран у кораку 1)
3. Изаберите простор за увоз (постојећи или креирајте нови)
4. Изаберите режим:

5. Кликните „Повежи“
6. LiKE учитава све странице којима интеграција има приступ

#Корак 4 — Подесите аутоматску синхронизацију

Отворите подешавања (икона зупчаника на картици Notion):

При искључивању Notion-а можете задржати копију чланака у LiKE (постају уредиви) или их обрисати.

#Повезивање сајта документације

Конектор преузима чланке са јавног сајта: чита његову мапу (sitemap) и одржава копију у LiKE. Користан је када је документација већ објављена — на сопственом домену, у Docusaurus, GitBook, Docsify и сличним алатима.

#Корак 1 — адреса сајта

Интеграције → Сајт документације → Повежи сајт. Налепите адресу — може и адреса било које странице, сајт узимамо у целини. Мапу тражимо сами: прво преко robots.txt, затим преко /sitemap.xml.

#Корак 2 — шта смо пронашли

Притисните Провери сајт. Провера ништа не чува: само чита мапу и приказује колико је страница пронађено и колико ће бити додато уз примењене филтере. Ако мапе нема, повезивање се не покреће и то ћемо рећи отворено, уместо да тихо увеземо нулу.

#Корак 3 — где сместити

Изаберите простор и колекцију — колекција може да се направи и у самом чаробњаку. После Повежи обилазак почиње одмах: напредак се види на картици конектора („Обилазимо сајт 22 од 92“) и у приказу позадинских задатака.

#Шта се преузима, а шта не

• преузима се садржај странице, без менија, заглавља и подножја сајта;
• Секције сајта ограничавају обилазак путањама (/docs/, /guides/); празно значи цео сајт;
• сервисне секције попут претраге и ознака подразумевано се прескачу;
• Највише страница по пролазу ограничава један пролаз — заштита од огромних сајтова;
• странице забрањене у robots.txt не преузимамо; њихов број видљив је у извештају о пролазу.

#Наредна ажурирања

Уз укључену аутоматску синхронизацију поново читамо сајт по распореду. Поново се индексирају само измењене странице — тако и пише у извештају: „додато“, „ажурирано“, „без измена“. Неизмењене странице не троше лимит индексирања.

Уклањај нестале странице подразумевано је искључено: ако страница нестане са сајта, чланак остаје у Вашој бази. Укључите га када копија мора строго да прати сајт.

#Који сајтови су погодни, а који нису

Погодан је јаван сајт са мапом (sitemap) — тако раде готово сви генератори документације. Остало одбијамо већ на кораку провере, а не после повезивања:

И када је сајт повезан, поједине странице могу изостати: оне забрањене у robots.txt, оне које враћају грешку, веће од 10 MB или оне које не враћају HTML. Све оне стоје у извештају о пролазу с разлогом — „прескочено“ и „забрањено у robots.txt“.

Фајлови (PDF, ZIP, слике) се са сајта не преузимају. За њих постоји посебан пут — увоз фајлова, са сопственом обрадом.

#Ограничења

• један сајт по организацији;
• сајт мора бити јаван — странице иза лозинке се не читају;
• потребна је мапа сајта: без ње нема повезивања;
• поштујемо robots.txt, укључујући и паузу између захтева коју он наводи.

Искључивање. Синхронизација престаје, а већ преузете чланке можете обрисати или задржати као обичне — LiKE то пита при искључивању.

#Увоз фајлова

#Отпремање фајлова

1. Контролна табла → Увоз
2. Превуците фајлове или кликните зону за отпремање
3. Подржани формати: PDF, DOCX, TXT, MD, RTF, ZIP
4. AI аутоматски генерише наслов и slug за сваки фајл
5. Пре објављивања можете уредити наслов или га отворити у уреднику

#ZIP архиве

Отпремите ZIP архиву са много докумената — LiKE аутоматски распакује и обради сваки фајл. Згодно за миграцију целе базе знања.

Подржани фајлови унутар ZIP-а: PDF, DOCX, TXT, MD, RTF. Остали фајлови (слике, извршни фајлови) се прескачу.

#Увоз преко везе

Налепите везу до документа — LiKE га преузима и увози:

1. Контролна табла → Увоз → одељак „Увоз преко везе“
2. Налепите URL → кликните „Додај“
3. Можете додати до 10 веза одједном
4. Кликните „Увези“

Подржани извори:

• Google Docs — аутоматски извезен као DOCX
• Google Sheets — извезен као CSV
• Dropbox — директна веза до фајла
• Било који директан URL до PDF, DOCX, TXT, MD или RTF фајла

#Подразумевана видљивост

За сваки извор можете подесити подразумевану видљивост:

• Нацрт — чланци се креирају скривени
• Тим — видљиви ауторизованим корисницима
• Јавно — видљиви свима, укључујући анонимне кориснике

Подешава се у Интеграције → картица извора → Видљивост.

#Канали приступа

Канали омогућавају Вашим запосленима да траже информације кроз познате алате.

#Slack бот

Могућности:

• /like how do I set up SSO? → AI одговор директно у Slack-у
• Помињање @LiKE у било ком каналу → одговор у нити
• Везе до изворних чланака (кликабилне)

#Telegram бот

Могућности:

• Директне поруке боту → AI одговор
• У групном ћаскању: /ask question → одговор
• Подршка за 25+ језика

#JS виџет (за Ваш сајт)

Плутајуће дугме за AI претрагу за уграђивање на било који сајт. Најпопуларнија интеграција — корисник види дугме у углу странице, кликне на њега, и отвара се ћаскање са AI и претрага кроз Вашу базу знања.

#Једноставна инсталација

#Основни параметри

#Dual-auth: два режима аутентификације (ADR 0032)

У LiKE виџет може радити у једном од два режима — бира се приликом креирања:

За детаље о подешавању сваког режима и интеграцији са Вашим backend-ом, погледајте API и виџет.

#Scope: шта виџет може да пронађе

Приликом креирања виџета постављате scope — шта тачно претражује:

Унутар једног виџета можете комбиновати неколико ставки scope-а (на пример, две колекције из истог простора).

#Multi-widget по тенанту (ADR 0029 Stage 4)

Унутар организације можете креирати неколико независних виџета са различитим scope-овима и режимима:

Сваки има сопствени api-key и аналитику коришћења, а кључ се може опозвати независно. Управљање је у Интеграције → Виџети → „+ Креирај“.

#Управљање сесијама (режим Session JWT)

У режиму Session JWT, свака корисничка сесија има јединствен sessionId. Администратор може прегледати активне сесије одређеног виџета и присилно опозвати токен (на пример, ако се сумња на компромитацију). Листа је у Интеграције → Виџети → [виџет] → Сесије.

#iframe / Директан линк

Уградите пун LiKE интерфејс за претрагу на било коју страницу:

1. Интеграције → iframe → копирајте код
2. Налепите <iframe src="..."> у своју страницу
3. Или користите директну везу за навигацију (пуна страница, не уграђивање)

iframe и Direct Link такође подржавају dual-auth — бира се приликом креирања.

#REST API

Пун API за програмску интеграцију (на пример, Ваш сопствени UI или интеграција са другим системима):

1. Интеграције → API Keys → „Креирај кључ“
2. Наведите име (за шта служи кључ) и scope (исто као за виџет — public_umbrella / space / collection)
3. Копирајте кључ — приказује се само једном, након поновног отварања биће маскиран

Користите кључ у X-API-Key заглављу или као Bearer токен.

Главни endpoints:

Ограничења: rate limits зависе од плана и везани су за api-key. Прекорачење враћа HTTP 429 са Retry-After заглављем. Тачне вредности за Ваш план су на страници Планови и у админ панелу.

Пуна API документација: API и виџет.

#Језици

LiKE подржава 25+ језика за AI претрагу и вишејезичну претрагу (сам интерфејс је доступан на 11 UI локала):

Русский, 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, Українська, Српски, Български, Ελληνικά, 한국어, 日本語, 中文, हिन्दी, ไทย, עברית, العربية.

Вишејезична претрага: питање на једном језику → одговор из чланака на другом.