Un chatbot de IA para equipos de documentación técnica que necesitan respuestas con citas de fuentes y menos tickets de soporte. ChattyBox responde preguntas como «¿Cómo autentico las solicitudes de la API?» directamente desde tus documentos y enlaza la página que utilizó, sin RAG personalizado y sin migración.
Los chatbots de IA de uso general intentan ser conversadores. Cuando no saben una respuesta, la inventan.
Usamos generación aumentada por recuperación sobre tu documentación publicada y contenido del sitio, y luego mostramos enlaces fuente de donde vienen las respuestas.
Para equipos que necesitan evidencia visible en cada respuesta, compara el flujo de un chatbot de IA con citas de fuente que mantiene el tráfico de documentación conectado con páginas de respaldo.
Un chatbot de documentación gana confianza respondiendo las preguntas repetitivas que sus canales de soporte y comunidad ya ven, y citando la página que utilizó. Estos son ejemplos que ChattyBox maneja del contenido de documentos indexados.
Construye el conjunto de pruebas a partir de tareas reales de documentación, adjunta una fuente de referencia y los hechos esperados a cada pregunta respondible, e incluye preguntas que el asistente debe rechazar. Califica cada categoría por separado para que un buen resultado de API no oculte una guía débil de migración o autenticación.
Vuelve a ejecutar el conjunto de pruebas antes del lanzamiento, después de cambios materiales en la documentación o la recuperación, y en una muestra mensual programada tras el lanzamiento.
| Área de pregunta | Casos de prueba | Condición de aprobación |
|---|---|---|
| API | Endpoint, campos obligatorios, forma de la respuesta y límite de frecuencia. | Usa el método y la ruta documentados; los valores obligatorios y la cita coinciden con la referencia. |
| SDK | Instala e inicializa una versión de SDK soportada. | El paquete, la importación, la inicialización y la sintaxis del código coinciden con ese lenguaje y versión. |
| CLI | Instala, autentica, ejecuta un comando e interpreta la salida. | Las opciones y el orden son válidos; la respuesta no inventa avisos interactivos. |
| Autenticación | Ubicación de credenciales, formato de cabecera, ámbitos y un flujo prohibido. | Nunca expone un secreto, distingue el uso de cliente y servidor, y cita el requisito de seguridad. |
| Paginación | Primera página, continuación, página final y tamaño máximo de página. | Usa el modelo de cursor o desplazamiento documentado y solo indica límites documentados. |
| Errores | Código de error conocido, causa probable, paso de recuperación y código desconocido. | Mapea los errores conocidos correctamente y recurre al respaldo para causas no documentadas. |
| Migraciones | Cambio disruptivo, requisito previo, pasos ordenados y nota de reversión. | Preserva la secuencia y las advertencias sin mezclar procedimientos antiguos y nuevos. |
| Documentación versionada | Haz la misma pregunta de comportamiento para las versiones actual, anterior y no especificada. | Responde a la versión indicada, pregunta cuando es ambiguo, y cita esa versión. |
Publica las reglas antes de probar. Los revisores deberían llegar al mismo resultado a partir de la respuesta, los hechos esperados y la fuente citada sin depender de lo persuasiva que suene la respuesta.
| Dimensión | Aceptar solo cuando |
|---|---|
| Calidad de la respuesta | Todos los hechos obligatorios son correctos, relevantes, no contradictorios y usan la versión de API, SDK, CLI o documentación solicitada. |
| Precisión de las citas | Cada afirmación material tiene una cita que se resuelve y la respalda directamente en la página versionada correcta. |
| Comportamiento de respaldo | La evidencia faltante, ambigua, conflictiva o no autorizada produce una limitación clara y un siguiente paso útil en lugar de una conjetura. |
| Puerta de lanzamiento | Cero afirmaciones críticas de autenticación o migración sin respaldo, 100% de aprobación en casos críticos, al menos 90% de aceptación general y al menos 95% de precisión en las citas. |
Método: escribe 24 preguntas antes de ejecutar el asistente, tres por cada área de la matriz. Para cada pregunta, registra la versión prevista, la página de referencia, los hechos obligatorios, las afirmaciones prohibidas y si se espera respaldo. Dos revisores califican de forma independiente las respuestas congeladas, reconcilian los desacuerdos contra la fuente y conservan los avisos y las salidas para las pruebas de regresión.
Las cifras siguientes son un resultado resuelto ilustrativo para este conjunto de 24 preguntas, no un promedio medido de producción de ChattyBox ni una promesa de rendimiento futuro.
| Resultado observado | Interpretación |
|---|---|
| 22 de 24 aceptadas (91.7%) | Incluye 20 respuestas con respaldo y dos respaldos correctos. |
| 20 de 22 respuestas sustantivas citaron páginas de respaldo directo (90.9%) | Por debajo de la puerta de lanzamiento del 95%; el ranking de versiones necesita corrección. |
| 2 de 2 respaldos esperados fueron correctos (100%) | Ningún caso respondible recurrió incorrectamente al respaldo en este pequeño conjunto. |
| 1 de 24 contenía un detalle de paginación sin respaldo (4.2%) | El lanzamiento sigue bloqueado hasta que se elimine la afirmación sin respaldo y la regresión se apruebe. |
Flujos de trabajo diseñados específicamente que mantienen las respuestas fundamentadas, rastreables y útiles para los usuarios técnicos.
Ingrese la URL de sus documentos, sitio web o mapa del sitio. ChattyBox rastrea e indexa las páginas que los usuarios ya leen.
El flujo de respuestas está configurado para usar contexto recuperado y evitar afirmaciones sin respaldo sobre API, funciones, precios o políticas.
Las respuestas pueden incluir enlaces a las páginas de documentación donde vive la información relevante.
Trata el lanzamiento como una publicación de documentación con responsables, puertas, observabilidad y una ruta de reversión.
Segmenta cada métrica por tema, versión de documentación, idioma y público cuando el tamaño de muestra lo permita. Las tendencias y las muestras revisadas son más útiles que una sola puntuación agregada.
| Métrica | Definición y acción |
|---|---|
| Tasa de respuesta | Proporción de preguntas que reciben una respuesta sustantiva. Revisa los temas con tasa baja por contenido faltante; no mejores el número debilitando el respaldo. |
| Preguntas sin resolver | Preguntas con respaldo, comentarios negativos, reformulaciones repetidas o escalado. Muéstrealas semanalmente para detectar defectos de respuesta y recuperación. |
| Lagunas de contenido | Clústeres sin resolver donde no existe una página autorizada. Derívalos a la acumulación de documentación con frecuencia e impacto en el usuario. |
| Tasa de respaldo de citas | Afirmaciones materiales revisadas con una cita de respaldo directo. Investiga las caídas por fuente y versión. |
| Desvío de tickets | Sesiones elegibles que se resuelven sin un ticket de soporte, medidas con una ventana definida y comparadas con una línea base. Informa la asociación a menos que un experimento establezca causalidad. |
Usa la guía de arquitectura y evaluación RAG para diagnosticar la recuperación, el flujo de citas para revisar la evidencia, la guía de documentación para desarrolladores para casos de uso específicos de ingeniería, y la lista de verificación de lanzamiento técnico para los pasos de despliegue.
Estas respuestas resumen cómo ChattyBox lee el contenido fuente, cita páginas de documentación, maneja la información faltante y lo instala junto con una pila de documentos existente.
ChattyBox rastrea sus documentos publicados, sitio web, mapa del sitio, CMS o páginas del centro de ayuda, extrae texto legible y recupera pasajes relevantes cuando un visitante hace una pregunta.
Sí. Cuando el material fuente está disponible, ChattyBox puede mostrar enlaces a las páginas de documentación utilizadas para la respuesta para que los usuarios puedan verificar los detalles y seguir leyendo.
El asistente está diseñado para evitar afirmaciones no fundamentadas y puede recurrir a ellas cuando el contenido indexado no incluye la respuesta. Esas lagunas pueden informar futuras actualizaciones de la documentación.
No. Puede conservar su pila de documentos actual e incrustar el widget ChattyBox después de rastrear y probar las respuestas citadas.
Usa ChattyBox para responder preguntas repetitivas de documentación a partir del contenido fuente y dirigir las lagunas a tu acumulación de documentación.
