Aprende a redactar tu base de conocimiento para que un agente de IA responda bien por WhatsApp, Instagram o chat web: estructura, palabras y pruebas.
Tu agente de IA no falla por falta de inteligencia, sino porque la respuesta correcta está escondida en un párrafo largo, con un título vago y sin las palabras que usa tu cliente. Cuando alguien escribe por WhatsApp "¿puedo devolver unos zapatos que ya usé?", el agente necesita encontrar el fragmento exacto que lo explica. En esta guía verás cómo redactar tu base de conocimiento para que ese fragmento aparezca, se entienda y produzca una respuesta fiable.
Cómo encuentra tu contenido un agente de IA
Un agente que responde con tu información no se la sabe de memoria. Ante cada pregunta busca en tus fuentes los pasajes que mejor encajan con lo que pide el cliente y redacta la respuesta a partir de ellos. Si el pasaje correcto no aparece, el agente improvisa, responde de forma genérica o dice que no lo sabe.
Esto cambia la forma de escribir. Un manual interno se redacta para que lo lea una persona de principio a fin. Un contenido para IA se redacta para que cualquier trozo, sacado de su contexto, tenga sentido por sí solo. Es lo mismo que haces cuando escribes una buena ficha de preguntas frecuentes.
Tres ideas guían el resto de la guía:
- Cada pasaje debe poder leerse solo. Si para entenderlo hay que haber leído el apartado anterior, se perderá.
- El pasaje debe parecerse a la pregunta. Cuanto más se acerquen tu título y tus palabras a las del cliente, más fácil será encontrarlo.
- Los datos deben estar escritos, no sobreentendidos. El agente no puede adivinar a qué plazo, moneda o sucursal te refieres.
Un tema por sección, con el nombre que usaría tu cliente
El error más común es el documento largo titulado "Políticas de la empresa" que mezcla envíos, devoluciones, garantías y facturación. Para una persona es una página; para un buscador es una mezcla donde ninguna respuesta destaca.
Divide en secciones de un solo tema y titúlalas como lo preguntaría un cliente:
- En lugar de "Política de logística": "¿Cuánto tarda en llegar mi pedido?"
- En lugar de "Condiciones de cancelación": "¿Puedo cancelar mi reserva y que me devuelvan el dinero?"
- En lugar de "Facturación electrónica": "¿Cómo pido mi factura?"
Si una sección responde dos preguntas distintas, sepárala en dos. Si dos secciones responden lo mismo, fúndelas, porque contenidos duplicados con versiones distintas generan respuestas contradictorias.
Primero la respuesta, después las condiciones
Los clientes preguntan con una intención clara: "¿puedo?", "¿cuánto?", "¿cuándo?". Empieza cada sección con la respuesta directa en una frase y deja las excepciones para después. Así, aunque el agente use solo el comienzo del pasaje, la respuesta ya es correcta, y las condiciones llegan a continuación.
Fíjate en la misma política escrita de dos maneras:
El plazo de 15 días es un ejemplo inventado para ilustrar el formato; usa siempre el de tu negocio. Lo importante es la estructura: respuesta, condiciones, pasos.
Usa las palabras del cliente y añade sinónimos
Tu equipo habla de "RMA", "reembolso" o "nota de crédito". Tu cliente dice "devolver", "me devuelvan la plata", "cambiar por otra talla". Si tu contenido solo usa la palabra interna, la pregunta del cliente no se parecerá a nada.
Hay además diferencias regionales que importan si atiendes a España y Latinoamérica:
- móvil, celular y teléfono
- coche, carro y auto
- ordenador, computadora y PC
- factura, boleta y comprobante
- plata, dinero y efectivo
No necesitas llenar el texto de listas de palabras. Basta con incluirlas de forma natural en una frase: "Si quieres devolver tu pedido (o cambiarlo por otra talla), escríbenos por WhatsApp". También conviene recoger las formas coloquiales y las abreviaturas que ya usan tus clientes, como "x fa", "q horario tienen" o el nombre informal de un producto.
Cuando una sigla sea inevitable, explícala la primera vez: "CFDI (la factura electrónica)" o "IVA (impuesto sobre el valor añadido)". Así encaja tanto con quien pregunta por la sigla como con quien pregunta por la descripción.
Haz explícitos los datos: fechas, unidades, nombres y límites
Un agente no puede deducir lo que tú das por sabido. Revisa cada sección buscando estas lagunas:
- Fechas: en lugar de "hasta fin de mes", escribe "hasta el 30 de noviembre de 2026". Si el contenido caduca, indica cuándo se revisó.
- Unidades y moneda: "50 euros" o "1.200 pesos mexicanos", no "50" a secas. Si vendes en varios países, nombra la moneda en cada precio.
- Nombres completos: "plan Pro", "sucursal de Polanco", "turno de tarde". Evita "el plan anterior" o "la otra tienda".
- Límites y excepciones: peso máximo, zonas de reparto, horarios, cantidades mínimas, qué queda fuera.
- Horarios con zona horaria: "de lunes a viernes de 9:00 a 18:00, hora de Ciudad de México" evita malentendidos cuando escribe alguien desde Madrid o Bogotá.
Un ejemplo hipotético: "Hacemos envíos a toda la región" no sirve. "Enviamos a la península y a Baleares; no enviamos a Canarias, Ceuta ni Melilla" sí. La segunda frase permite una respuesta correcta y evita una promesa que no puedes cumplir.
Evita también las referencias que dependen de la posición: "como se indica arriba", "ver la tabla anterior". Fuera de su contexto, esas frases no significan nada.
Da formato para que se pueda escanear
Un buen formato ayuda a las personas que revisan el contenido y a dividirlo en pasajes coherentes:
- Bloques cortos. Párrafos de dos a cuatro frases, sin muros de texto.
- Listas para condiciones, requisitos y excepciones.
- Pasos numerados para procedimientos, con una acción por paso.
- Tablas para comparar planes, tarifas o zonas, con encabezados claros.
- Un título descriptivo por sección, que se entienda sin el resto del documento.
Una tabla de envíos, por ejemplo, puede tener las columnas "Zona", "Plazo de entrega" y "Coste", con una fila por zona. Es más fácil de mantener y de consultar que un párrafo con seis cifras mezcladas.
Evita el contenido que solo existe como imagen: una captura de una lista de precios o un cartel de horarios en PDF escaneado. Si el texto no se puede leer como texto, el agente no lo aprovechará. Transcríbelo.
Prueba con preguntas reales y corrige lo que falla
Escribir bien es la mitad del trabajo; la otra mitad es comprobar que funciona. Reúne entre 20 y 30 preguntas reales de tus clientes, incluidas las mal escritas y las ambiguas, y pásalas al agente antes de publicar y cada vez que cambies contenido importante.
- 01Reunir preguntas reales
- 02Probar con el agente
- 03Corregir título, texto o datos
- 04Volver a probar y publicar
Cuando una respuesta falla, diagnostica antes de reescribir:
- No encontró nada. Probablemente el título o las palabras no se parecen a la pregunta. Añade la formulación del cliente y los sinónimos.
- Encontró el pasaje equivocado. Hay dos secciones que compiten. Sepáralas por tema o elimina la duplicada.
- Encontró el pasaje correcto, pero respondió mal. Falta un dato explícito, o la respuesta está enterrada tras las condiciones. Pon la respuesta primero.
- Respondió con información vieja. Hay contenido desactualizado o dos versiones de la misma política. Deja una sola.
Repite el ciclo cada vez que cambien precios, horarios o condiciones, y revisa de forma periódica las preguntas que los clientes hacen y que tu contenido no cubre.
Cómo hacerlo en AI SNS CHAT
En AI SNS CHAT puedes aplicar este ciclo con las herramientas del panel, sin salir de él.
Carga y organiza tu contenido. En el menú lateral, Data sources reúne las fuentes: Files, Text snippets, Website, Q&A, Notion, Social, Tickets y Suggestions. Para las respuestas cortas y exactas (horarios, plazos, políticas), el formato Q&A encaja bien con la regla de "una pregunta, una respuesta": escribe la pregunta con las palabras del cliente y la respuesta en la primera frase. Para documentos más extensos puedes usar Files o Text snippets, y si ya tienes un centro de ayuda, puedes conectarlo desde Channels con conectores como Confluence, GitBook, Zendesk Guide, Google Drive o Notion. Consulta la lista en /connections. En los conectores de wiki hay un límite por sincronización de 1,5 millones de caracteres y 400 páginas, y si se trunca el contenido, el sistema te lo avisa.
Prueba antes de publicar. Usa Playground para lanzar tus preguntas reales al agente y ver qué responde. Si quieres comparar cómo se comportan dos modelos con el mismo contenido, existe la comparación A/B en Playground.
Aprende de las conversaciones reales. En Activity → Chat logs (y en Inbox, que es solo para correo electrónico) puedes revisar las conversaciones de WhatsApp, Instagram, chat web y otros canales. Si una respuesta no fue buena, puedes tomar el control de la conversación y editar la respuesta para convertirla en la respuesta ideal con la que se entrena al agente. Los votos de pulgar arriba y abajo y los filtros te ayudan a localizar rápido los casos que fallan. En Analytics tienes Topics y Question history para detectar qué preguntan más tus clientes; las analíticas avanzadas requieren el plan Pro.
Cuando no hay respuesta. Si prefieres que el agente no invente, define sus límites en la persona y las guardrails del agente. Para los casos que requieren una persona, Helpdesk → Scheduling permite configurar turnos para que las derivaciones se asignen a quien está de guardia (Helpdesk requiere el plan Standard o superior).
Control de cambios. El registro de actividad del espacio de trabajo (Workspace settings → Activity) muestra quién creó, editó o subió cada elemento, y cada fuente indica quién la añadió y quién la modificó por última vez. Es útil cuando varias personas mantienen la base de conocimiento. Puedes ver los planes y límites de almacenamiento en /pricing y el resto de funciones en /features.
Preguntas frecuentes
¿Qué extensión debe tener cada artículo o sección de la base de conocimiento?
No hay una cifra mágica. La regla práctica es que cada sección responda una sola pregunta y se entienda sin el resto del documento, lo que suele traducirse en bloques de pocos párrafos. Si una sección necesita tres subtítulos para explicarse, probablemente son tres secciones.
¿Debo escribir el mismo contenido en varios idiomas?
Depende de en qué idioma te escriben tus clientes. Si recibes consultas en español de España y de Latinoamérica, un único texto en español con sinónimos regionales suele bastar. Si atiendes de verdad en otros idiomas, comprueba con preguntas reales en cada uno que el agente encuentre la respuesta, y añade contenido solo donde falle.
¿Y si el agente sigue respondiendo mal después de reescribir el contenido?
Diagnostica primero: comprueba si no encuentra el pasaje, si encuentra el equivocado o si falta un dato. Busca después contenido duplicado o contradictorio y revisa la persona y las guardrails del agente. Las correcciones puntuales se hacen editando la respuesta desde Chat logs, y puedes volver a probar en Playground.
¿Puede el agente responder con información de la web si mi base de conocimiento no tiene la respuesta?
Depende del canal. La búsqueda web automática cuando la base no tiene respuesta existe solo en LINE WORKS, donde cita la página que usó. En el resto de canales, la Action Tavily da búsqueda web en tiempo real a cualquier agente, pero las integraciones requieren el plan Hobby o superior. En general, lo más fiable es que lo importante esté en tu propia base de conocimiento.


