Assistant

Ayuda a los usuarios a tener éxito con tu producto y a encontrar respuestas más rápido

El assistant se habilita automáticamente en los planes Pro y Custom.

​

Acerca del assistant

El assistant responde preguntas sobre tu documentación mediante búsquedas en lenguaje natural. Está integrado directamente en tu sitio de documentación y ofrece a los usuarios acceso inmediato a ayuda contextual.

El assistant utiliza RAG agentivo (generación aumentada por recuperación) con llamadas a herramientas, impulsado por Claude Sonnet 4. Cuando los usuarios hacen preguntas, el assistant:

• Busca y recupera contenido relevante de tu documentación para ofrecer respuestas precisas.
• Cita las fuentes y proporciona enlaces navegables que llevan a los usuarios directamente a las páginas de referencia.
• Genera ejemplos de código copiables para ayudar a los usuarios a implementar soluciones a partir de tu documentación.

Cada mensaje enviado al assistant cuenta para la cuota de mensajes de tu plan. Si superas tu cuota, los mensajes adicionales generarán cargos por excedente. Puedes establecer límites de gasto o desactivar el assistant si alcanzas tu cuota de mensajes.

Puedes ver el uso del assistant desde tu dashboard para comprender el comportamiento de los usuarios y la efectividad de la documentación. Exporta y analiza los datos de búsqueda para identificar:

• Preguntas frecuentes que podrían necesitar mejor cobertura.
• Brechas de contenido donde los usuarios tienen dificultades para encontrar respuestas.
• Temas populares que podrían beneficiarse de contenido adicional.

​

Configuración del assistant

El assistant está habilitado de forma predeterminada para los planes Pro y Custom.

Administra el assistant desde tu dashboard. Haz clic en Configuration para habilitar o deshabilitar el assistant, configurar el manejo de respuestas, agregar preguntas predeterminadas y establecer un límite de gasto.

​

Activar o desactivar el assistant

Alterna el estado del assistant para habilitarlo o deshabilitarlo en tu sitio de documentación.

​

Ubicación del control

Selecciona dónde aparece el assistant en tu sitio de documentación. Elige entre una burbuja de chat flotante en la parte inferior de la página o un botón junto a la barra de búsqueda.

​

Configurar el correo de desvío

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.

​

Búsqueda en sitios

La búsqueda en sitios está en beta. Para habilitarla en tu sitio de documentación, contacta a nuestro equipo de ventas.

En la sección de gestión de respuestas, configura los sitios que el assistant puede consultar para obtener contexto adicional al responder preguntas.

• Los sitios deben ser de acceso público.
• No se admiten sitios que requieran JavaScript para cargarse.

Usa la siguiente sintaxis de filtrado para controlar con mayor precisión lo que el assistant puede buscar:

• Filtrado a nivel de dominio
  • example.com: Buscar solo en el dominio example.com
  • docs.example.com: Buscar solo en el subdominio docs.example.com
  • *.example.com: Buscar en todos los subdominios de example.com
• Filtrado a nivel de ruta
  • docs.example.com/api: Buscar todas las páginas bajo la subruta /api
• Patrones múltiples
  • Agrega varias entradas para dirigirte a diferentes secciones de los sitios

​

Agregar preguntas de ejemplo

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.

​

Establecer un límite de gasto

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.

1. Selecciona la pestaña Billing.

2. Establece un límite de gasto para los mensajes del assistant que excedan tu cupo.
3. Configura alertas de uso para recibir un correo electrónico cuando alcances un determinado porcentaje de tu límite de gasto.

​

Uso del assistant

Los usuarios pueden acceder al assistant de tres maneras:

• Atajo de teclado: Command + I (Ctrl + I en Windows)
• Botón del assistant junto a la barra de búsqueda
• URL con ?assistant=open añadida abre el assistant cuando se carga la página. Por ejemplo, https://mintlify.com/docs?assistant=open.

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 buscará en tu documentación una respuesta. Si no encuentra información relevante, el assistant responderá que no puede responder la pregunta.

​

Hacer que el contenido sea apto para la IA

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 lógica de la información.
• Mantén un formato consistente 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 y siglas específicos la primera vez que se mencionen.
• Proporciona suficiente contenido conceptual sobre funciones y procedimientos.
• Incluye ejemplos y casos de uso.
• Añade referencias cruzadas a temas relacionados.
• Agrega páginas ocultas con contexto adicional que los usuarios no necesitan, pero que el assistant puede consultar.

​

Exportar y analizar consultas

Revisa y exporta consultas desde tu dashboard para entender cómo las personas interactúan con tu documentación e identificar oportunidades de mejora. Algunas maneras en que el análisis de consultas puede ayudarte a mejorar tu documentación:

• Identifica brechas de contenido donde las consultas frecuentes reciben respuestas insuficientes.
• Descubre patrones de comportamiento de los usuarios y necesidades de información comunes a partir de temas y patrones en las consultas.
• Prioriza las páginas de alto tráfico para mejorar su precisión y calidad.

Puedes explorar las consultas desde tu dashboard, pero para obtener insights más potentes te recomendamos exportar un archivo CSV con tus consultas, respuestas y fuentes para analizarlas con tu herramienta de IA preferida.

1. Ve a la página del assistant en tu dashboard.
2. Selecciona Export to CSV.
3. Analiza los datos exportados con tu herramienta preferida.

Ejemplos de prompts de análisis

• Resume los temas más comunes de las consultas.
• Enumera las consultas que no tengan fuentes citadas.
• Encuentra patrones en las interacciones fallidas.

​

Solución de problemas

La barra de chat del assistant no es visible

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.