1. Añade documentación pública y prueba preguntas reales
Free es permanente: un sitio, hasta 10 páginas y 100 mensajes al mes, sin tarjeta de crédito. Comprueba las respuestas y las fuentes; después inserta el widget cuando estés listo.
Chatbot para documentación técnica
Añade un chatbot a tu documentación técnica
Empieza por tu documentación pública, prueba preguntas técnicas reales y comprueba las fuentes enlazadas antes de añadir el widget a tu sitio.
Free permanente: 10 páginas, 100 mensajes/mes, sin tarjetaLas respuestas respaldadas pueden enlazar al contenido fuente
Empieza con una prueba pequeña de documentación
Generic AI
Por qué los chatbots genéricos fallan a sus usuarios
Los chatbots de IA de uso general intentan conversar. Sin basarse en fuentes, pueden responder con seguridad desde el contexto equivocado.
- Pueden sugerir funciones que no existen
- Pueden dar ejemplos de código desactualizados
- Pueden mencionar productos de competidores
- Pueden frustrar a usuarios técnicos
ChattyBox
En qué se diferencia ChattyBox
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.
- Respuestas basadas en sus documentos y páginas fuente
- Enlaces de citas directas a páginas fuente.
- Respuesta "No sé" si falta información
- Los ejemplos de código permanecen vinculados a páginas fuente indexadas
Chatbot de documentación en la práctica
Preguntas que debe responder un chatbot de documentación
Usa las preguntas que ya reciben tus canales de soporte y comunidad. Comprueba cada respuesta y su página fuente enlazada antes de publicar el widget.
01
"¿Cómo empiezo, me autentico y realizo mi primera solicitud?"
02
"¿Qué significa este error y dónde está documentada la solución?"
03
"¿Cuáles son los límites del plan, los límites de tarifas y los precios de esta función?"
04
"¿Necesito migrar mi plataforma de documentos o puedo colocarla junto a mi sitio actual?"
Para el público técnico, consulta el chatbot de documentos para desarrolladores, o descubre cómo reducir los tickets de soporte con IA a partir del contenido existente.
Elige tu stack
Chatbot para Docusaurus con fuentes citadasAgrega un chatbot de IA para Docusaurus que responde desde tus documentos y cita las páginas que utilizó. Sin RAG personalizado, precios claros y una sola etiqueta de script para incrustar.
Chatbot de IA para MkDocs con citas de fuentesAgregue un chatbot de IA a la documentación MkDocs o Material for MkDocs con respuestas citadas en sus páginas existentes.
La documentación de API necesita límites de fuentes precisos
Usa el chatbot para ayudar a los desarrolladores a encontrar endpoints, pasos de autenticación, parámetros, métodos del SDK y errores conocidos, y vuelve después a la referencia para consultar el contexto completo. Un ejemplo de código plausible o una cita visible no demuestra que el comportamiento de la API sea correcto.
- Comprueba primero el contenido extraído. El crawler no ejecuta el JavaScript de las páginas; las referencias interactivas pueden no mostrar los detalles de los endpoints en el HTML recuperado. Descubrir una URL no significa que la referencia se haya indexado por completo.
- Delimita las versiones de forma intencionada con URL seleccionadas o proyectos separados. Comprueba el método, la ruta, los campos obligatorios, los permisos, la paginación y los límites de velocidad de la versión correspondiente, sin mezclar ejemplos antiguos del SDK ni pasos de migración.
- Prueba endpoints sin documentar, códigos de error desconocidos, versiones ambiguas y solicitudes que impliquen credenciales. Exige una limitación clara o un siguiente paso en lugar de un comportamiento inventado. No introduzcas nunca secretos en un conjunto de fuentes público ni en un prompt de prueba.
Guía de evaluación, no resultados medidos
Un marco de evaluación reutilizable para documentación técnica
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.
- Autor técnico
- Ingeniería de ChattyBox
- Revisor técnico
- Revisión de documentación de ChattyBox
- Última actualización
- Información verificada
- 9 de julio de 2026
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 |
|---|---|---|
Área de pregunta API | Casos de prueba Endpoint, campos obligatorios, forma de la respuesta y límite de frecuencia. | Condición de aprobación Usa el método y la ruta documentados; los valores obligatorios y la cita coinciden con la referencia. |
Área de pregunta SDK | Casos de prueba Instala e inicializa una versión de SDK soportada. | Condición de aprobación El paquete, la importación, la inicialización y la sintaxis del código coinciden con ese lenguaje y versión. |
Área de pregunta CLI | Casos de prueba Instala, autentica, ejecuta un comando e interpreta la salida. | Condición de aprobación Las opciones y el orden son válidos; la respuesta no inventa avisos interactivos. |
Área de pregunta Autenticación | Casos de prueba Ubicación de credenciales, formato de cabecera, ámbitos y un flujo prohibido. | Condición de aprobación Nunca expone un secreto, distingue el uso de cliente y servidor, y cita el requisito de seguridad. |
Área de pregunta Paginación | Casos de prueba Primera página, continuación, página final y tamaño máximo de página. | Condición de aprobación Usa el modelo de cursor o desplazamiento documentado y solo indica límites documentados. |
Área de pregunta Errores | Casos de prueba Código de error conocido, causa probable, paso de recuperación y código desconocido. | Condición de aprobación Mapea los errores conocidos correctamente y recurre al respaldo para causas no documentadas. |
Área de pregunta Migraciones | Casos de prueba Cambio disruptivo, requisito previo, pasos ordenados y nota de reversión. | Condición de aprobación Preserva la secuencia y las advertencias sin mezclar procedimientos antiguos y nuevos. |
Área de pregunta Documentación versionada | Casos de prueba Haz la misma pregunta de comportamiento para las versiones actual, anterior y no especificada. | Condición de aprobación Responde a la versión indicada, pregunta cuando es ambiguo, y cita esa versión. |
Fuentes primarias y evidencia reproducible
Reglas de aceptación explícitas
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 |
|---|---|
Dimensión Calidad de la respuesta | Aceptar solo cuando Todos los hechos obligatorios son correctos, relevantes, no contradictorios y usan la versión de API, SDK, CLI o documentación solicitada. |
Dimensión Precisión de las citas | Aceptar solo cuando Cada afirmación material tiene una cita que se resuelve y la respalda directamente en la página versionada correcta. |
Dimensión Comportamiento de respaldo | Aceptar solo cuando La evidencia faltante, ambigua, conflictiva o no autorizada produce una limitación clara y un siguiente paso útil en lugar de una conjetura. |
Dimensión Puerta de lanzamiento | Aceptar solo cuando 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. |
Ejemplo de evaluación, no resultados medidos
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.
Todas las cifras siguientes son un ejemplo hipotético para un conjunto de 24 preguntas, no un resultado medido de ChattyBox, un promedio de producción ni una promesa de rendimiento futuro.
| Resultado de ejemplo, no medido | Cómo usar el ejemplo |
|---|---|
Resultado de ejemplo, no medido Ejemplo: 22 de 24 casos aceptados (91.7%) | Cómo usar el ejemplo Interpretación de ejemplo: 20 respuestas respaldadas y dos respuestas de respaldo correctas. |
Resultado de ejemplo, no medido Ejemplo: 20 de 22 respuestas sustantivas citaron directamente páginas que las respaldan (90.9%) | Cómo usar el ejemplo Interpretación de ejemplo: por debajo de la puerta de lanzamiento del 95%, por lo que la clasificación de versiones necesita corrección. |
Resultado de ejemplo, no medido Ejemplo: 2 de 2 respuestas de respaldo esperadas fueron correctas (100%) | Cómo usar el ejemplo Interpretación de ejemplo: en este pequeño conjunto, ningún caso que admitía respuesta recurrió incorrectamente al respaldo. |
Resultado de ejemplo, no medido Ejemplo: 1 de 24 contenía un detalle de paginación sin respaldo (4.2%) | Cómo usar el ejemplo Interpretación de ejemplo: bloquea el lanzamiento hasta eliminar la afirmación sin respaldo y aprobar la regresión. |
Capacidades principales
Creado para sitios de documentación y soporte
Flujos de trabajo diseñados específicamente que mantienen las respuestas fundamentadas, rastreables y útiles para los usuarios técnicos.
Rastreo instantáneo
Ingrese la URL de sus documentos, sitio web o mapa del sitio. ChattyBox rastrea e indexa las páginas que los usuarios ya leen.
Barandillas estrictas
El flujo de respuestas está configurado para usar contexto recuperado y evitar afirmaciones sin respaldo sobre API, funciones, precios o políticas.
Vinculación de fuentes
Las respuestas pueden incluir enlaces a las páginas de documentación donde vive la información relevante.
Lista de verificación de despliegue del chatbot de documentación
Trata el lanzamiento como una publicación de documentación con responsables, puertas, observabilidad y una ruta de reversión.
- 1Haz un inventario de las fuentes públicas y restringidas; asigna un responsable y público previsto a cada una.
- 2Excluye secretos, borradores, páginas duplicadas, versiones no soportadas y rutas privadas del conjunto de fuentes del chatbot público.
- 3Crea casos de prueba respondibles, no respondibles, ambiguos, adversariales y de conflicto de versión en las ocho áreas de la matriz.
- 4Ejecuta el conjunto de aceptación, inspecciona las citas manualmente y bloquea el lanzamiento ante cualquier afirmación crítica sin respaldo.
- 5Haz una prueba piloto con un público limitado; registra los comentarios, las preguntas sin resolver, la latencia y el comportamiento de escalado.
- 6Publica un responsable, un calendario de reindexación, una ruta de incidentes, una condición de reversión y una cadencia de regresión recurrente.
Métricas tras el lanzamiento que conducen a la acció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 |
|---|---|
Métrica Tasa de respuesta | Definición y acción 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. |
Métrica Preguntas sin resolver | Definición y acción Preguntas con respaldo, comentarios negativos, reformulaciones repetidas o escalado. Muéstrealas semanalmente para detectar defectos de respuesta y recuperación. |
Métrica Lagunas de contenido | Definición y acción 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. |
Métrica Tasa de respaldo de citas | Definición y acción Afirmaciones materiales revisadas con una cita de respaldo directo. Investiga las caídas por fuente y versión. |
Métrica Desvío de tickets | Definición y acción 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 revisión de la documentación API para casos de uso específicos de ingeniería, y la lista de verificación de lanzamiento técnico para los pasos de despliegue.
Preguntas frecuentes sobre el chatbot de documentación
Preguntas comunes sobre los chatbots de documentación de IA
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.
¿Puedo usar un chatbot para la documentación de API?
Sí, cuando las referencias de endpoints, los parámetros, las guías de autenticación, los ejemplos de SDK y los detalles de errores están presentes en contenido público indexado. No ejecuta llamadas a la API ni inspecciona cuentas privadas. El contexto recuperado y las citas no eliminan el comportamiento de API inventado; prueba las afirmaciones importantes con la referencia.
¿Free es una prueba?
No. Free es una prueba permanente y de alcance reducido: un sitio, hasta 10 páginas y 100 mensajes al mes, sin tarjeta de crédito.
¿Con qué páginas de documentación debería empezar?
Empieza por las páginas públicas que responden a preguntas habituales sobre configuración, resolución de problemas, precios y producto. Puedes ampliar el conjunto de fuentes después de comprobar las primeras respuestas.
¿Cuándo debería añadir más documentación?
Añade más páginas cuando el primer conjunto de pruebas sea útil y las fuentes de apoyo estén actualizadas. Mantén fuera del chatbot las páginas privadas, obsoletas y no relacionadas.
¿Puedo probar las respuestas antes de instalar el widget?
Sí. Rastrea la documentación pública seleccionada, haz preguntas técnicas reales y abre las páginas fuente citadas para revisar las respuestas antes de instalar el widget.
¿Qué ocurre cuando la documentación no respalda una respuesta?
El asistente debería indicar la limitación u ofrecer un siguiente paso útil en lugar de adivinar. Trata las respuestas no respaldadas como un caso de prueba y una posible carencia documental.
Demuestra la calidad de las respuestas antes de instalarlo
Empieza con el plan Free permanente para probar páginas públicas seleccionadas, plantea preguntas técnicas y revisa las fuentes antes de insertar el widget.
Free permanente: 10 páginas y 100 mensajes/mes