El assistant responde preguntas sobre tu documentación mediante consultas en lenguaje natural. Está integrado directamente en tu sitio de documentación, de modo que los usuarios puedan encontrar respuestas rápidamente y sacarle el máximo partido a tu producto.El assistant utiliza RAG agéntico (generación aumentada por recuperación) con llamadas a herramientas impulsadas por Claude Opus 4.5. Cuando los usuarios hacen preguntas, el assistant:
Busca y recupera contenido relevante de tu documentación para ofrecer respuestas precisas.
Cita fuentes y proporciona enlaces navegables para llevar a los usuarios directamente a las páginas de referencia.
Genera ejemplos de código que se pueden copiar para ayudar a los usuarios a implementar soluciones a partir de tu documentación.
Cada mensaje enviado al assistant cuenta para el límite de mensajes de tu plan. Si superas tu límite, los mensajes adicionales generarán cargos por excedente. Puedes establecer límites de gasto o desactivar el assistant si alcanzas tu límite de mensajes.Puedes ver el uso del assistant desde tu dashboard para comprender el comportamiento de los usuarios y la eficacia de la documentación. Exporta y analiza los datos de consultas para ayudar a identificar:
Preguntas frecuentes que podrían necesitar mejor cobertura.
Lagunas de contenido donde los usuarios tienen dificultades para encontrar respuestas.
Temas populares que podrían beneficiarse de contenido adicional.
El asistente está habilitado de forma predeterminada para los planes Pro y Custom.Administra el asistente desde tu dashboard. Haz clic en Configuration para activar o desactivar el asistente, configurar cómo se gestionan las respuestas, añadir preguntas predeterminadas y establecer un límite de gasto.
En la sección de gestión de respuestas, habilita el assistant para redirigir las preguntas sin respuesta a tu equipo de soporte. Especifica una dirección de correo electrónico que el assistant proporcionará a los usuarios que hagan preguntas que no puede responder.
Ayuda a tus usuarios a iniciar preguntas con el assistant agregando preguntas de ejemplo. En la sección de sugerencias de búsqueda, agrega hasta tres preguntas de ejemplo.
Establece un límite de gasto para controlar lo que sucede si alcanzas tu cupo de mensajes. De forma predeterminada, el assistant continúa respondiendo preguntas de los usuarios después de que alcanzas tu cupo de mensajes, lo que genera cargos por excedente.Cuando alcanzas tu límite de gasto, el assistant se deshabilita hasta que se restablezca tu cupo de mensajes.
Selecciona la pestaña Billing.
Establece un límite de gasto para los mensajes del assistant que excedan tu cupo.
Configura alertas de uso para recibir un correo electrónico cuando alcances un determinado porcentaje de tu límite de gasto.
Los usuarios tienen varias formas de iniciar una conversación con el assistant. Cada método abre un panel de chat en el lado derecho de tu documentación. Los usuarios pueden hacer cualquier pregunta y el assistant busca una respuesta en tu documentación. Si no se encuentra información relevante, el assistant indica que no puede responder a la pregunta.Añade el assistant como bot a tu espacio de trabajo de Slack o servidor de Discord para que tu comunidad pueda hacer preguntas sin salir de su plataforma preferida.
Cuando el assistant está habilitado, aparece en dos ubicaciones: como un botón junto a la barra de búsqueda y como una barra en la parte inferior de la página.
Resalta texto en una página y haz clic en el botón emergente Add to assistant para abrir el panel de chat del assistant y agregar el texto resaltado como contexto. Puedes agregar varios fragmentos de texto o bloques de código al contexto del assistant.
Haz clic en el botón Ask AI dentro de un bloque de código para abrir el panel de chat del assistant y agregar ese bloque de código como contexto. Puedes agregar varios bloques de código o fragmentos de texto al contexto del assistant.
Estructura tu documentación para ayudar al assistant a ofrecer respuestas precisas y relevantes. Una organización clara y un contexto completo benefician tanto a los lectores humanos como a la comprensión de la IA.
Estructura y organización
Usa marcado semántico.
Escribe encabezados descriptivos para las secciones.
Crea una jerarquía de información lógica.
Usa un formato coherente en toda tu documentación.
Incluye metadata completa en el frontmatter de la página.
Divide los bloques largos de texto en párrafos más cortos.
Contexto
Define términos específicos y siglas la primera vez que se mencionen.
Proporciona contenido conceptual suficiente sobre funciones y procedimientos.
Incluye ejemplos y casos de uso.
Incluye referencias cruzadas a temas relacionados.
Agrega hidden pages con contexto adicional que los usuarios no necesitan, pero que el assistant puede usar como referencia.
Revisa y exporta consultas en tu dashboard para entender cómo las personas interactúan con tu documentación e identificar oportunidades de mejora. Algunas maneras en las que analizar las consultas puede ayudarte a mejorar tu documentación:
Identificar brechas de contenido donde las consultas frecuentes reciben respuestas insuficientes.
Descubrir patrones de comportamiento de los usuarios y necesidades de información comunes a partir de los temas y patrones en las consultas.
Priorizar las páginas con mayor tráfico para mejoras de precisión y calidad.
Puedes explorar las consultas desde tu dashboard, pero para obtener información más detallada recomendamos exportar un archivo CSV con tus consultas, respuestas y fuentes para analizarlo con tu herramienta de IA preferida.
La pestaña Categorías utiliza modelos de lenguaje (LLM) para categorizar conversaciones automáticamente. Las categorías muestran un resumen del tema o la temática, cuándo se hizo por última vez una pregunta sobre la categoría y cuántas preguntas se han hecho sobre la categoría a lo largo del tiempo.Usa las categorías para identificar temas comunes, patrones en las necesidades y el comportamiento de los usuarios, y áreas donde la documentación podría necesitar ampliarse o aclararse.Haz clic en una fila de categoría para expandirla y ver las conversaciones relacionadas agrupadas bajo esa categoría. La vista expandida muestra:
Una lista de conversaciones relacionadas con la categoría.
El primer mensaje del usuario de cada conversación.
El número de mensajes en cada hilo de conversación.
Haz clic en una conversación individual para ver todo el hilo del chat, incluida la pregunta del usuario, la respuesta del assistant y cualquier fuente citada.
La pestaña Historial de chat muestra un registro cronológico de todas las conversaciones con el assistant. Haz clic en cualquier mensaje para ver el hilo de chat completo, incluida la pregunta del usuario, la respuesta del assistant y cualquier fuente citada.
Si la interfaz del assistant no es visible en determinados navegadores, puede que tengas que enviar un informe de falso positivo a EasyList. Los navegadores que usan la lista EasyList Cookies, como Brave y Comet, a veces bloquean el assistant u otros elementos de la interfaz. La lista EasyList Cookies incluye una regla específica por dominio que oculta elementos fijos en ciertos dominios para bloquear banners de cookies. Esta regla afecta de forma involuntaria a componentes legítimos de la interfaz.Envía un informe de falso positivo a EasyList para solicitar que se elimine la regla. Esto resuelve el problema para todos los usuarios cuando se actualiza la lista de filtros.
