Com crear una base de coneixement: articles, cerca, permisos i respostes amb IA

Una base de coneixement és una biblioteca cercable de respostes: com fer alguna cosa, com arreglar alguna cosa, quina és la norma. Per construir-ne una necessites articles agrupats en unes quantes categories clares, un editor que els teus redactors facin servir de debò, una cerca que trobi l'article adequat a partir de les paraules que la gent escriu realment, i una decisió sobre qui pot llegir què: el públic, els clients que han iniciat sessió o només el personal. Un creador d'apps amb IA pot produir l'estructura, l'editor i la cerca en una sessió curta. El que fa útil una base de coneixement és la redacció i el manteniment, així que cal dissenyar-la pensant en l'edició fàcil i en detectar articles desactualitzats des del primer dia.

Decideix primer per a qui és

Les mateixes funcions serveixen per a llocs molt diferents:

• Centre d'ajuda públic: per a clients i potencials clients. Ha de ser ràpid, indexable pels motors de cerca i escrit amb les seves paraules.
• Documentació només per a clients: darrere d'un inici de sessió, per a clients de pagament o socis.
• Base de coneixement interna: polítiques, processos i guies per al personal. Ha de ser privada; la cerca i l'actualitat importen més que el disseny.

Barrejar articles públics i interns en un mateix lloc és on es produeixen la majoria de filtracions. Si necessites tots dos, dona a cada article una configuració de visibilitat clara, o fes servir dos llocs separats.

Què necessita l'app

Dades

Dos camps fan molta feina: responsable (qui manté l'article precís) i data de la darrera revisió (quan algú va confirmar per últim cop que encara és cert). Junts et permeten llistar els articles que ningú no ha revisat en sis mesos.

Pàgines

• Lector: inici amb cerca i categories, pàgines de categoria, pàgines d'article amb índex, articles relacionats i una pregunta «Te n'ha estat útil?».
• Editor: llista d'articles amb filtres (esborranys, obsolets, de valoració baixa), un editor amb previsualització i historial de revisions.
• Administració: categories, usuaris i rols, i informes de cerques sense resultats.

Permisos

Els lectors veuen els articles publicats que tenen permís per veure. Els editors creen i editen articles, potser només en determinades categories. Els administradors publiquen, arxiven i gestionen els usuaris. Per a una base de coneixement interna, tothom necessita un inici de sessió; per a un centre d'ajuda públic, només ho necessiten els redactors.

Decisions i compromisos

Editor: Markdown o text enriquit

Markdown és ràpid, portable i encaixa bé amb l'historial de versions, però alguns redactors el troben poc amable. Un editor de text enriquit amb títols, llistes, imatges, avisos i blocs de codi resulta familiar. Triï el que triï, guarda el contingut en un format que puguis exportar més endavant.

Cerca

La cerca de text bàsica de la base de dades és suficient per a unes quantes centenes d'articles si cerques en títols, resums i cossos, i prioritzes les coincidències als títols. Més enllà d'això, o si els errors tipogràfics i els sinònims importen (« factura » vs « rebut »), fes servir una cerca de text complet de veritat o un servei de cerca allotjat. La nostra guia per afegir cerca repassa les opcions. Registra cada consulta que no retorni res: és una llista gratuïta d'articles que cal escriure.

Respostes amb IA

Una caixa de «fes una pregunta» que respon a partir dels teus articles és ara habitual. Funciona recuperant els fragments més rellevants i demanant a un model de llenguatge que respongui només a partir d'ells; consulta què és RAG. Mostra sempre els articles font, permet la resposta «no ho sé» i recorda que repetirà amb total seguretat tot el que estigui desactualitzat als articles. Construeix-la després que els articles estiguin en bon estat, no abans.

Versions i revisió

Guarda les revisions perquè puguis veure qui ha canviat què i tornar enrere. Per al contingut regulat (política de RRHH, procediments de seguretat), afegeix un pas d'aprovació abans que un canvi es publiqui.

Un primer prompt que funciona

Construeix un centre d'ajuda públic per a Parcelly, una app d'etiquetes d'enviament per a petites botigues en línia. Pàgina d'inici amb un quadre de cerca gran i sis categories (Primers passos, Imprimir etiquetes, Transportistes, Facturació, Devolucions, Resolució de problemes). Els articles tenen un títol, un resum, un cos en Markdown amb imatges i avisos, categoria, etiquetes, estat (esborrany, publicat, arxivat), responsable i data de la darrera revisió. Les pàgines d'article mostren un índex, articles relacionats i un «Te n'ha estat útil?» de sí/no amb un comentari opcional. La cerca cobreix títols, resums i cossos, amb les coincidències als títols en primer lloc, i registra cada consulta i si ha retornat resultats. Una àrea d'editor (cal iniciar sessió, rols editor i administrador) llista els esborranys, els articles no revisats en 180 dies i els articles amb puntuacions d'utilitat baixes, i guarda l'historial de revisions. Cada article té el seu propi títol de pàgina i meta descripció per als motors de cerca. Disseny net, tranquil i llegible. Primer mòbil.

Passos de construcció

1. Llista els primers 20–30 articles a partir de preguntes reals de suport abans de construir res. Aquesta llista dona forma a les categories.
2. Genera el lloc i revisa la lectura en un mòbil: longitud de línia, títols, imatges.
3. Editor i rols. Els redactors han de poder afegir i corregir articles sense demanar-ho a un desenvolupador.
4. Cerca, i després prova-la amb les paraules que fan servir realment els clients, incloent-hi les faltes d'ortografia.
5. Opinions i registre de cerques.
6. Informe d'articles obsolets basat en el responsable i la data de la darrera revisió.
7. Bases de SEO per a un lloc públic: títols i descripcions únics, URL netes, un sitemap. Consulta SEO per a webs creades amb IA.
8. Enllaça-la des del teu producte i des de les respostes de suport, i revisa cada setmana el registre de cerques sense resultats.
9. Respostes amb IA, quan el contingut ja sigui sòlid.

Errors habituals

• Organitzar per departament en lloc de fer-ho segons el que el lector vol fer.
• Articles llargs que cobreixen cinc tasques. Una tasca per article, amb un títol que digui quin problema resol.
• Cap responsable per article. Ningú no actualitza res, i la confiança cau després de la primera resposta errònia.
• Notes internes en articles públics. Fes servir visibilitat separada i revisa abans de publicar.
• Una cerca que només coincideix amb els títols. Els lectors escriuen símptomes, no noms d'articles.
• Captures de pantalla sense text alternatiu ni context. Envelleixen ràpidament; descriu també el pas amb paraules.

Quan és millor un producte ja fet

Si el teu equip ja treballa en una eina de documentació o wiki, una base de coneixement interna allà sol ser el camí de menys resistència; el nostre comparatiu Notion vs Confluence cobreix dues opcions habituals. Si fas servir un producte de helpdesk, el seu centre d'ajuda integrat enllaça els articles amb els tiquets i suggereix articles als clients, cosa difícil de reproduir. Els generadors de llocs de documentació són ideals per a la documentació de desenvolupadors que es guarda al costat del codi.

Construeix-ne una de pròpia quan necessitis una estructura o permisos propis (articles per client, per ubicació o per rol), vulguis la base de coneixement dins del teu producte en lloc d'un lloc separat, necessitis passos de revisió i aprovació que una wiki no imposa, o vulguis respostes amb IA sobre el teu contingut sense una altra subscripció. Encaixa de manera natural amb un helpdesk propi.

Construir-ho amb Mythex

A Mythex descrius la base de coneixement en el xat i es construeix en una previsualització en directe; els articles, les revisions i les opinions s'emmagatzemen en una base de dades Postgres que l'agent afegeix quan cal, i les imatges van a l'emmagatzematge de fitxers del projecte. Els inicis de sessió dels editors fan servir un enfocament d'autenticació que tries tu, ja que Mythex no té un inici de sessió integrat per a usuaris finals. Per a les respostes amb IA, fas servir la teva pròpia clau d'API del proveïdor d'IA, guardada com a secret del projecte, i l'ús es factura al teu compte del proveïdor i no als crèdits de Mythex (recepta d'IA). Les noves apps de Mythex fan servir per defecte una app React d'una sola pàgina renderitzada al client, que és menys bona per als motors de cerca; per a un centre d'ajuda públic, demana una configuració compatible amb estàtics o renderitzada al servidor, com Next.js (recepta de SEO).

Per a un prompt inicial, prova les plantilles base de coneixement del producte o aplicació de documentació d'equip.

Preguntes