Saltar al contenido principal
El Asistente se habilita automáticamente en los planes Pro y Custom.

​
Acerca del asistente

El Asistente responde preguntas sobre tu documentación mediante consultas en lenguaje natural. Está integrado directamente en tu sitio de documentación, brindando a los usuarios acceso inmediato a ayuda contextual. El Asistente utiliza RAG agentivo (generación aumentada por recuperación) con llamadas a herramientas, impulsado por Claude Sonnet 4. Cuando los usuarios hacen preguntas, el Asistente:
  • 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 para copiar que ayudan a los usuarios a implementar soluciones a partir de tu documentación.
Cada mensaje enviado al Asistente cuenta para el cupo de mensajes de tu plan. Si superas tu cupo, los mensajes adicionales generarán cargos por excedente. Puedes establecer límites de gasto o desactivar el Asistente si alcanzas tu cupo de mensajes. Puedes ver el uso del Asistente en tu panel para comprender el comportamiento de los usuarios y la efectividad de la documentación. Exporta y analiza los datos de las consultas para ayudar a identificar:
  • Preguntas frecuentes que podrían necesitar mejor cobertura.
  • Vacíos de contenido donde los usuarios tienen dificultades para encontrar respuestas.
  • Temas populares que podrían beneficiarse de contenido adicional.

​
Configuración del asistente

El Asistente está habilitado de forma predeterminada para los planes Pro y Custom. Puedes administrarlo desde tu panel, donde puedes activarlo o desactivarlo, configurar el manejo de respuestas y establecer un límite de gasto.

​
Estado del Asistente

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

​
Desvío del Asistente

Permite que el Asistente redirija las preguntas sin respuesta a tu equipo de soporte. Proporciona una dirección de correo electrónico que el Asistente compartirá con los usuarios que hagan preguntas a las que no pueda 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.
Configura los sitios que el Asistente puede consultar para obtener contexto adicional al responder preguntas.
  • Los sitios deben ser de acceso público.
  • Los sitios que requieren JavaScript para cargar no son compatibles.
Puedes usar la siguiente sintaxis de filtrado al configurar sitios externos:
  • 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 todos los subdominios de example.com
  • Filtrado a nivel de ruta
    • docs.example.com/api: Buscar todas las páginas bajo la subruta /api
  • Varios patrones
    • Agrega varias entradas para apuntar a diferentes secciones de los sitios

​
Límite de gasto

Establece un límite de gasto para controlar qué sucede si alcanzas tu cupo de mensajes. De forma predeterminada, el Asistente seguirá respondiendo preguntas de los usuarios después de que alcances tu cupo, lo que genera cargos por excedente. En la pestaña Billing de la página Assistant Configurations, puedes establecer un límite de gasto para los mensajes del Asistente que superen tu cupo. Cuando alcanzas tu límite de gasto, el Asistente se deshabilita hasta que tu cupo de mensajes se restablezca. También puedes configurar alertas de uso para recibir un correo electrónico cuando alcances un porcentaje determinado de tu límite de gasto.

​
Uso del Asistente

Los usuarios pueden acceder al Asistente de tres maneras:
  • Atajos de teclado: ? o Command + I (Ctrl + I en Windows)
  • Botón del Asistente junto a la barra de búsqueda Barra de búsqueda y botón del Asistente en modo claro.
  • URLs con ?assistant=open al final abrirán el Asistente cuando cargue la página. Por ejemplo, https://mintlify.com/docs?assistant=open.
Todos los métodos abren un panel de chat en el lado derecho de tu documentación. Los usuarios pueden hacer cualquier pregunta y el Asistente buscará en tu documentación una respuesta. Si no se encuentra información relevante, el Asistente responderá que no puede responder la pregunta.

​
Hacer que el contenido sea apto para la ingesta por IA

Estructura tu documentación para ayudar al Asistente a ofrecer respuestas precisas y relevantes. Una organización clara y un contexto completo benefician tanto a las personas lectoras 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 información.
  • Usa un formato coherente en toda tu documentación.
  • Incluye metadatos completos 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íficas la primera vez que aparezcan.
  • Proporciona suficiente contenido conceptual sobre funcionalidades y procedimientos.
  • Incluye ejemplos y casos de uso.
  • Crea referencias cruzadas a temas relacionados.
  • Agrega páginas ocultas con contexto adicional que las personas usuarias no necesitan, pero a las que el Asistente puede recurrir.

​
Exportar y analizar consultas

Revisa y exporta consultas desde tu panel 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 los temas y patrones en las consultas.
  • Prioriza las páginas con mayor tráfico para mejorar su precisión y calidad.
Puedes explorar consultas desde tu panel, pero para obtener información más sólida te recomendamos exportar un archivo CSV con tus consultas, respuestas y fuentes para analizarlo con tu herramienta de IA preferida.
  1. Ve a la página del Asistente en tu panel.
  2. Selecciona Export to CSV.
  3. Analiza los datos exportados con tu herramienta preferida.

Sample analysis prompts

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