> ## Documentation Index
> Fetch the complete documentation index at: https://adminroletesting-justin-client-exports.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Assistant

> Agrega un asistente de chat con IA a tu documentación que responde preguntas, cita fuentes y genera ejemplos de código bajo demanda.

<Info>
  El assistant está activado por defecto. Las organizaciones Hobby reciben 5,000 créditos de prueba compartidos entre el assistant, los agentes y las automatizaciones. [Compra el paquete de créditos](/es/credits#credit-bundle) para continuar después de la prueba.
</Info>

<div id="about-the-assistant">
  ## Acerca del assistant
</div>

El assistant responde preguntas sobre tu documentación mediante consultas en lenguaje natural. Los usuarios acceden al assistant en tu sitio de documentación, para que puedan encontrar respuestas rápidamente y tener éxito con tu producto incluso si no saben dónde buscar.

El assistant utiliza llamadas a herramientas para responder preguntas. Cuando los usuarios hacen preguntas, el assistant:

* **Busca y recupera** contenido relevante de tu documentación en formato Markdown para proporcionar respuestas precisas.
* **Construye contexto** a partir de la página que el usuario está viendo cuando hace preguntas.
* **Cita fuentes** y proporciona enlaces navegables para llevar a los usuarios directamente a las páginas referenciadas.
* **Devuelve información detallada de la API** al responder preguntas sobre tu API, incluyendo métodos, parámetros, cuerpos de solicitud y esquemas de respuesta de tus especificaciones OpenAPI.
* **Genera ejemplos de código copiables** para ayudar a los usuarios a implementar soluciones desde tu documentación.
* **Soporta múltiples modalidades** permitiendo a los usuarios agregar texto, imágenes y otros archivos como contexto.

<div id="how-indexing-works">
  ### Cómo funciona la indexación
</div>

El assistant indexa tu documentación publicada y especificaciones de API para responder preguntas con precisión. Cuando publicas cambios, el assistant indexa inmediatamente el contenido nuevo, actualizado o eliminado. El assistant no indexa ramas de borrador ni despliegues de vista previa.

Por defecto, el assistant no indexa páginas ocultas. Para incluir páginas ocultas en el índice del assistant, establece `seo.indexing: "all"` en tu `docs.json`. Consulta [Páginas ocultas](/es/organize/hidden-pages#search-seo-and-ai-indexing) para más información.

<div id="how-the-assistant-handles-unknown-questions">
  ### Cómo el assistant maneja preguntas desconocidas
</div>

El assistant solo responde preguntas basándose en la información de tu documentación. Si no puede encontrar información relevante después de buscar, responde que no tiene suficiente información para contestar.

Puedes [configurar un correo de derivación](/es/assistant/configure#set-deflection-email) para que el assistant proporcione tu correo de soporte a los usuarios cuyas preguntas no puede responder. Esto da a los usuarios un camino a seguir, incluso si la documentación no aborda su pregunta específica.

<div id="assistant-insights">
  ## Información del assistant
</div>

Usa la información del assistant para entender cómo los usuarios interactúan con tu documentación e identificar oportunidades de mejora.

La [página del assistant](https://dashboard.mintlify.com/products/assistant) muestra las tendencias de uso del mes actual. Consulta información más detallada en la página de [analíticas](/es/optimize/analytics#assistant).

<div id="make-content-ai-ingestible">
  ## Haz que el contenido sea procesable por IA
</div>

Estructura tu documentación para ayudar al assistant a proporcionar 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.

<Card title="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 consistente en toda tu documentación.
  * Incluye metadatos completos en el frontmatter de las páginas.
  * Divide bloques largos de texto en párrafos más cortos.
</Card>

<Card title="Contexto">
  * Define términos específicos y acrónimos cuando se introducen por primera vez.
  * Proporciona suficiente contenido conceptual sobre funcionalidades y procedimientos.
  * Incluye ejemplos y casos de uso.
  * Haz referencias cruzadas a temas relacionados.
  * Agrega [páginas ocultas](/es/organize/hidden-pages) con contexto adicional que los usuarios no necesitan, pero que el assistant puede consultar.
</Card>