He aquí un escenario que se repite con demasiada frecuencia: un equipo migra a Freshdesk, activa Freddy AI el primer día e inmediatamente nota que el bot da respuestas incorrectas, carece de contexto o se equivoca al recordar detalles de políticas que cambiaron hace seis meses. Se culpa a la plataforma. Se desactiva Freddy. El equipo vuelve al soporte manual.
La plataforma no es el problema. La base de conocimientos sí lo es.
El agente de IA de Freshdesk, Freddy partirá con una desventaja de la que quizás nunca se recupere. Freshdesk aprende directamente de los artículos de tu solución, las preguntas y respuestas personalizadas, los archivos subidos y las URL. Su precisión depende directamente de la calidad, la estructura y la actualidad de ese contenido. Si migras una base de conocimientos mal estructurada, desactualizada o con traducciones incompletas a Esta guía está dirigida a equipos que migran a Freshdesk —ya sea desde Zendesk, Intercom, ServiceNowu otra plataforma— y que desean que la IA de Freddy proporcione respuestas precisas desde el primer día de funcionamiento. Obtendrás el proceso de migración paso a paso, la lista de verificación de limpieza previa a la migración, las reglas de estructura de artículos en las que se basa Freddy y el marco de validación posterior a la migración para confirmar la precisión antes de la puesta en marcha.
1. Por qué la precisión de la IA de Freddy depende de tu base de conocimientos
La IA de Freshdesk, llamada Freddy, funciona a través de AI Agent Studio. Al crear un agente de IA, lo conectas a fuentes de conocimiento: artículos de soluciones, archivos subidos, URL públicas y pares de preguntas y respuestas personalizadas. El agente de IA aprende de estas fuentes para generar respuestas a las consultas de los clientes.
Aquí no hay caja negra. Freddy no lee tu historial de tickets, tus conversaciones de correo electrónico ni tus documentos internos a menos que se los indiques explícitamente. La calidad de su respuesta depende completamente de lo que le proporciones. Esto tiene una implicación crucial para los equipos que migran a Freshdesk:
Los equipos que habilitan a Freddy antes de completar la limpieza de la base de conocimientos suelen ver dos modos de fallo: (1) respuestas ilusorias: Freddy hace referencia con seguridad a políticas o procedimientos que ya no existen en su base de conocimientos actualizada, porque la versión anterior se migró, y (2) evasión sin confianza: Freddy dice "No tengo información sobre eso" para preguntas que su base de conocimientos realmente cubre, porque los títulos de los artículos no coinciden con el lenguaje natural que usan los clientes.
Lo que Freddy realmente lee de tu base de conocimientos
Freddy's AI Agent Studio admite cuatro tipos de fuentes de conocimiento:
- Artículos de soluciones: su fuente principal. Freddy lee el título, el contenido y las etiquetas adjuntas. La estructura y la jerarquía de los encabezados influyen directamente en cómo Freddy interpreta los límites temáticos.
- Preguntas y respuestas personalizadas: pares explícitos de preguntas y respuestas que usted define. Esta es la fuente de mayor confianza: Freddy las trata como anulaciones autorizadas.
- Archivos: PDF, documentos de Word. Útiles para documentos de políticas y especificaciones técnicas, pero menos estructurados que los artículos.
- URL: páginas web públicas. Útiles para la documentación de productos alojada fuera de Freshdesk.
En una base de conocimientos migrada, los artículos de soluciones son la fuente principal. La calidad de los artículos, la estructura de categorías y la cobertura lingüística que se migren determinan directamente qué respuestas precisas puede o no responder Freddy.
2. La migración de la base de conocimientos preparada para la IA: paso a paso
Migrar una base de conocimientos a Freshdesk es un proceso de seis pasos. Los pasos 1 al 4 se realizan antes de ejecutar la migración. Los pasos 5 y 6 se realizan después.
Esta sección trata específicamente sobre la migración de la base de conocimientos: artículos, categorías, carpetas y versiones de idioma. No incluye la migración de tickets, contactos ni la configuración de agentes. Si realiza una migración completa o exprés junto con la migración de su base de conocimientos, siga la secuencia indicada en la Guía de migración completa o la Guía de migración exprés. La base de conocimientos debe migrarse antes que los tickets y antes de que se active Freddy AI.
Paso 1: audita tu base de conocimientos existente
Antes de migrar nada, genere un inventario completo de su base de conocimientos actual. Necesita saber:
- Número total de artículos por estado (publicado, borrador, archivado)
- Estructura de categorías y carpetas: cuántos niveles de profundidad
- Versiones lingüísticas: qué artículos existen en qué idiomas
- Fechas de última modificación: cuántos artículos no se han actualizado en más de 12 meses
- Datos de rendimiento del artículo: visualizaciones, valoraciones de utilidad y CSAT (cuando estén disponibles)
Este inventario se convierte en tu lista de tareas pendientes antes de la migración. Cada artículo que no se haya actualizado en 12 meses es candidato a revisión antes de la migración. Cada artículo con una baja calificación de utilidad es candidato a ser reescrito o eliminado. Cada artículo que exista en inglés pero no en otros idiomas compatibles representa una brecha que debes subsanar antes de que Freddy pueda atender correctamente a los clientes que no hablan inglés.
Paso 2: Limpia antes de migrar
Este es el paso que la mayoría de los equipos omiten y el que causa la mayoría de los problemas de precisión de la IA después de la migración. La limpieza de la base de conocimientos antes de la migración consta de tres componentes:
2a. Eliminar artículos obsoletos y de baja calidad
Cualquier artículo que ya no refleje su producto, políticas o procedimientos actuales debe eliminarse o actualizarse antes de la migración. Migrar artículos obsoletos a Freshdesk implica que Freddy aprenda de información incorrecta. La solución posterior a la migración es costosa: debe identificar de qué artículos se nutre Freddy, actualizarlos o eliminarlos y esperar a que Freddy vuelva a aprender. Corregir esto antes de la migración lleva solo unos minutos por artículo.
2b. Estandarizar los títulos de los artículos para la coincidencia de intenciones de la IA
Freddy relaciona las consultas de los clientes con los artículos, en parte, mediante el análisis de los títulos. Los títulos de los artículos que utilizan jerga interna en lugar del lenguaje del cliente (por ejemplo, «Preguntas frecuentes sobre la migración de niveles de suscripción» en lugar de «¿Cómo cambio mi plan?») hacen que Freddy no encuentre coincidencias con las consultas en lenguaje natural. Modifique los títulos para que se ajusten a la forma en que los clientes formulan sus preguntas, no a cómo su equipo describe las funciones.
2c. Consolidar artículos duplicados y superpuestos
Varios artículos que tratan el mismo tema con enfoques ligeramente diferentes dificultan la clasificación de intenciones de Freddy. Combínalos en un único artículo principal con un título claro, encabezados estructurados y un primer párrafo que responda directamente a la pregunta planteada. Freddy funciona mejor con artículos específicos, actuales y completos.
Paso 3: Planifica la estructura de categorías y carpetas para Freddy
Freshdesk organiza el contenido de la base de conocimientos en tres niveles: categorías, carpetas y artículos. Freddy utiliza esta jerarquía para comprender el alcance de los temas. Una jerarquía bien diseñada mejora la capacidad de Freddy para ofrecer respuestas contextualmente relevantes. Una jerarquía plana o demasiado compleja la perjudica.
La estructura recomendada para la precisión de la IA:
- Categorías: áreas temáticas amplias que coinciden con los principales casos de uso de su producto (por ejemplo, facturación, gestión de cuentas, resolución de problemas técnicos, primeros pasos)
- Carpetas: subtemas específicos dentro de cada categoría (por ejemplo, en Facturación: Facturas, Cambios de plan, Reembolsos, Métodos de pago)
- Artículos: contenido de respuesta directa sobre un solo tema dentro de cada carpeta: un problema, un artículo
Evita: categorías que mezclen temas no relacionados, carpetas con más de 15 artículos y artículos que abarquen varios problemas no relacionados. Todo esto le indica a Freddy que los límites temáticos no están claros.
Evita: categorías que mezclen temas no relacionados, carpetas con más de 15 artículos y artículos que abarquen varios problemas no relacionados. Todo esto le indica a Freddy que los límites temáticos no están claros.
Paso 5: Ejecutar la migración y verificar la estructura
Cuando su base de conocimientos de origen esté limpia y su Freshdesk esté planificada, ejecute la migración. El conecta su plataforma de origen, asigna las categorías y carpetas a sus Freshdesk y transfiere los artículos con sus metadatos, archivos adjuntos y traducciones intactos.
Una vez finalizada la migración, antes de habilitar Freddy, verifique lo siguiente:
- El número de artículos en Freshdesk coincide con el número de artículos en la plataforma de origen (por versión de idioma)
- Estructura de categorías y carpetas recreada correctamente; compruebe las carpetas anidadas
- Los enlaces internos entre artículos funcionan (actualice cualquier URL de plataforma de origen codificada)
- Las imágenes y los archivos adjuntos incrustados se visualizan y descargan correctamente
- Los artículos en borrador permanecen en estado de borrador (no se publican accidentalmente para los clientes)
Paso 6: Habilitar Freddy AI y validar su precisión antes de la puesta en marcha
Habilita a Freddy solo después de que se complete la verificación de la estructura de la base de conocimientos. En AI Agent Studio, conecta los artículos de tu solución Freshdesk como fuente de conocimiento principal. Aún no habilites el agente de IA para las interacciones con clientes en tiempo real.
La prueba de validación de 20 consultas
Antes de la puesta en marcha, ejecute 20 consultas en Freddy que representen las categorías de tickets con mayor volumen. Utilice el lenguaje natural que usan sus clientes, no la terminología interna. Para cada consulta, compruebe lo siguiente:
- ¿Freddy devolvió un artículo relevante? (no una respuesta genérica)
- ¿La respuesta es precisa y actual (y no se basa en un artículo obsoleto que debería haberse eliminado)?
- ¿El nivel de confianza es el adecuado, sin mostrar un exceso de confianza en los casos extremos?
- Para consultas multilingües: ¿Freddy devuelve la versión correcta del idioma?
Se recomienda obtener una puntuación de 17 sobre 20 o superior (85 % de precisión) antes de habilitar Freddy para clientes reales. Si la precisión es inferior al 85 %, vuelva a la revisión de la estructura y el título del artículo en el paso 2 antes de su lanzamiento.
3. Redacción de artículos que Freddy puede utilizar: reglas de estructura
El proceso de migración gestiona la transferencia. La estructura del artículo determina qué hace Freddy con el contenido después de la transferencia. Estas son las cinco reglas de estructura de artículo que más influyen en la precisión de Freddy.
Regla 1: Responda la pregunta del primer párrafo
Freddy extrae respuestas de artículos para generar fragmentos destacados. Los artículos que comienzan con contexto o información general antes de la respuesta hacen que Freddy devuelva fragmentos incompletos o irrelevantes. Estructura cada artículo de la siguiente manera: primero la respuesta directa (40-60 palabras), luego la explicación y, finalmente, los detalles adicionales. Este formato también mejora la posibilidad de que aparezca como fragmento destacado en los resultados de búsqueda de Google.
Regla 2: Un artículo, un tema
Los artículos que abarcan varios problemas obligan a Freddy a elegir qué parte del contenido es relevante para una consulta determinada. A menudo, elige incorrectamente. Divide cualquier artículo que trate más de un problema o procedimiento distinto en artículos separados. Los artículos resultantes serán más cortos, claros y Freddy los identificará con mayor precisión.
Regla 3: Utilice un lenguaje comprensible para el cliente en los títulos y encabezados
Freddy relaciona las consultas con los artículos mediante el análisis del título y el encabezado. "Restablecer contraseña" coincide con una consulta sobre el olvido de la contraseña. "Flujo de trabajo de recuperación de credenciales" no. Analice cada título y encabezado H2 de los artículos comparándolo con la forma en que los clientes formulan sus solicitudes de soporte. Su historial de tickets es la mejor fuente para este lenguaje: busque los temas más comunes de sus tickets.
Regla 4: Incluir pasos explícitos para el contenido procedimental
Para los artículos instructivos, numere los pasos explícitamente. Freddy reconoce las secuencias de pasos numerados y puede hacer referencia a ellas en conversaciones de varios turnos («En el paso 3, necesitarás...»), una función que solo funciona si los pasos están numerados explícitamente, no descritos en forma de párrafo.
Regla 5: Etiqueta los artículos con palabras clave del tema
Freshdesk te permite añadir etiquetas a los artículos de soluciones. Estas etiquetas complementan la clasificación temática de Freddy. Utiliza entre 3 y 5 etiquetas por artículo que reflejen el tema, el área de producto y los términos de consulta más frecuentes de los clientes. No uses etiquetas de forma redundante: si la etiqueta ya está en el título del artículo, no aporta valor.
4. Lista de verificación para la limpieza de la base de conocimientos previa a la migración
Revisa esta lista de verificación en tu base de conocimientos antes de comenzar la migración. Todos los elementos que no se hayan completado antes de la migración deben completarse en Freshdesk después de la misma; esto es más lento, conlleva más riesgos y significa que Freddy se degradará hasta que se complete.
- Eliminar o archivar los artículos que no se hayan actualizado en más de 12 meses y que ya no reflejen el producto o la política actuales
- Reescribe los títulos de los artículos utilizando el lenguaje del cliente (para que coincidan con los 20 asuntos de tickets más frecuentes)
- Consolidar los artículos duplicados que tratan el mismo tema en un único artículo autorizado
- Verifica que todas las versiones lingüísticas estén presentes para los artículos en tu idioma principal; traduce las que falten antes de migrar
- Estandariza los nombres de las categorías para que coincidan con las principales áreas temáticas de tu producto (un máximo de 3 a 5 categorías para la mayoría de los equipos)
- Confirme que no haya más de 15 artículos por carpeta (divida las carpetas demasiado grandes antes de migrarlas)
- Elimine los enlaces integrados a la base de conocimientos de la plataforma de origen; estos dejarán de funcionar después de la migración
- Exporta los datos de visualización y utilidad de los artículos: úsalos para priorizar la limpieza de los artículos con mayor tráfico
- Marca los artículos verdaderamente obsoletos como "archivados" en la fuente en lugar de eliminarlos: la herramienta Help Desk Migration solo migra los artículos publicados y los borradores de forma predeterminada
- Ejecute una prueba de 20 consultas en su base de conocimientos de origen para establecer una puntuación de precisión de referencia antes de la migración
5. Cuándo es conveniente recurrir a servicios profesionales
La mayoría de los equipos pueden realizar una migración de la base de conocimientos de forma autónoma utilizando el asistente Help Desk Migration . Tres escenarios indican que los servicios profesionales ofrecerán mejores resultados:
bases de conocimiento grandes o complejas
Si su base de conocimientos contiene más de 500 artículos en varios idiomas, el servicio profesional se encarga de la limpieza, la planificación de la estructura y la secuencia de migración de principio a fin. Esto resulta especialmente valioso cuando la plataforma de origen tiene una estructura de categorías no estándar que necesita ser rediseñada para adaptarse a la jerarquía de tres niveles de Freshdeskantes de la migración.
Migración junto con la migración de tickets y contactos
Si está realizando una migración completa o exprés (que implica el traslado simultáneo de tickets, contactos, empresas y artículos de la base de conocimientos), el equipo de servicios profesionales coordina la secuencia. Los artículos de la base de conocimientos deben migrarse y verificarse antes de activar Freddy y antes de que comience la migración de tickets. Lograr la secuencia correcta requiere una planificación que resulta difícil de gestionar simultáneamente con una operación de soporte en vivo.
Configuración y entrenamiento de Freddy más allá de la configuración básica
Configurar Freddy con pares de preguntas y respuestas personalizados, múltiples tipos de fuentes de conocimiento, automatizaciones de flujo de trabajo e implementación en diversos canales (WhatsApp, chat web, Facebook) requiere servicios profesionales, no una configuración de autoservicio. Si los requisitos de su agente de IA van más allá de conectar artículos de soluciones a la configuración predeterminada de Freddy, nuestro equipo de servicios profesionales define el alcance e implementa la configuración completa.
¡Comience con una !
Antes de comprometerte con una migración completa de la base de conocimientos, realiza una demostración gratuita. La demostración migra 20 artículos y 20 tickets (si corresponde) a tu Freshdesk , mostrándote exactamente cómo se transfiere la estructura de categorías, cómo se asignan los artículos multilingües y si es necesario resolver algún problema de formato o campos antes de la migración completa. La mayoría de los equipos identifican al menos un problema estructural en la demostración que ahorra mucho tiempo después de la migración.
Conclusión: La calidad de la base de conocimientos es lo primero, la precisión de Freddy es lo segundo
Freddy AI no mejora tu base de conocimientos. Tu base de conocimientos mejora a Freddy. El orden es crucial: auditar, limpiar, estructurar, migrar, verificar, validar, en ese orden. Los equipos que implementan Freddy en una base de conocimientos migrada pero sin limpiar pasan semanas depurando la precisión de la IA, que nunca debería haberse visto afectada.
La buena noticia es que el proceso de limpieza previo a la migración descrito en esta guía cumple una doble función. Los artículos reestructurados para optimizar la precisión de Freddy también mejoran su posicionamiento en las búsquedas de Google. Los títulos reescritos para que coincidan con el lenguaje del cliente mejoran tanto la coincidencia de la intención de Freddy como las tasas de clics en la búsqueda orgánica. No estás haciendo trabajo extra, sino que lo haces una sola vez, correctamente.
Si vas a migrar a Freshdesk y quieres que tu base de conocimientos y Freddy AI estén configurados correctamente desde el primer día, comienza con una migración de demostración gratuita. Solo te llevará cinco minutos y te mostrará exactamente cómo se transfiere la estructura de tus artículos a Freshdesk antes de comprometerte con la migración completa.
Próximos pasos
Ejecuta tu : comprueba cómo se transfieren tus artículos de la base de conocimientos a Freshdesk antes de comprometerte: help-desk-migration.com/demo
Habla con nuestro equipo de servicios profesionales sobre la migración de la base de conocimientos y la configuración de Freddy
Lee la guía de migración con prioridad a la IA: para equipos que cambian a un helpdesk y necesitan el marco completo de calidad de datos
Preguntas frecuentes
Para la mayoría de las bases de conocimiento con menos de 500 artículos, la migración se completa en pocas horas. Las bases de conocimiento más grandes, con versiones en varios idiomas y estructuras de carpetas complejas, pueden tardar entre 6 y 12 horas. Primero, ejecute una migración de demostración gratuita: se completa en menos de 5 minutos y le proporciona una estimación precisa según la cantidad y estructura de sus artículos.
Freddy no se habilita automáticamente después de la migración. Una vez que sus artículos de la base de conocimientos estén en Freshdesk, conéctelos como fuente de conocimiento en AI Agent Studio, configure su agente de IA y ejecute la prueba de validación de 20 consultas antes de habilitar Freddy para los clientes. Calcule entre 2 y 4 horas para la configuración de Freddy después de que se complete la migración de la base de conocimientos.
Sí, Help Desk Migration conserva el formato de los artículos, incluidos los encabezados, las listas numeradas, las viñetas, las tablas y las imágenes insertadas. Las imágenes incrustadas se transfieren con el artículo. Los enlaces internos que hacen referencia a las URL de la base de conocimientos de su plataforma de origen deberán actualizarse a las nuevas URL Freshdesk después de la migración. Ejecute la comprobación de enlaces internos del paso 5 de esta guía inmediatamente después de la migración.
Help Desk Migration admite la migración de bases de conocimiento desde más de 90 plataformas, incluyendo Zendesk, Intercom, ServiceNow, Jira Service Management, HubSpoty otras. Solicita una demostración gratuita para confirmar que tu combinación específica de origen yFreshdesk es compatible y para previsualizar cómo se mapea la estructura de tus artículos antes de comprometerte con la migración completa.
Los artículos en borrador se migran como tales; no se publican automáticamente en Freshdesk. Los artículos publicados se migran como publicados. Los artículos archivados no se migran por defecto. Revise su lista de artículos en borrador antes de la migración: los borradores obsoletos deben eliminarse de la fuente en lugar de migrarse, ya que se contabilizan en el total de artículos y pueden aparecer en la lista de fuentes de conocimiento de AI Agent Studio.
Help Desk Migration migra todas las versiones lingüísticas simultáneamente en una sola ejecución. No se requieren migraciones separadas para cada idioma. Antes de migrar, verifique en su plataforma de origen que las versiones traducidas de los artículos estén publicadas o en estado de borrador; las versiones en estado de "traducción pendiente" podrían no exportarse a través de la API y deben completarse antes de que comience la migración.
Una migración de base de conocimientos bien estructurada y depurada mejora la precisión de Freddy. Una migración mal estructurada o sin depurar la degrada. El proceso de seis pasos que se describe en esta guía —auditar, limpiar, estructurar, migrar, verificar y validar— está diseñado específicamente para garantizar que la precisión de Freddy mejore durante la migración, y no después de semanas de limpieza posterior.
Los artículos de solución son el término que usa Freshdeskpara referirse a los artículos publicados en la base de conocimientos, visibles para clientes y agentes. Las fuentes de conocimiento de Freddy son los tipos de contenido de los que aprende Freddy AI, que incluyen artículos de solución, así como preguntas y respuestas personalizadas, archivos y URL. Al habilitar Freddy AI, conectas tus artículos de solución como una de sus fuentes de conocimiento. Las reglas de calidad y estructura de los artículos que se describen en esta guía se aplican específicamente a los artículos de solución.
