Како да направите база на знаења: статии, пребарување, дозволи и AI одговори

Базата на знаења е пребарлива библиотека со одговори: како да се направи нешто, како да се реши нешто, кое е правилото. За да изградите една, ви требаат статии групирани во неколку јасни категории, уредник што вашите писатели навистина ќе го користат, пребарување што ја наоѓа вистинската статија според зборовите што луѓето навистина ги пишуваат, и одлука кој што може да чита — јавноста, клиентите со најава или само вработените. AI градител на апликации може да ја направи структурата, уредникот и пребарувањето во кратка сесија. Она што ја прави базата на знаења корисна е пишувањето и одржувањето, па дизајнирајте за лесно уредување и за откривање застарени статии уште од првиот ден.

Прво одлучете за кого е

Истите функции служат за многу различни сајтови:

• Јавен центар за помош — за клиенти и потенцијални клиенти. Мора да биде брз, индексибилен од пребарувачите и напишан со нивни зборови.
• Документација само за клиенти — зад најава, за платени клиенти или партнери.
• Внатрешна база на знаења — политики, процеси, упатства за вработените. Мора да биде приватна; пребарувањето и свежината се поважни од дизајнот.

Мешањето јавни и внатрешни статии на еден сајт е местото каде најчесто настануваат протекувања. Ако ви требаат двете, дајте на секоја статија јасна поставка за видливост или управувајте со два одделни сајта.

Што му треба на апликацијата

Податоци

Два полиња прават многу работа: сопственик (кој ја одржува статијата точна) и последен преглед (кога некој последен пат потврдил дека е сè уште точна). Заедно ви овозможуваат да ги наведете статии што никој не ги проверил шест месеци.

Страници

• Читач: почетна со пребарување и категории, страници за категории, страници за статии со содржина, поврзани статии и прашање „Дали ви помогна?“.
• Уредник: листа на статии со филтри (нацрти, застарени, со ниски оценки), уредник со преглед и историја на ревизии.
• Админ: категории, корисници и улоги, и извештаи за пребарувања без резултати.

Дозволи

Читателите ги гледаат објавените статии што им е дозволено да ги видат. Уредниците создаваат и уредуваат статии, можеби ограничени на одредени категории. Админите објавуваат, архивираат и управуваат со корисниците. За внатрешна база на знаења, сите мора да имаат најава; за јавен центар за помош, најава ја имаат само писателите.

Одлуки и компромиси

Уредник: Markdown или богат текст

Markdown е брз, преносен и добро функционира со историја на верзии, но некои писатели го сметаат за незгоден. Уредник со богат текст со наслови, листи, слики, истакнати белешки и блокови со код изгледа познато. Што и да изберете, чувајте ја содржината во формат што подоцна можете да го извезете.

Пребарување

Основното текстуално пребарување во база е доволно за неколку стотини статии ако ги пребарувате насловите, резимеата и содржината, и ги рангирате совпаѓањата во насловите повисоко. Над тоа, или ако се важни грешките во пишувањето и синонимите („фактура“ наспроти „сметка“), користете вистинско full-text пребарување или хостирана услуга за пребарување. Нашиот водич за додавање пребарување ги минува опциите. Евидентирајте секое барање што не враќа ништо: тоа е бесплатна листа на статии што треба да ги напишете.

AI одговори

Полето „постави прашање“ што одговара од вашите статии сега е вообичаено. Работи така што ги наоѓа најрелевантните пасуси и му бара на јазичен модел да одговара само од нив — видете што е RAG. Секогаш покажувајте ги изворните статии, дозволете „не знам“ и имајте на ум дека ќе ја повтори самоуверено секоја застарена информација во статиите. Изградете го откако статиите ќе бидат во добра форма, не порано.

Верзионирање и преглед

Чувајте ревизии за да видите кој што променил и да можете да се вратите назад. За регулирана содржина (HR политики, безбедносни процедури), додајте чекор на одобрување пред промената да се објави.

Прв промпт што функционира

Направи јавен центар за помош за Parcelly, апликација за шипинг етикети за мали онлајн продавници. Почетна со големо поле за пребарување и шест категории (Почеток, Печатење етикети, Превозници, Наплата, Враќања, Решавање проблеми). Статиите имаат наслов, резиме, содржина во Markdown со слики и истакнати белешки, категорија, ознаки, статус (нацрт, објавена, архивирана), сопственик и датум на последен преглед. Страниците со статии прикажуваат содржина, поврзани статии и „Дали ви помогна?“ да/не со незадолжителен коментар. Пребарувањето ги опфаќа насловите, резимеата и содржината, со совпаѓања во насловите рангирани прво, и ја бележи секоја заявка и дали вратила резултати. Област за уредници (потребна најава, улоги editor и admin) ги прикажува нацртите, статиите што не се прегледани 180 дена и статиите со ниски оценки за корисност, и ја чува историјата на ревизии. Секоја статија има своја страница со наслов и meta опис за пребарувачите. Чист, смирен, читлив дизајн. Прво за мобилни.

Чекори за изградба

1. Наведете ги првите 20–30 статии од вистински прашања за поддршка пред било што да градите. Таа листа ги обликува категориите.
2. Генерирајте го сајтот и проверете го читањето на телефон — должина на редовите, наслови, слики.
3. Уредник и улоги. Писателите треба да додаваат и поправаат статии без да прашаат програмер.
4. Пребарување, па тестирајте го со зборовите што ги користат клиентите, вклучително и грешки во пишувањето.
5. Повратни информации и евидентирање на пребарувања.
6. Извештај за застарени статии според сопственикот и датумот на последен преглед.
7. SEO основи за јавен сајт: единствени наслови, описи, чисти URL-а, sitemap. Видете SEO за веб-страници направени со AI.
8. Поврзете го од вашиот производ и од вашите одговори на поддршката, па следете го дневникот на барања без резултати неделно.
9. AI одговори, откако содржината ќе биде цврста.

Чести грешки

• Организирање по одделение наместо по тоа што читателот сака да направи.
• Долги статии што покриваат пет задачи. Една задача по статија, со наслов што кажува што решава.
• Нема сопственик по статија. Никој ништо не ажурира, а довербата опаѓа по првиот погрешен одговор.
• Внатрешни белешки во јавни статии. Користете одделна видливост и прегледајте пред објавување.
• Пребарување што совпаѓа само со насловите. Читателите пишуваат симптоми, а не имиња на статии.
• Слики без alt текст или контекст. Брзо застаруваат; опишете го чекорот и со зборови.

Кога е подобар готов производ

Ако вашиот тим веќе работи во алатка за документација или wiki, внатрешна база на знаења таму обично е најлесниот пат — нашата споредба Notion наспроти Confluence ги опфаќа два вообичаени избора. Ако користите helpdesk производ, неговиот вграден центар за помош ги поврзува статиите со тикетите и им ги предлага на клиентите, што е тешко да се повтори. Генераторите на документациски сајтови се идеални за документација за програмери што се чува покрај кодот.

Градете сопствена кога ви требаат своја структура или дозволи (статии по клиент, по локација, по улога), кога сакате базата да биде внатре во вашиот производ наместо на посебен сајт, кога ви требаат чекори за преглед и одобрување што wiki не ги наметнува, или кога сакате AI одговори врз вашата содржина без уште една претплата. Природно се вклопува со сопствен helpdesk.

Изградба со Mythex

Во Mythex ја опишувате базата на знаења во чат и се гради во live преглед; статиите, ревизиите и повратните информации се чуваат во Postgres база што агентот ја додава кога е потребно, а сликите одат во file storage на проектот. Најавите за уредниците користат пристап за автентикација што го избирате, бидејќи Mythex нема вградена најава за крајни корисници. За AI одговори, користите API клуч од вашиот AI провајдер, чуван како project secret, а употребата се наплатува на сметката кај вашиот провајдер, а не со Mythex кредити (AI рецепт). Новите Mythex апликации по основно се React single-page апликации рендерирани на клиентот, што е послабо за пребарувачите, па за јавен центар за помош побарајте поставка погодна за статички или сервер-рендерирање, како Next.js (SEO рецепт).

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

Прашања