> ## 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é escribir en la base de conocimiento

> Qué conocimiento es útil para las personas y los agentes, qué conviene dejar fuera y cómo redactar páginas que se encuentren y se apliquen bien.

Una base de conocimiento es útil cuando contiene lo que no se puede saber de otro modo. Esta página resume qué conviene documentar, qué es mejor dejar fuera y cómo interpretan los agentes lo que escribes.

## Qué documentar

Documenta lo que un modelo de IA, o una persona recién llegada, no puede saber de tu organización:

| Tipo de conocimiento | Ejemplos |
| - | - |
| Cómo está montado el entorno | Qué cliente de VPN se usa y desde dónde se instala, qué redes Wi-Fi hay, cómo se llaman los grupos de licencias. |
| Normas locales | "No borres nunca el OST de los buzones compartidos", "pregunta antes de tocar el portátil de un directivo". |
| Responsables y escalado | Quién es responsable de cada sistema, a quién se escala y en qué horario. |
| Particularidades conocidas | La impresora de una oficina que solo funciona con un controlador concreto, una aplicación que necesita permisos especiales. |
| Soluciones propias de tu organización | El arreglo para vuestro cliente de VPN, vuestro proxy o vuestras GPO. |

## Qué dejar fuera

* **Resolución de problemas genérica.** Vaciar la caché de DNS o el significado general de un código de error ya lo conoce cualquier modelo. Las páginas que lo repiten dificultan encontrar lo que sí es propio de tu organización.
* **Lo que está pasando ahora mismo.** Una incidencia en curso, como "desde la actualización de octubre Outlook se cuelga en once portátiles de Madrid", no es una página: queda desactualizada en horas. Los agentes obtienen el estado actual de los dispositivos a partir de los datos en vivo de la plataforma.
* **Contraseñas, claves y otros secretos.** Guárdalos en la [Bóveda](https://docs.flexxible.com/features/flexxible-kb/vault.md) y enlázalos desde la página.

> [!WARNING]
>
> No escribas contraseñas ni claves en el texto de una página. El editor avisa cuando lo que pegas parece un secreto y ofrece guardarlo en la Bóveda.

## Cómo interpretan los agentes una página

Los agentes de Flexxible Assist leen la base de conocimiento como un conjunto de hechos y normas, no como un guion que ejecutar a ciegas:

* **Las normas son vinculantes.** Si una página dice que algo no debe hacerse, el agente lo respeta aunque su propio diagnóstico apunte en otra dirección.
* **Las soluciones son indicaciones.** El agente las contrasta con lo que observa en el dispositivo. Si la solución no encaja con lo que ve, sigue lo que ve e informa de que la página no era correcta.
* **Lo que falta se notifica.** Cuando la base de conocimiento no tiene lo que necesitaban, o lo tiene mal, los agentes lo notifican en [Falta en la KB](https://docs.flexxible.com/features/flexxible-kb/gaps.md). No crean ni reescriben páginas por su cuenta.

Por eso conviene distinguir en el texto lo que es una norma ("nunca", "siempre", "antes de…") de lo que es un procedimiento que funcionó.

## Cómo redactar una página útil

| Práctica | Por qué ayuda |
| - | - |
| Un tema por página | La búsqueda devuelve la página y la sección que responden. Una página que mezcla temas responde peor a todos. |
| Títulos y encabezados descriptivos | Las personas y los agentes llegan directamente a la sección que necesitan. |
| Síntomas tal como los describiría un usuario | Facilita relacionar la página con la incidencia real, también en otros idiomas. |
| Nombres y versiones exactos | "GlobalProtect 6.3.1 desde Company Portal" se puede comprobar; "el cliente de VPN" no. |
| Pasos numerados y resultado esperado | Permite comprobar si el procedimiento ha funcionado. |
| Cuándo escalar y a quién | Indica en qué punto debe intervenir una persona. |
| Páginas dentro de páginas | Una oficina con sus impresoras dentro, o un sistema con sus procedimientos, deja claro a qué se aplica cada página. |

Cada página muestra bajo el título un resumen de una o dos frases, **En resumen**, que Teammate escribe a partir del contenido y actualiza tras cada cambio. Las personas y los agentes lo reciben también en los resultados de búsqueda. Si el resumen no refleja lo importante, mejora la página: el resumen se corrige solo.

## Mantener la base de conocimiento al día

* **Corrige en el momento.** Cuando un procedimiento cambie, edita la página o díselo a [Teammate](https://docs.flexxible.com/features/flexxible-kb/teammate.md): "El cliente de VPN ahora es GlobalProtect 6.4.0".
* **Revisa Falta en la KB.** Reúne lo que los agentes necesitaron y no encontraron, ordenado por peso.
* **Consulta el uso de cada página.** Cada página muestra cuánto la han usado personas y agentes en los últimos 30 días y cuántas de las sesiones que la usaron se resolvieron sin escalar. Consulta [Uso de una página](https://docs.flexxible.com/features/flexxible-kb/pages.md#uso-de-una-página).
* **Elimina lo que ya no se aplica.** Una página obsoleta que convive con otra más reciente genera instrucciones contradictorias. Una página eliminada se puede restaurar.

Si tu organización necesita dejar constancia de qué versión de una página se ha comprobado, puede activar la [validación de páginas](https://docs.flexxible.com/features/flexxible-kb/validation.md). Para saber qué páginas no están sirviendo a quienes las leen, puede activar las [valoraciones](https://docs.flexxible.com/features/flexxible-kb/ratings-reactions.md).

## Siguientes pasos

* [Escribir y editar páginas](https://docs.flexxible.com/features/flexxible-kb/editor.md)
* [Falta en la KB](https://docs.flexxible.com/features/flexxible-kb/gaps.md)
* [Agentes de Flexxible Assist](https://docs.flexxible.com/features/flexxible-kb/assist-agents.md)
