Buenas Prácticas en el Envío de Documentos y URLs para Sophia IA

Cómo preparar documentos y URLs para que Sophia IA genere respuestas completas, correctas y contextuales en las atenciones.

Sophia IA utiliza inteligencia artificial generativa para responder las preguntas de los viajeros durante las atenciones. Para que ofrezca respuestas completas, correctas y contextuales, es esencial que los contenidos que proporcionas (documentos y URLs) estén bien preparados.

Nuestra plataforma ya cuenta con un cuestionario completo que proporciona los contenidos sobre los temas más consultados en la hotelería. Aun así, es importante enviar contenidos complementarios: aquellos que todavía no has informado a través del cuestionario y consideras relevantes.

¿Por qué es importante?

La IA genera sus respuestas a partir del material proporcionado. Si el contenido es incompleto, está mal redactado o desorganizado, las respuestas tienden a ser superficiales o confusas.

Por otro lado, un texto claro, estructurado y detallado permite que Sophia entregue respuestas más ricas y precisas: un gran diferencial en la experiencia del cliente final.

Envío de documentos (docx, pdf y txt)

Al preparar un documento para enviar a Sophia, sigue estas recomendaciones:

• Se puede enviar cualquier archivo en los formatos admitidos, pero prefiere archivos con texto corrido (como manuales, FAQs o guías). Ten en cuenta que solo se envía el texto a Sophia; si el archivo contiene imágenes, no se considerarán.
• Usa un lenguaje claro y objetivo, evitando jerga sin explicación.
• Estructura el contenido con títulos, subtítulos y listas. No es obligatorio —la IA puede leer el contenido correctamente—, pero facilita la comprensión.
• Asegúrate de que el documento esté completo, sin páginas ni fragmentos faltantes, y que no supere los 100 MB.

Contenidos de URLs

• Solo se extraerá el texto de la página. Las imágenes, los íconos y los elementos visuales no se aprovechan.
• Prefiere páginas con contenido descriptivo y bien escrito, en lugar de textos cortos o fragmentados.
• Verifica que la URL sea pública y estable, evitando enlaces temporales o restringidos.
• Si es posible, usa páginas dedicadas a información relevante (páginas institucionales, FAQ en línea, reglamentos, artículos).
• La información extraída corresponde a la URL exacta proporcionada. Es decir, al extraer el contenido del enlace hotelasksuite.com/spa, solo se envía el contenido de esa página, y no el sitio completo.
• La extracción puede ser puntual (realizada una sola vez) o programada para ejecutarse automáticamente cada cierto tiempo, manteniendo el contenido actualizado a medida que el sitio cambia.
• En la extracción puntual, la información no se actualiza sola: si el contenido del sitio cambia, hay que actualizarlo manualmente o enviar una nueva versión y eliminar la anterior. En la programada, la actualización ocurre automáticamente según la periodicidad definida. Más información en Cómo configurar la actualización automática para contenidos extraídos desde una URL.

Cómo estructurar un buen contenido

Las prácticas a continuación se aplican a cualquier documento que envíes. Ayudan a Sophia a identificar el tema, entender el contexto y recuperar la información correcta.

1. Organización del contenido en bloques

El contenido debe estructurarse en bloques claros para facilitar la lectura y la interpretación por parte de Sophia. La organización ayuda a la IA a identificar rápidamente el tema, entender el contexto y recuperar la información correcta.

Estructura siempre el contenido con:

• Título / Tema
• Descripción
• Listas (cuando corresponda)
• Saltos de línea para separar la información

Evita los textos largos y continuos. Prefiere dividir la información de forma visualmente organizada.

Ejemplo:

PAQUETE FERIADO DÍA DEL TRABAJADOR

Descripción:
Paquete especial para el feriado, ideal para quienes buscan descanso,
exclusividad y contacto con la naturaleza. La experiencia está
enfocada en la tranquilidad, el confort y el bienestar.

Incluye:
- Desayuno
- Welcome drink en el check-in
- Clase de yoga el sábado por la mañana
- Atardecer con música en vivo el sábado por la tarde

Condiciones:
- Mínimo de 2 noches
- 1 botella de vino espumoso en la habitación

2. Separación por temas

Separa la información por temas siempre que haya más de un tipo de contenido en el mismo documento. Esto evita confusiones, mejora la lectura y ayuda a Sophia a identificar exactamente qué información usar en la respuesta.

Evita agrupar todo en un único bloque de texto. Siempre que sea posible, organiza por categorías claras, como: Programación, Inclusiones, Condiciones, Beneficios, Reglas. Esto es esencial, sobre todo cuando el contenido implica múltiples detalles operativos.

✕ Forma incorrecta

Un fin de semana para desconectar entre el verde y el mar, con cena
saludable, yoga, atardecer, programación de viernes a domingo con
actividades, práctica de yoga, meditación, cena, desayuno, check-out
a las 12 h, incluye espumoso en la habitación, mínimo de 2 noches,
opción de media pensión o pensión completa y evento exclusivo para
huéspedes.

✓ Forma correcta

PAQUETE YOGA, ATARDECER Y BIENESTAR

Descripción:
Experiencia de fin de semana enfocada en el bienestar, con actividades
como yoga, meditación y alimentación saludable, en un entorno exclusivo.

Programación:

Viernes:
- Apertura del evento
- Cena con menú saludable

Sábado:
- Desayuno
- Clase de yoga
- Rueda de conversación sobre la práctica
- Jugos detox
- Meditación en el deck
- Atardecer con saxofón y snack saludable
- Cena con menú saludable

Domingo:
- Clase de yoga de cierre
- Check-out a las 12 h

Beneficios:
- 1 botella de vino espumoso en la habitación

Condiciones:
- Mínimo de 2 noches
- Opción de media pensión o pensión completa
- Evento exclusivo para huéspedes
- Programación sujeta a cambios

3. Nombrar los ítems de forma distinta y clara

El contenido debe nombrarse de forma clara, específica y consistente. Los nombres genéricos o muy parecidos pueden generar ambigüedad, dificultando la interpretación de Sophia y dando lugar a respuestas imprecisas o incorrectas.

Siempre que haya contenidos similares, explicita las diferencias tanto en el nombre como en la descripción. Sophia depende de estas distinciones para comparar, identificar y responder correctamente a las preguntas de los viajeros.

Qué hacer

• Usar nombres completos y descriptivos
• Incluir diferenciales claros (ej.: parcial, frontal, premium, categoría, ubicación)
• Mantener un patrón consistente entre contenidos similares
• Garantizar que la descripción refuerce la diferencia entre los ítems

Qué evitar

• Nombres genéricos o vagos
• Variaciones de nombre que parecen diferentes, pero significan lo mismo
• Falta de estandarización
• Contenidos similares sin una explicación clara de la diferencia

✕ Forma incorrecta

Habitación Vista al Mar
Habitación con Vista al Mar
Habitación con Vista Mar

Descripción:
Habitaciones con vista al mar, cómodas y bien ubicadas.

Problema: los nombres parecen diferentes, pero no dejan claro si existen variaciones reales. Sophia no logra identificar diferencias y tiende a responder de forma genérica; por ejemplo: "Todas las habitaciones con vista al mar tienen características similares."

✓ Forma correcta

HABITACIÓN VISTA AL MAR PARCIAL
Habitación con vista lateral al mar.

HABITACIÓN VISTA AL MAR FRONTAL
Habitación con vista directa al mar.

HABITACIÓN VISTA AL MAR PREMIUM
Habitación con vista panorámica y mayor metraje.

Pregunta del viajero: "¿Cuál es la diferencia entre las habitaciones con vista al mar?"

Respuesta esperada: "La diferencia está en el tipo de vista y la categoría: Vista al Mar Parcial (vista lateral), Vista al Mar Frontal (vista directa) y Vista al Mar Premium (vista panorámica y mayor confort)."

4. FAQ (Preguntas y Respuestas)

Incluir preguntas y respuestas ayuda a Sophia a comprender mejor las intenciones de los viajeros y aumenta la precisión de las respuestas. El FAQ funciona como un refuerzo práctico del contenido, simulando dudas reales.

Las preguntas deben ser

• Directas y objetivas
• Relacionadas con el contenido del documento
• Escritas como las formularía el cliente

Las respuestas deben ser

• Claras y completas
• Basadas únicamente en el contenido presentado
• Sin agregar comportamiento ni instrucciones para la IA

Evita usar el FAQ para definir reglas de atención o el comportamiento de Sophia. El foco debe estar únicamente en el contenido.

Ejemplo:

PROGRAMA DE FIDELIDAD CON CASHBACK

Preguntas frecuentes:

¿Qué es el programa de fidelidad?
Es un programa que ofrece ventajas exclusivas para los huéspedes que
reservan directamente por el sitio web, como cashback y descuentos.

¿Cómo funciona el cashback?
Al registrarse y reservar por el sitio web, el huésped recibe un 5%
de cashback sobre el valor total de las noches, para usar en una
próxima estadía.

¿Cómo hago para asegurar el cashback?
Es necesario registrarse en el programa de fidelidad y completar la
validación enviada por correo electrónico después de la reserva.

¿Cuándo queda disponible el crédito?
El crédito queda disponible 5 días después de la fecha de check-out.

¿Dónde puedo usar el crédito?
El crédito puede usarse en una próxima reserva.

¿El cashback es válido para cualquier reserva?
No, es válido exclusivamente para reservas realizadas por el sitio
web oficial.

Límites de contenido

Hay dos límites importantes a considerar: el tamaño de cada documento y la cantidad de documentos consultados en cada pregunta.

Límite por documento

Sophia tiene un límite de procesamiento por contenido. Para garantizar un mejor desempeño y evitar la pérdida de información, mantén los textos dentro de un tamaño adecuado.

Recomendación: hasta aproximadamente 1.000 tokens, el equivalente a cerca de 4.000 caracteres o 700 palabras.

Los contenidos muy largos pueden ignorarse parcialmente, perder información relevante o generar respuestas incompletas. Siempre que el contenido sea extenso, debe dividirse en partes más pequeñas, organizadas por tema.

Límite de documentos consultados por tema

La clave es encontrar el equilibrio entre dividir y consolidar:

• Divide en varios documentos cuando el contenido sea muy largo, separando por tema, contexto o categoría (respetando el límite de tamaño indicado arriba).
• No crees varios documentos diferentes que traten el mismo tema. Consolida la información relacionada en un único contenido bien estructurado.
• Procura que cada documento sea autosuficiente sobre su subtema, para que una respuesta no dependa de reunir muchos documentos al mismo tiempo.
• Usa nombres distintos y claros (consulta la sección "Nombrar los ítems de forma distinta y clara", más arriba) solo para diferenciar los contenidos que realmente son diferentes.

Qué hacer

• Mantener los contenidos cortos y objetivos
• Dividir los contenidos grandes en múltiples documentos, por tema
• Consolidar los contenidos repetidos sobre el mismo tema
• Priorizar la información más relevante

Qué evitar

• Crear documentos muy largos
• Crear varios documentos casi idénticos sobre el mismo tema
• Mezclar múltiples asuntos para "aprovechar el espacio"
• Ignorar el límite de tokens

Automatizaciones por tema

La automatización por tema permite definir instrucciones específicas que orientan el comportamiento de Sophia en función de un asunto identificado en la conversación. Funciona como un "prompt controlado", indicando cuándo y cómo debe responder Sophia. A diferencia de las frases de activación, no depende de una frase exacta: Sophia identifica el contexto de la conversación y aplica la instrucción definida.

Más información en Automatización de Etiquetas y Respuestas por Temas.

Restricciones y buenas prácticas técnicas

Los puntos a continuación no son bloqueos absolutos, pero afectan directamente la lectura y la interpretación de la IA.

Formato (Markdown y HTML)

• No es obligatorio utilizar Markdown.
• El contenido puede insertarse como texto plano normalmente.
• Se permite HTML, pero puede contener código innecesario ("basura") y perjudicar la lectura de la IA si está desorganizado.

Instrucciones dentro del contenido

• La base de conocimiento no debe contener instrucciones de comportamiento de la IA.
• Los contenidos deben ser únicamente informativos.
• Las instrucciones deben configurarse por separado (ej.: automatización por tema).

Interpretación de contenido estructurado

Los contenidos con exceso de marcado (HTML o formato complejo) pueden dificultar la lectura y generar interpretaciones incorrectas.

✕ Ejemplo de HTML desorganizado

<div><span><b>Paquete especial</b></span></div>
<div><span>Incluye desayuno</span></div>
<div><span><i>Reglas mezcladas con instrucciones:</i></span></div>
<div><span>Cuando el cliente pida descuento, enviar enlace X</span></div>

Problema: código innecesario, mezcla de contenido con instrucciones y dificultad de interpretación para Sophia.

Plantilla modelo completa

A continuación se muestra un modelo estándar listo para usar en la base de conocimiento de Sophia. Sigue todas las buenas prácticas presentadas: organización en bloques, separación por temas, claridad, límite de contenido y uso de FAQ. Puede usarse como base para crear nuevos contenidos.

Plantilla en blanco (para completar)

[Título / Tema]
Describe un nombre claro, específico y completo para el contenido.

[Descripción]
Escribe un resumen objetivo que explique qué es el contenido, para
quién es y cuál es la propuesta.

[Listas y Separación por Temas]
Organiza la información en bloques claros, usando listas y saltos de
línea.
Ejemplo de estructura:
- Programación (si corresponde)
- Incluye
- Beneficios
- Condiciones
- Perfil del producto

[FAQ - Preguntas frecuentes]
Agrega preguntas y respuestas basadas en las dudas reales del cliente.
Las preguntas deben ser directas y las respuestas objetivas.

[Automatización por Tema - opcional]
Define una instrucción corta y específica que indique cuándo y cómo
debe responder Sophia sobre este contenido. Recuerda: esta instrucción
se configura en la automatización por tema, no dentro del documento.
Evita las instrucciones genéricas.

Consejo de oro

Pregúntate siempre: "Si yo tuviera que responderle al cliente, ¿este contenido me daría toda la información necesaria?" Si la respuesta es sí, es una buena señal de que Sophia IA podrá generar respuestas completas, confiables y diferenciadas.