Knowledge base қалай жасалады: мақалалар, іздеу, рұқсаттар және AI жауаптары

Knowledge base — жауаптардың іздеуге болатын кітапханасы: бір нәрсені қалай жасау керек, бір нәрсені қалай түзету керек, ереже қандай. Оны жасау үшін бірнеше санатқа топтастырылған мақалалар, жазушыларыңыз шынымен пайдаланатын редактор, адамдардың нақты теретін сөздерінен дұрыс мақаланы табатын іздеу және кім не оқи алатыны туралы шешім керек: жалпы көпшілік, жүйеге кірген клиенттер немесе тек қызметкерлер. AI құру құралы құрылымды, редакторды және іздеуді қысқа сессияда жасап бере алады. Knowledge base-ті пайдалы ететін — жазу сапасы мен жаңартып отыру, сондықтан бірінші күннен бастап оңай өңделетін жүйе жасап, ескірген мақалаларды байқауды жоспарлаңыз.

Алдымен кім үшін екенін шешіңіз

Бір функция әртүрлі сайттарға қызмет етеді:

• Ашық анықтама орталығы — клиенттер мен болашақ клиенттерге арналған. Жылдам, іздеу жүйелері индекстейтін және олардың өз сөздерімен жазылған болуы керек.
• Тек клиенттерге арналған құжаттама — логин арқылы, ақы төлеп жүрген клиенттерге немесе серіктестерге.
• Ішкі knowledge base — қызметкерлерге арналған саясаттар, процестер, нұсқаулықтар. Жеке болуы керек; іздеу мен жаңалық дизайннан маңыздырақ.

Көпшілікке және ішкі мақалаларды бір сайтта араластыру — деректердің ағып кетуінің ең көп себебі. Екеуі де керек болса, әр мақалаға нақты көрінімділік параметрін беріңіз немесе екі бөлек сайт жасаңыз.

Қолданба не қажет етеді

Деректер

Екі өріс көп жұмыс атқарады: иесі (мақаланың дәлдігін кім қадағалайды) және соңғы тексерілген уақыт (соңғы рет кім оның әлі дұрыс екенін растады). Осылайша алты ай бойы ешкім тексермеген мақалаларды тізімдеуге болады.

Беттер

• Оқырман: іздеуі мен санаттары бар басты бет, санат беттері, мазмұн кестесі бар мақала беттері, байланысты мақалалар және «Бұл пайдалы болды ма?» сұрағы.
• Редактор: сүзгілері бар мақалалар тізімі (қоралар, ескірген, төмен бағаланған), алдын ала қарауы бар редактор және нұсқалар тарихы.
• Әкімші: санаттар, пайдаланушылар мен рөлдер, нәтижесіз іздеу сұраныстары туралы есептер.

Рұқсаттар

Оқырмандар рұқсаты бар жарияланған мақалаларды көреді. Редакторлар мақалаларды жасайды және өңдейді, мүмкін тек белгілі санаттарда. Әкімшілер жариялайды, мұрағаттайды және пайдаланушыларды басқарады. Ішкі knowledge base-те барлығына логин керек; ашық анықтама орталығында тек жазушыларға.

Шешімдер мен компромисстер

Редактор: Markdown немесе rich text

Markdown жылдам, портативті және нұсқалар тарихымен жақсы жұмыс істейді, бірақ кейбір жазушыларға ұнамауы мүмкін. Rich-text редакторы тақырыптар, тізімдер, суреттер, ескертпелер және код блоктарымен таныс сезіледі. Қайсысын таңдасаңыз да, мазмұнды кейін экспорттауға болатын форматта сақтаңыз.

Іздеу

Егер тақырыптарды, қысқаша мазмұнды және мәтінді іздейтін болсаңыз, бірнеше жүз мақалаға дерекқордың қарапайым мәтіндік іздеуі жеткілікті; тақырып сәйкестігін жоғары рейтингте көрсетіңіз. Одан көп болса, немесе қателер мен синонимдер маңызды болса («шот» пен «счет»), толық мәтіндік іздеуді немесе хостингтік іздеу қызметін пайдаланыңыз. Іздеуді қосу нұсқаулығы опцияларды түсіндіреді. Нәтиже бермеген әр сұранысты жазып отырыңыз: бұл жазуға арналған мақалалардың тегін тізімі.

AI жауаптары

Мақалаларыңыздан жауап беретін «сұрақ қойыңыз» жолағы қазір кең таралған. Ол ең тиісті үзінділерді табу арқылы жұмыс істейді және тіл моделінен тек соларға сүйенуді сұрайды — RAG деген не деген мақалаға қараңыз. Әрқашан дереккөз мақалаларды көрсетіңіз, «білмеймін» деген жауапқа рұқсат беріңіз және ескірген мазмұнды AI сенімді түрде қайталайтынын ескеріңіз. Мұны мақалалар жақсы күйге келгеннен кейін жасаңыз, алдын емес.

Нұсқалау және тексеру

Кім не өзгерткенін көру және кері қайтару үшін нұсқаларды сақтаңыз. Реттелетін мазмұн үшін (HR саясаты, қауіпсіздік нұсқаулықтары) өзгеріс жарияланбай тұрып мақұлдау қадамын қосыңыз.

Жұмыс істейтін алғашқы промпт

Parcelly үшін ашық анықтама орталығын жаса — шағын онлайн дүкендерге арналған жөнелту жапсырмалары қолданбасы. Басты бетте үлкен іздеу жолағы және алты санат болсын (Бастау, Жапсырмаларды басып шығару, Тасымалдаушылар, Төлем, Қайтару, Ақауларды жою). Мақалаларда атауы, қысқаша мазмұны, Markdown мәтіні (суреттер мен ескертпелермен), санаты, тегтері, мәртебесі (қоралау, жарияланған, мұрағатталған), иесі және соңғы тексерілген күні болсын. Мақала беттерінде мазмұн кестесі, байланысты мақалалар және «Бұл пайдалы болды ма?» иә/жоқ сұрағы, қосымша пікірмен бірге болсын. Іздеу тақырыптарды, қысқаша мазмұнды және мәтінді қамтысын, тақырып сәйкестіктері алдымен көрсетілсін, әр сұраныс және нәтиже бар-жоғы журналға жазылсын. Редактор аймағы (кіру қажет, рөлдері редактор және әкімші) қоралауды, 180 күн тексерілмеген мақалаларды және төмен пайдалы балл алған мақалаларды тізімдесін, нұсқалар тарихын сақтасын. Әр мақаланың өз бет тақырыбы және meta сипаттамасы іздеу жүйелері үшін болсын. Таза, сабырлы, оқуға ыңғайлы дизайн. Алдымен мобильді.

Құрастыру қадамдары

1. Алғашқы 20–30 мақалаңызды тізіңіз нақты қолдау сұрақтарынан, ештеңе жасамас бұрын. Бұл тізім санаттарды анықтайды.
2. Сайтты жасаңыз және телефонда оқуды тексеріңіз — жол ұзындығы, тақырыптар, суреттер.
3. Редактор және рөлдер. Жазушылар әзірлеушіні сұрамай-ақ мақалаларды қосып, түзету алуы керек.
4. Іздеу, содан кейін оны клиенттер нақты қолданатын сөздермен, соның ішінде қате жазылған сөздермен тексеріңіз.
5. Пікірлер мен іздеу журналы.
6. Ескірген мақалалар есебі иесі мен соңғы тексерілген күн бойынша.
7. SEO негіздері ашық сайт үшін: бірегей тақырыптар, сипаттамалар, таза URL-дер, sitemap. AI арқылы жасалған сайттардың SEO-сы қараңыз.
8. Оны өнімізден және қолдау жауаптарыңыздан сілтеп қойыңыз, содан кейін жауапсыз сұраныстар журналын апта сайын бақылаңыз.
9. AI жауаптары — мазмұн нығайғаннан кейін.

Жиі кездесетін қателер

• Бөлімдер бойынша ұйымдастыру оқырман не істегісі келетініне қарай емес.
• Бес тапсырманы қамтитын ұзын мақалалар. Мақаланы бір тапсырмаға арнаңыз, тақырыбы нені шешетінін айтсын.
• Әр мақаланың иесі жоқ. Ешкім жаңартпайды, ал алғашқы қате жауаптан кейін сенім төмендейді.
• Ішкі жазбалар ашық мақалаларда. Бөлек көрініс параметрін қолданыңыз және жариялау алдында тексеріңіз.
• Тек тақырыптарды сәйкестендіретін іздеу. Оқырмандар мақала атауын емес, белгілерін теріп іздейді.
• Альт мәтінсіз немесе контекстсіз скриншоттар. Олар тез ескіреді; қадамды мәтінмен де сипаттаңыз.

Дайын өнім жақсырақ болғанда

Командаңыз құжаттама немесе wiki құралында жұмыс істесе, ішкі knowledge base-ті сонда жасау ең оңай жол — Notion vs Confluence салыстыруы екі кең таралған таңдауды қарастырады. Helpdesk өнімін қолдансаңыз, оның кірістірілген анықтама орталығы мақалаларды тикеттерге байланыстырады және клиенттерге мақала ұсынады, оны қайталау қиын. Әзірлеушілер құжаттамасы үшін код жанында тұрған документация сайттарының генераторлары ең жақсы.

Өз құрылымыңыз немесе рұқсаттарыңыз керек болғанда (клиентке, орнына немесе рөлге бөлек мақалалар), knowledge base-тің сыртқы сайтта емес, өніміңіздің ішінде болуын қаласаңыз, wiki жүйесі қамтамасыз етпейтін қарау және мақұлдау қадамдарын қажет етсеңіз немесе бөлек жазылымсыз мазмұныңыз бойынша AI жауаптарын бөлек жазылымсыз қаласаңыз, өзіңіз жасаңыз. Ол тапсырма жүйесімен тамаша үйлеседі.

Mythex-пен құру

Mythex-те knowledge base-ті чатта сипаттайсыз, ол тірі алдын ала қарауда жасалады; мақалалар, нұсқалар және пікірлер агент қосқан Postgres дерекқорында сақталады, ал суреттер жобаның файл сақтауына түседі. Редактор кірісі үшін сіз таңдаған аутентификация тәсілі қолданылады, себебі Mythex-те соңғы пайдаланушыға арналған кіру жоқ. AI жауаптары үшін өз AI провайдеріңіздің API кілтін жоба құпиясы ретінде сақтайсыз, ал пайдалану Mythex кредиттерінен емес, сіздің провайдер аккаунтыңыздан төленеді (AI рецепті). Жаңа Mythex қолданбалары әдепкі бойынша клиент жағында рендерленетін React бір беттік қолданба болып келеді, ол іздеу жүйелері үшін әлсіз; сондықтан ашық анықтама орталығы үшін статикалық-ыңғайлы немесе сервер жағында рендерленетін конфигурацияны, мысалы Next.js-ті сұраңыз (SEO рецепті).

Алғашқы промпт үшін өнім білім орталығы немесе команда құжаттамасы қолданбасы шаблондарын қараңыз.

Сұрақтар