Assistant

Añade un chat con IA a tu documentación que responde preguntas, cita fuentes y genera ejemplos de código.

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

​

Acerca del assistant

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.

​

Configura el asistente

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.

​

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 activarla en tu sitio de documentación, contacta a nuestro equipo de ventas.

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

• Los sitios deben ser de acceso público.
• Los sitios que requieren JavaScript para cargarse no son compatibles.

Usa la siguiente sintaxis de filtrado para tener un control más preciso sobre lo que el assistant puede buscar:

• Filtrado a nivel de dominio
  • example.com: Busca solo en el dominio example.com
  • docs.example.com: Busca solo en el subdominio docs.example.com
  • *.example.com: Busca todos los subdominios de example.com
• Filtrado a nivel de ruta
  • docs.example.com/api: Busca todas las páginas bajo la subruta /api
• Múltiples patrones
  • Agrega varias entradas para cubrir secciones diferentes 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.

​

Usa el assistant

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.

​

Ubicación en la interfaz de usuario

Según cómo configures la ubicación de tu assistant, este aparece como un botón junto a la barra de búsqueda o como una barra en la parte inferior de la página.

Botón del assistant junto a la barra de búsqueda.

Botón del assistant en la parte inferior de la página.

​

Atajo de teclado

Usa el atajo de teclado Command + I en macOS y Ctrl + I en Windows para abrir el panel de chat del assistant.

​

Resaltar texto

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.

​

Bloques de código

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.

​

URLs

Agrega ?assistant=open a una URL para abrir el assistant al cargar la página. Por ejemplo, https://mintlify.com/docs?assistant=open.

​

Haz 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 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.

​

Exportar y analizar consultas

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.

1. Navega a la página del assistant en tu dashboard.
2. Haz clic en Chat history.
3. Haz clic en Export to CSV.
4. Analiza los datos exportados usando tu herramienta preferida.

Prompts de análisis de ejemplo

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

​

Información del assistant

Usa las percepciones del assistant para entender cómo interactúan los usuarios con tu documentación en dos vistas: categorías e historial de chat.

​

Categorías

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 categoría para ver conversaciones específicas sobre esa categoría. Luego puedes hacer clic en conversaciones individuales para ver todo el hilo del chat, incluida la pregunta del usuario, la respuesta del assistant y cualquier fuente citada.

​

Historial de chat

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.

​

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.