Base de conocimiento

La Base de Conocimiento son los documentos que el agente consulta para responder con hechos: precios, políticas, horarios, preguntas frecuentes, descripciones de servicios. Es la fuente de verdad del agente sobre tu negocio. Se encuentra en Base de Conocimiento (Manager y Admin).

Si no sabes si algo va aquí o en otro lado, lee Qué fuente usar para cada cosa.

Subir un documento#

1. En Base de Conocimiento, pulsa Subir documentos (o Agregar documento).
2. Elige tu archivo. Formatos con lectura de texto: PDF, TXT, Markdown (MD), CSV y Excel (XLSX/XLS). Si tu documento está en Word (DOCX), guárdalo como PDF antes de subirlo.
3. Orkestal lo guarda y lo procesa en segundo plano: lee el texto, lo divide en fragmentos, los convierte en vectores (embeddings) y los indexa para poder buscarlos por significado.
4. Cuando el estado sea Activo, el agente ya puede usarlo.

Estados de un documento#

Límites#

• Tu plan limita cuántos documentos puedes tener. El límite de archivos de contexto del plan se cuenta con los documentos de tu base de conocimiento (el plan Starter incluye 2). Mira Planes y facturación.
• Un documento se divide en fragmentos de unos 1,200 caracteres y se indexan hasta 500 fragmentos por documento. Si tu archivo es muy grande, divídelo en varios por tema.

Cómo decide el agente cuándo consultar un documento#

Esta es la parte que más se pasa por alto. Cada documento tiene un enrutador inteligente:

• Regla de enrutamiento: una descripción, en tus palabras, de cuándo debe consultarse ese documento. Ejemplo: «Usar para preguntas sobre precios, planes, renovaciones y políticas de cancelación».
• Base principal: un documento marcado como «Incluir siempre como base principal» se entrega al agente en todas las consultas, y entonces la regla ya no hace falta.

Sin regla ni marca de base principal, el agente puede omitir ese documento aunque contenga la respuesta. Para configurarlo, abre el documento y pulsa Configurar router ahora (o Editar regla del router).

Ver y editar un documento#

Al abrir un documento verás tres pestañas:

• Resumen: su descripción para el router, cuántos fragmentos tiene, su tamaño, su tipo y el estado.
• Contenido: el texto (si el formato lo permite) y el botón Editar contenido. Al guardar, Orkestal muestra «Documento actualizado. Reindexando en segundo plano.»
• Actividad: cuándo se agregó, cuándo se actualizó y su estado de indexación.

También puedes Ver archivo original, y eliminar el documento: se borra de la base de datos y del almacenamiento, y no se puede deshacer.

Las otras pestañas#

El encabezado de la pantalla muestra además cuántas fuentes están indexadas y la última sincronización; Ver historial lista los documentos agregados y actualizados.

Cómo escribir buenos documentos#

1. Un tema por documento. «Envíos y devoluciones» es mejor que «Todo sobre el negocio».
2. Escribe como contestarías. Frases completas con el dato incluido. En lugar de «Envío: 99», escribe «El envío estándar cuesta $99 MXN y tarda de 2 a 4 días hábiles».
3. Incluye variantes de la pregunta. Si la gente dice «factura» y «CFDI», usa ambas palabras.
4. Pon fechas de vigencia en promociones y precios que cambian.
5. Estructura con títulos y listas cortas; evita tablas gigantes.
6. Un dato, un lugar. No repitas precios de productos que ya viven en el inventario.
7. No metas el guion de la conversación («primero pregunta X, luego Y»): eso va en el funnel.
8. No incluyas datos que no deba repetir el agente: contraseñas, datos de clientes o información interna. El agente puede citar cualquier cosa que esté en un documento.

Mantenerlo al día#

• Revisa Brechas de Conocimiento a diario las primeras semanas y después cada semana.
• Cuando cambien precios o políticas, edita el documento; no subas uno nuevo sin quitar el viejo.
• Elimina los documentos de servicios que ya no ofreces.
• Después de cambios grandes, prueba en el simulador.

Problemas comunes#