Documentation Index
Fetch the complete documentation index at: https://help.treble.ai/llms.txt
Use this file to discover all available pages before exploring further.
Introducción
Una base de conocimiento bien estructurada es esencial para que tus Agentes de IA entreguen respuestas útiles, precisas y coherentes. Si los documentos que subes están mal estructurados, incompletos o son difíciles de interpretar, el Agente de IA puede ofrecer respuestas incorrectas o inventadas. Por otro lado, cuando la información es clara, organizada y redactada con intención, el Agente de IA entiende mejor el contexto y entrega respuestas de mayor calidad. Crear una base de conocimiento sólida es como capacitar a un nuevo miembro del equipo: necesitas explicar las cosas con claridad, proporcionar documentos bien elaborados y asegurarte de que los comprenda.Usa formatos legibles por la IA
La IA solo puede leer texto digital. Los archivos escaneados o los que contienen texto como imagen no son útiles, aunque visualmente se vean bien. Recomendado:.docx, .txt, .md, .pdf (solo si el texto es seleccionable)
Ejemplos
✅ Correcto: Un documento.docx exportado desde Word con estilos de encabezado, párrafos y listas.
✅ Correcto: Un archivo .txt simple con secciones separadas por títulos.
⚠️ Aceptable: Un .pdf generado desde Word u otra herramienta digital, siempre que puedas seleccionar el texto con el mouse.
❌ Incorrecto: Un PDF escaneado desde papel o un archivo basado en imágenes (aunque se vea profesional, la IA no podrá interpretarlo).
Estructura clara y por temas
Una base de conocimiento efectiva está organizada por temas. No pongas todo en un solo documento largo y ambiguo. Usa títulos, subtítulos y segmenta el contenido según su propósito. Haz esto:- Divide tu contenido en archivos separados por tema o departamento (ej.: “Políticas de facturación”, “Preguntas frecuentes sobre envíos”, “Ficha técnica del Producto A”).
- Usa encabezados jerárquicos (
Título principal,Subtítulo,Puntos clave).
Ejemplos
✅ Correcto: Un documento sobre garantías con secciones como “¿Qué cubre?”, “Duración”, “Cómo presentar una reclamación”. ❌ Incorrecto: Un archivo que mezcla políticas de ventas, información de contacto, especificaciones del producto y soporte en una sola página continua.Escribe con contexto completo
Cada fragmento de texto debe tener sentido por sí solo. La IA a menudo lee solo un párrafo aislado, por lo que no debe depender de títulos ni del contenido anterior. Haz esto:- Escribe con contexto explícito.
- Incluye nombres de productos, lugares, fechas o condiciones directamente en la oración.
Ejemplos
✅ Correcto: “La política de garantía para autos eléctricos es válida en México y tiene una duración de 24 meses a partir de la fecha de compra.” ❌ Incorrecto: “Tiene 2 años de cobertura” (¿Qué tiene? ¿Dónde? ¿Desde cuándo?)Usa lenguaje claro, preciso y consistente
La IA no interpreta la ambigüedad, la jerga o las frases enredadas como lo haría un humano. Es fundamental escribir con claridad, evitar sinónimos innecesarios y definir todos los términos. Haz esto:Usa oraciones cortas y directas.
Mantén el mismo término para cada concepto (ej.: no alternes entre “cliente” y “usuario”).
Ejemplos
✅ Correcto: “El CRM (Customer Relationship Management) ayuda a gestionar todos los prospectos.” ❌ Incorrecto: “La herramienta de leads o sistema de usuarios permite…” (confuso e inconsistente)Usa plantillas y formatos repetibles
Cuando subas muchos documentos similares (como fichas de productos, procesos o guías), usar una estructura consistente ayuda al modelo a reconocer patrones. Haz esto:- Usa plantillas fijas para cada tipo de documento.
- Mantén el mismo orden de secciones en cada archivo.
Ejemplos
✅ Correcto: Cada producto incluye: nombre, descripción, especificaciones, preguntas frecuentes, contacto de soporte. ❌ Incorrecto: Cada ficha de producto tiene un diseño diferente: a algunas les falta la descripción o la separación por secciones.Incluye preguntas y ejemplos
Anticipar las preguntas del usuario ayuda al modelo a entender mejor el lenguaje natural. Incluir ejemplos de preguntas y respuestas bien redactados mejora significativamente la calidad de las respuestas generadas. Haz esto:- Incluye una pequeña sección de preguntas frecuentes (FAQ).
- Escribe preguntas reales o representativas con respuestas claras.
Ejemplos
✅ Correcto: P: ¿Hacen envíos internacionales? R: Actualmente solo enviamos dentro de México. Próximamente se agregarán más países. ❌ Incorrecto: Solo incluir “no hacemos envíos internacionales” fuera de contexto o en una lista con viñetas.Elimina redundancias y contradicciones
Dos archivos con versiones diferentes del mismo dato pueden confundir a la IA y generar respuestas incorrectas. La IA no “elige la mejor”, sino que mezcla lo que encuentra. Haz esto:- Centraliza los datos clave (precios, fechas, condiciones).
- Conserva solo la versión más reciente de cada documento.
Ejemplos
✅ Correcto: Un único archivo titulado “Políticas de garantía actualizadas - marzo 2025.pdf” ❌ Incorrecto: Tres archivos diferentes que indican que la garantía es de 6, 12 y 24 meses respectivamente.Mantén tu base de conocimiento actualizada
La calidad de tu agente también depende de qué tan vigente esté tu información. Los documentos siempre deben ser relevantes y estar al día. Haz esto:- Revisa tu base de conocimiento mensual o trimestralmente.
- Revísala cada vez que haya cambios en tus productos o servicios.
- Elimina archivos desactualizados y sube versiones actualizadas con fechas claras.
Ejemplos
✅ Correcto: “Catálogo de productos - actualizado abril 2025” ❌ Incorrecto: Documentos mezclados sin claridad sobre cuál está vigente.Qué incluir según la industria
Cada industria tiene información clave que siempre debe estar presente en sus documentos. Asegúrate de incluir estos detalles para que tus agentes tengan el contexto completo:| Industria | Información clave a incluir |
|---|---|
| Educación | Fechas de inscripción, niveles académicos, modalidades |
| Salud | Procedimientos, horarios, tipo de servicios |
| Inmobiliaria | Ubicación, precios, medios de contacto |
| Facturación | Métodos de pago, vigencia de facturas, contacto de soporte |
| Automotriz | Modelos disponibles, garantías, ubicación de agencias |
| Joyería | Tipos de producto, materiales, políticas de devolución |