|
| 1 | +--- |
| 2 | +title: "Assistant" |
| 3 | +description: "Ayuda a los usuarios a tener éxito con tu producto y a encontrar respuestas más rápido" |
| 4 | +--- |
| 5 | + |
| 6 | +<Info> |
| 7 | + El assistant se habilita automáticamente en los [planes Pro y Custom](https://mintlify.com/pricing?ref=assistant). |
| 8 | +</Info> |
| 9 | + |
| 10 | +<div id="about-the-assistant"> |
| 11 | + ## Acerca del assistant |
| 12 | +</div> |
| 13 | + |
| 14 | +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. |
| 15 | + |
| 16 | +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: |
| 17 | + |
| 18 | +* **Busca y recupera** contenido relevante de tu documentación para ofrecer respuestas precisas. |
| 19 | +* **Cita las fuentes** y proporciona enlaces navegables que llevan a los usuarios directamente a las páginas de referencia. |
| 20 | +* **Genera ejemplos de código copiables** para ayudar a los usuarios a implementar soluciones a partir de tu documentación. |
| 21 | + |
| 22 | +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. |
| 23 | + |
| 24 | +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: |
| 25 | + |
| 26 | +* Preguntas frecuentes que podrían necesitar mejor cobertura. |
| 27 | +* Brechas de contenido donde los usuarios tienen dificultades para encontrar respuestas. |
| 28 | +* Temas populares que podrían beneficiarse de contenido adicional. |
| 29 | + |
| 30 | +<div id="configuring-the-assistant"> |
| 31 | + ## Configuración del assistant |
| 32 | +</div> |
| 33 | + |
| 34 | +El assistant está habilitado de forma predeterminada para los planes Pro y Custom. Puedes gestionar el assistant desde tu [dashboard](https://dashboard.mintlify.com/products/assistant/settings), incluido activarlo o desactivarlo, configurar el manejo de respuestas y establecer un límite de gasto. |
| 35 | + |
| 36 | +<div id="assistant-status"> |
| 37 | + ### Estado del assistant |
| 38 | +</div> |
| 39 | + |
| 40 | +Activa o desactiva el assistant para habilitarlo o deshabilitarlo en tu sitio de documentación. |
| 41 | + |
| 42 | +<div id="assistant-deflection"> |
| 43 | + ### Desvío del assistant |
| 44 | +</div> |
| 45 | + |
| 46 | +Permite que el assistant redirija las preguntas sin respuesta a tu equipo de soporte. Proporciona una dirección de correo electrónico que el assistant facilitará a los usuarios que hagan preguntas que no pueda responder. |
| 47 | + |
| 48 | +<div id="search-sites"> |
| 49 | + ### Buscar sitios |
| 50 | +</div> |
| 51 | + |
| 52 | +<Note> |
| 53 | + La búsqueda del sitio está en beta. Para habilitarla en tu sitio de documentación, [contacta a nuestro equipo de ventas ](mailto:[email protected]). |
| 54 | +</Note> |
| 55 | + |
| 56 | +Configura los sitios que el assistant puede consultar para obtener contexto adicional al responder preguntas. |
| 57 | + |
| 58 | +* Los sitios deben ser públicamente accesibles. |
| 59 | +* No se admiten sitios que requieran JavaScript para cargarse. |
| 60 | + |
| 61 | +Puedes usar la siguiente sintaxis de filtrado cuando configures sitios externos: |
| 62 | + |
| 63 | +* **Filtrado a nivel de domain** |
| 64 | + * `example.com`: Buscar solo el domain `example.com` |
| 65 | + * `docs.example.com`: Buscar solo el subdomain `docs.example.com` |
| 66 | + * `*.example.com`: Buscar todos los subdomains de `example.com` |
| 67 | +* **Filtrado a nivel de ruta** |
| 68 | + * `docs.example.com/api`: Buscar todas las páginas dentro de la subruta `/api` |
| 69 | +* **Múltiples patrones** |
| 70 | + * Agrega varias entradas para dirigirte a diferentes secciones de los sitios |
| 71 | + |
| 72 | +<div id="spend-limit"> |
| 73 | + ### Límite de gasto |
| 74 | +</div> |
| 75 | + |
| 76 | +Define un límite de gasto para controlar qué sucede si llegas a tu cupo de mensajes. De forma predeterminada, el assistant seguirá respondiendo preguntas de los usuarios después de alcanzar tu cupo de mensajes, lo que generará cargos por excedente. |
| 77 | + |
| 78 | +En la pestaña **Billing** de la página [Assistant Configurations](https://dashboard.mintlify.com/products/assistant/settings), puedes establecer un límite de gasto para los mensajes del assistant más allá de tu cupo. Cuando alcanzas tu límite de gasto, el assistant se desactiva hasta que se restablece tu cupo de mensajes. |
| 79 | + |
| 80 | +También puedes configurar alertas de uso para recibir un correo electrónico cuando alcances un porcentaje determinado de tu límite de gasto. |
| 81 | + |
| 82 | +<div id="using-the-assistant"> |
| 83 | + ## Uso del assistant |
| 84 | +</div> |
| 85 | + |
| 86 | +Los usuarios pueden acceder al assistant de tres maneras: |
| 87 | + |
| 88 | +* **Atajo de teclado**: <kbd>Command</kbd> + <kbd>I</kbd> (<kbd>Ctrl</kbd> + <kbd>I</kbd> en Windows) |
| 89 | +* **Botón del assistant** junto a la barra de búsqueda |
| 90 | + <img |
| 91 | + src="/images/assistant/assistant-button-light.png" |
| 92 | + className="block dark:hidden rounded-2xl border border-gray-100 shadow-lg" |
| 93 | + style={{ |
| 94 | + width: '268px', |
| 95 | + height: 'auto', |
| 96 | + }} |
| 97 | + alt="Barra de búsqueda y botón del assistant en modo claro." |
| 98 | + /> |
| 99 | + <img |
| 100 | + src="/images/assistant/assistant-button-dark.png" |
| 101 | + className="hidden dark:block rounded-2xl border border-white/10 shadow-lg" |
| 102 | + style={{ |
| 103 | + width: '268px', |
| 104 | + height: 'auto', |
| 105 | + }} |
| 106 | + alt="Barra de búsqueda y botón del assistant en modo oscuro." |
| 107 | + /> |
| 108 | +* **URL** con `?assistant=open` añadida abrirá el assistant cuando cargue la página. Por ejemplo, [https://mintlify.com/docs?assistant=open](https://mintlify.com/docs?assistant=open). |
| 109 | + |
| 110 | +Estos métodos abren 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 se encuentra información relevante, el assistant indicará que no puede responder la pregunta. |
| 111 | + |
| 112 | +<div id="making-content-ai-ingestible"> |
| 113 | + ## Hacer que el contenido sea apto para la IA |
| 114 | +</div> |
| 115 | + |
| 116 | +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. |
| 117 | + |
| 118 | +<Card title="Estructura y organización"> |
| 119 | + * Usa marcado semántico. |
| 120 | + * Escribe encabezados descriptivos para las secciones. |
| 121 | + * Crea una jerarquía lógica de la información. |
| 122 | + * Mantén un formato consistente en toda tu documentación. |
| 123 | + * Incluye metadata completa en el frontmatter de la página. |
| 124 | + * Divide los bloques largos de texto en párrafos más cortos. |
| 125 | +</Card> |
| 126 | + |
| 127 | +<Card title="Contexto"> |
| 128 | + * Define términos y siglas específicos la primera vez que se mencionen. |
| 129 | + * Proporciona suficiente contenido conceptual sobre funciones y procedimientos. |
| 130 | + * Incluye ejemplos y casos de uso. |
| 131 | + * Añade referencias cruzadas a temas relacionados. |
| 132 | + * Agrega [páginas ocultas](/es/organize/hidden-pages) con contexto adicional que los usuarios no necesitan, pero que el assistant puede consultar. |
| 133 | +</Card> |
| 134 | + |
| 135 | +<div id="exporting-and-analyzing-queries"> |
| 136 | + ## Exportar y analizar consultas |
| 137 | +</div> |
| 138 | + |
| 139 | +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: |
| 140 | + |
| 141 | +* Identifica brechas de contenido donde las consultas frecuentes reciben respuestas insuficientes. |
| 142 | +* Descubre patrones de comportamiento de los usuarios y necesidades de información comunes a partir de temas y patrones en las consultas. |
| 143 | +* Prioriza las páginas de alto tráfico para mejorar su precisión y calidad. |
| 144 | + |
| 145 | +Puedes explorar las consultas desde tu [dashboard](https://dashboard.mintlify.com/products/assistant), 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. |
| 146 | + |
| 147 | +1. Ve a la [página del assistant](https://dashboard.mintlify.com/products/assistant) en tu dashboard. |
| 148 | +2. Selecciona **Export to CSV**. |
| 149 | +3. Analiza los datos exportados con tu herramienta preferida. |
| 150 | + |
| 151 | +<Card title="Ejemplos de prompts de análisis"> |
| 152 | + * Resume los temas más comunes de las consultas. |
| 153 | + * Enumera las consultas que no tengan fuentes citadas. |
| 154 | + * Encuentra patrones en las interacciones fallidas. |
| 155 | +</Card> |
0 commit comments