Cum construiești o bază de cunoștințe: articole, căutare, permisiuni și răspunsuri AI

O bază de cunoștințe este o bibliotecă searchabilă de răspunsuri: cum faci ceva, cum repari ceva, care este regula. Ca să o construiești, ai nevoie de articole grupate în câteva categorii clare, un editor pe care scriitorii tăi îl vor folosi cu adevărat, o căutare care găsește articolul potrivit după cuvintele pe care oamenii le scriu de fapt și o decizie despre cine poate citi ce — publicul, clienții autentificați sau doar personalul. Un constructor de aplicații cu AI poate produce structura, editorul și căutarea într-o sesiune scurtă. Ce face o bază de cunoștințe utilă este scrisul și întreținerea, așa că proiecteaz-o pentru editare ușoară și pentru identificarea articolelor învechite din prima zi.

Decide mai întâi pentru cine este

Aceleași funcționalități servesc site-uri foarte diferite:

• Centru de ajutor public — pentru clienți și potențiali clienți. Trebuie să fie rapid, indexabil de motoarele de căutare și scris în cuvintele lor.
• Documentație doar pentru clienți — în spatele unei autentificări, pentru clienții plătitori sau parteneri.
• Bază de cunoștințe internă — politici, procese, ghiduri pas cu pas pentru personal. Trebuie să fie privată; căutarea și prospețimea contează mai mult decât designul.

Amestecarea articolelor publice și interne pe același site este locul în care apar cele mai multe scurgeri. Dacă ai nevoie de ambele, dă fiecărui articol o setare clară de vizibilitate sau rulează două site-uri separate.

Ce are nevoie aplicația

Date

Două câmpuri fac multă treabă: proprietarul (cine se ocupă ca articolul să rămână corect) și ultima verificare (când a confirmat cineva ultima dată că e încă adevărat). Împreună îți permit să listezi articolele pe care nimeni nu le-a verificat de șase luni.

Pagini

• Cititor: pagina de start cu căutare și categorii, pagini de categorie, pagini de articol cu cuprins, articole similare și întrebarea „A fost util?”.
• Editor: lista de articole cu filtre (ciorne, învechite, cu scor mic), un editor cu previzualizare și istoricul reviziilor.
• Admin: categorii, utilizatori și roluri, plus rapoarte despre căutările fără rezultate.

Permisiuni

Cititorii văd articolele publicate pe care au voie să le vadă. Editorii creează și editează articole, eventual limitați la anumite categorii. Adminii publică, arhivează și gestionează utilizatorii. Pentru o bază de cunoștințe internă, toți au nevoie de un cont; pentru un centru de ajutor public, doar scriitorii.

Decizii și compromisuri

Editor: Markdown sau text formatat

Markdown este rapid, portabil și se înțelege bine cu istoricul versiunilor, dar unii scriitori îl consideră descurajant. Un editor de text formatat, cu titluri, liste, imagini, casete de atenționare și blocuri de cod, pare familiar. Oricare ai alege, stochează conținutul într-un format pe care îl poți exporta mai târziu.

Căutarea

Căutarea text din baza de date este suficientă pentru câteva sute de articole, dacă cauți în titluri, rezumate și conținut și pui potrivirile din titlu pe primul loc. Peste această dimensiune sau dacă greșelile de scriere și sinonimele contează („factură” față de „notă de plată”), folosește o căutare full-text adevărată sau un serviciu de căutare găzduit. Ghidul nostru despre cum adaugi căutare prezintă opțiunile. Notează fiecare interogare care nu returnează nimic: este o listă gratuită cu articolele pe care trebuie să le scrii.

Răspunsuri AI

O casetă „pune o întrebare” care răspunde din articolele tale este acum comună. Funcționează prin recuperarea pasajelor cele mai relevante și cererea adresată unui model de limbaj de a răspunde doar pe baza lor — vezi ce este RAG. Afișează întotdeauna articolele sursă, permite răspunsul „nu știu” și ține minte că va repeta cu încredere orice e învechit în articolele tale. Construiește-o după ce articolele sunt într-o formă bună, nu înainte.

Versionare și verificare

Păstrează reviziile ca să vezi cine a schimbat ce și să poți reveni. Pentru conținut reglementat (politici de resurse umane, proceduri de siguranță), adaugă un pas de aprobare înainte de publicare.

Un prim prompt care funcționează

Construiește un centru de ajutor public pentru Parcelly, o aplicație de etichete de expediere pentru magazinele online mici. Pagina de start are o casetă mare de căutare și șase categorii (Primii pași, Imprimarea etichetelor, Curieri, Facturare, Retururi, Depanare). Articolele au titlu, rezumat, conținut în Markdown cu imagini și casete de atenționare, categorie, etichete, stare (ciornă, publicat, arhivat), proprietar și data ultimei verificări. Paginile de articol arată un cuprins, articole similare și întrebarea „A fost util?” cu da/nu și un comentariu opțional. Căutarea acoperă titlurile, rezumatele și conținutul, cu potrivirile din titlu pe primul loc, și înregistrează fiecare interogare și dacă a returnat rezultate. O zonă de editor (necesită autentificare, roluri editor și admin) listează ciornele, articolele neverificate de 180 de zile și articolele cu scoruri de utilitate mici, și păstrează istoricul reviziilor. Fiecare articol are propriul titlu de pagină și propria meta-descriere pentru motoarele de căutare. Design curat, calm, ușor de citit. Mobile-first.

Pași de construcție

1. Listează primele 20–30 de articole pornind de la întrebări reale ale suportului, înainte de a construi ceva. Lista aceea modelează categoriile.
2. Generează site-ul și verifică lectura pe telefon — lungimea rândurilor, titlurile, imaginile.
3. Editor și roluri. Scriitorii trebuie să poată adăuga și repara articole fără să ceară ajutorul unui dezvoltator.
4. Căutarea, apoi testeaz-o cu cuvintele pe care le folosesc clienții, inclusiv cu greșeli de scriere.
5. Feedback și jurnalizarea căutărilor.
6. Raport cu articolele învechite, pe baza proprietarului și a datei ultimei verificări.
7. Elemente de bază SEO pentru un site public: titluri unice, descrieri, URL-uri curate, un sitemap. Vezi SEO pentru site-uri construite cu AI.
8. Leagă-l din produsul tău și din răspunsurile tale de suport, apoi urmărește săptămânal jurnalul de căutări fără rezultate.
9. Răspunsuri AI, când conținutul este solid.

Greșeli frecvente

• Organizarea pe departamente în loc de organizarea după ce încearcă cititorul să facă.
• Articole lungi care acoperă cinci sarcini. O sarcină pe articol, cu un titlu care spune ce rezolvă.
• Niciun proprietar pe articol. Nimeni nu actualizează nimic, iar încrederea scade după primul răspuns greșit.
• Note interne în articolele publice. Folosește vizibilitate separată și verifică înainte de publicare.
• Căutare care potrivește doar titlurile. Cititorii scriu simptome, nu nume de articole.
• Capturi de ecran fără text alternativ sau context. Se demodează repede; descrie și pasul în cuvinte.

Când un produs gata făcut este alegerea mai bună

Dacă echipa ta lucrează deja într-un instrument de documentație sau wiki, o bază de cunoștințe internă acolo este de obicei calea cea mai simplă — comparația noastră Notion vs. Confluence acoperă două alegeri frecvente. Dacă folosești un produs de helpdesk, centrul de ajutor integrat leagă articolele de tichete și sugerează articole clienților, ceea ce este greu de reprodus. Generatoarele de site-uri de documentație sunt ideale pentru documentația pentru dezvoltatori ținută alături de cod.

Construiește-o pe cont propriu când ai nevoie de propria structură sau permisiuni (articole pe client, pe locație sau pe rol), vrei baza de cunoștințe în interiorul produsului tău, nu pe un site separat, ai nevoie de pași de revizuire și aprobare pe care un wiki nu îi impune sau vrei răspunsuri AI peste conținutul tău fără un alt abonament. Se combină firesc cu un helpdesk personalizat.

Construirea cu Mythex

Pe Mythex descrii baza de cunoștințe în chat și ea se construiește într-o previzualizare live; articolele, reviziile și feedback-ul sunt stocate într-o bază de date Postgres pe care agentul o adaugă când este nevoie, iar imaginile merg în stocarea de fișiere a proiectului. Autentificarea editorilor folosește o abordare la alegerea ta, deoarece Mythex nu are autentificare integrată pentru utilizatorii finali. Pentru răspunsurile AI, folosești cheia API a propriului furnizor de AI, stocată ca secret al proiectului, iar utilizarea se facturează contului tău la furnizor, nu în creditele Mythex (rețeta AI). Aplicațiile Mythex noi pornesc implicit ca o aplicație React randată pe client, care este mai slabă pentru motoarele de căutare; de aceea, pentru un centru de ajutor public, cere o configurație compatibilă cu site-uri statice sau randată pe server, precum Next.js (rețeta SEO).

Pentru un prompt de pornire, încearcă șabloanele bază de cunoștințe pentru produs sau aplicație de documentație pentru echipă.

Întrebări