mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
Kyle Finken
73 lines
4.6 KiB
Plaintext
73 lines
4.6 KiB
Plaintext
---
|
|
title: "Assistant"
|
|
description: "Agrega un asistente de chat con IA a tu documentación que responde preguntas, cita fuentes y genera ejemplos de código bajo demanda."
|
|
keywords: ["chat", "soporte al usuario", "multimodal"]
|
|
boost: 3
|
|
---
|
|
|
|
<Info>
|
|
El assistant está disponible en el [plan Pro y superiores](https://mintlify.com/pricing?ref=assistant). Todos los planes Pro incluyen 10,000 créditos al mes compartidos entre el assistant, el agente y las automatizaciones. Consulta [Gestionar la facturación](/es/assistant/configure#manage-billing) para obtener más información sobre los niveles y las opciones de créditos.
|
|
</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>
|