> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexxible.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Què escriure a la base de coneixement

> Quin coneixement és útil per a les persones i els agents, què convé deixar fora i com redactar pàgines que es trobin i s'apliquin bé.

Una base de coneixement és útil quan conté el que no es pot saber d'una altra manera. Aquesta pàgina resumeix què convé documentar, què és millor deixar fora i com interpreten els agents el que escrius.

## Què documentar

Documenta el que un model d'IA, o una persona nouvinguda, no pot saber de la teva organització:

| Tipus de coneixement | Exemples |
| - | - |
| Com està muntat l'entorn | Quin client de VPN s'utilitza i des d'on s'instal·la, quines xarxes Wi-Fi hi ha, com es diuen els grups de llicències. |
| Normes locals | "No esborris mai l'OST de les bústies compartides", "pregunta abans de tocar el portàtil d'un directiu". |
| Responsables i escalat | Qui és responsable de cada sistema, a qui s'escala i en quin horari. |
| Particularitats conegudes | La impressora d'una oficina que només funciona amb un controlador concret, una aplicació que necessita permisos especials. |
| Solucions pròpies de la teva organització | La solució per al vostre client de VPN, el vostre proxy o les vostres GPO. |

## Què deixar fora

* **Resolució de problemes genèrica.** Buidar la memòria cau de DNS o el significat general d'un codi d'error ja ho coneix qualsevol model. Les pàgines que ho repeteixen dificulten trobar el que sí que és propi de la teva organització.
* **El que està passant ara mateix.** Una incidència en curs, com ara "des de l'actualització d'octubre l'Outlook es penja en onze portàtils de Madrid", no és una pàgina: queda desactualitzada en hores. Els agents obtenen l'estat actual dels dispositius a partir de les dades en directe de la plataforma.
* **Contrasenyes, claus i altres secrets.** Desa'ls a la [Caixa forta](https://docs.flexxible.com/ca/features/flexxible-kb/vault.md) i enllaça'ls des de la pàgina.

> [!WARNING]
>
> No escriguis contrasenyes ni claus al text d'una pàgina. L'editor avisa quan el que enganxes sembla un secret i ofereix desar-lo a la Caixa forta.

## Com interpreten els agents una pàgina

Els agents de Flexxible Assist llegeixen la base de coneixement com un conjunt de fets i normes, no com un guió per executar a cegues:

* **Les normes són vinculants.** Si una pàgina diu que una cosa no s'ha de fer, l'agent ho respecta encara que el seu propi diagnòstic apunti en una altra direcció.
* **Les solucions són indicacions.** L'agent les contrasta amb el que observa al dispositiu. Si la solució no encaixa amb el que veu, segueix el que veu i informa que la pàgina no era correcta.
* **El que falta es notifica.** Quan la base de coneixement no té el que necessitaven, o ho té malament, els agents ho notifiquen a [Falta a la KB](https://docs.flexxible.com/ca/features/flexxible-kb/gaps.md). No creen ni reescriuen pàgines pel seu compte.

Per això convé distingir al text el que és una norma ("mai", "sempre", "abans de…") del que és un procediment que va funcionar.

## Com redactar una pàgina útil

| Pràctica | Per què ajuda |
| - | - |
| Un tema per pàgina | La cerca retorna la pàgina i la secció que responen. Una pàgina que barreja temes respon pitjor a tots. |
| Títols i encapçalaments descriptius | Les persones i els agents arriben directament a la secció que necessiten. |
| Símptomes tal com els descriuria un usuari | Facilita relacionar la pàgina amb la incidència real, també en altres idiomes. |
| Noms i versions exactes | "GlobalProtect 6.3.1 des de Company Portal" es pot comprovar; "el client de VPN", no. |
| Passos numerats i resultat esperat | Permet comprovar si el procediment ha funcionat. |
| Quan escalar i a qui | Indica en quin punt ha d'intervenir una persona. |
| Pàgines dins de pàgines | Una oficina amb les seves impressores a dins, o un sistema amb els seus procediments, deixa clar a què s'aplica cada pàgina. |

Cada pàgina mostra sota el títol un resum d'una o dues frases, **En resum**, que Teammate escriu a partir del contingut i actualitza després de cada canvi. Les persones i els agents també el reben als resultats de cerca. Si el resum no reflecteix el que és important, millora la pàgina: el resum es corregeix sol.

## Mantenir la base de coneixement al dia

* **Corregeix en el moment.** Quan un procediment canviï, edita la pàgina o digues-ho a [Teammate](https://docs.flexxible.com/ca/features/flexxible-kb/teammate.md): "El client de VPN ara és GlobalProtect 6.4.0".
* **Revisa Falta a la KB.** Reuneix el que els agents van necessitar i no van trobar, ordenat per pes.
* **Consulta l'ús de cada pàgina.** Cada pàgina mostra quant l'han utilitzada persones i agents els últims 30 dies i quantes de les sessions que la van utilitzar es van resoldre sense escalar. Consulta [Ús d'una pàgina](https://docs.flexxible.com/ca/features/flexxible-kb/pages.md#uso-de-una-página).
* **Elimina el que ja no s'aplica.** Una pàgina obsoleta que conviu amb una altra de més recent genera instruccions contradictòries. Una pàgina eliminada es pot restaurar.

Si la teva organització necessita deixar constància de quina versió d'una pàgina s'ha comprovat, pot activar la [validació de pàgines](https://docs.flexxible.com/ca/features/flexxible-kb/validation.md). Per saber quines pàgines no són útils per a qui les llegeix, pot activar les [valoracions](https://docs.flexxible.com/ca/features/flexxible-kb/ratings-reactions.md).

## Passos següents

* [Escriure i editar pàgines](https://docs.flexxible.com/ca/features/flexxible-kb/editor.md)
* [Falta a la KB](https://docs.flexxible.com/ca/features/flexxible-kb/gaps.md)
* [Agents de Flexxible Assist](https://docs.flexxible.com/ca/features/flexxible-kb/assist-agents.md)
