Configurar el assistant

Configura el assistant de IA en tu dashboard de Mintlify: alterna su disponibilidad, personaliza las respuestas, agrega preguntas iniciales, establece la protección contra bots y administra la facturación.

Configura el assistant en la página Assistant de tu dashboard. Administra la facturación y el uso en la página Uso.

​

Habilitar o deshabilitar el assistant

Activa o desactiva el estado del assistant para habilitar o deshabilitar el assistant en tu sitio de documentación.

​

Configurar correo de derivación

En la sección Manejo de respuestas, habilita el assistant para redirigir preguntas sin respuesta a tu equipo de soporte.

Especifica una dirección de correo electrónico para que el assistant la proporcione a los usuarios si no puede responder su pregunta. También puedes habilitar un botón “Contactar soporte” que aparezca en el panel de chat del assistant.

​

Dominios de búsqueda

En la sección Manejo de respuestas, configura los dominios en los que el assistant puede buscar en la web para encontrar contexto adicional al responder preguntas.

• Los dominios deben ser accesibles públicamente.
• No se admiten dominios que requieran JavaScript para cargar.

Para un control más preciso sobre lo que el assistant puede buscar, usa la sintaxis de filtrado.

• 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 en todos los subdominios de example.com
• Filtrado a nivel de ruta
  • docs.example.com/api: Buscar en todas las páginas bajo la subruta /api
• Múltiples patrones
  • Agrega múltiples entradas para apuntar a diferentes secciones de sitios

​

Agregar preguntas de ejemplo

Ayuda a tus usuarios a iniciar conversaciones con el assistant agregando preguntas iniciales.

El assistant puede generar preguntas específicas de la página basándose en la página que el usuario está viendo, o puedes agregar preguntas persistentes que estén disponibles en todas las páginas.

Puedes agregar hasta tres preguntas iniciales. Haz clic en Ask AI para obtener preguntas recomendadas basadas en tu documentación.

​

Protección contra bots

En la sección Protección contra bots, habilita captcha invisible para proteger tu assistant de abusos automatizados. La protección contra bots respeta la privacidad y es invisible para casi todos los visitantes.

Para habilitar la protección contra bots:

1. Ve a la página de configuración del Assistant en tu dashboard.
2. En la sección Bot Protection, activa Invisible Captcha.

Los cambios tardan hasta 10 minutos en propagarse.

Si usas encabezados de Content Security Policy personalizados, debes incluir hcaptcha.com y *.hcaptcha.com en tu lista de permitidos.

​

Administrar la facturación

El assistant usa paquetes con asignaciones mensuales de mensajes. Un mensaje es cualquier interacción del usuario con el assistant que recibe una respuesta correcta. Si tienes mensajes sin usar, hasta la mitad de tu asignación de mensajes puede transferirse al siguiente ciclo de facturación. Por ejemplo, si tienes una asignación de 1,000 mensajes y usas 300 mensajes, 500 mensajes se transfieren al siguiente ciclo de facturación, dándote un total de 1,500 mensajes para el siguiente ciclo de facturación.

Por defecto, los excedentes están deshabilitados. Con los excedentes deshabilitados, el assistant deja de estar disponible cuando alcanzas tu asignación de mensajes y permanece no disponible hasta que tu asignación se renueve. Puedes habilitar los excedentes para mantener el assistant disponible más allá de la asignación de tu paquete. Si habilitas los excedentes, cada mensaje más allá de tu asignación incurre en un cargo por excedente, pero los excedentes ocasionales pueden ser más baratos que subir a un paquete superior, dependiendo de tu uso.

​

Habilitar el assistant en el plan Hobby

Si estás en el plan Hobby, puedes añadir el assistant a tu sitio comprando un paquete de créditos sin necesidad de pasar a Pro. El assistant se habilita en cuanto se completa la compra y permanece activo mientras tengas un paquete de créditos activo.

Para comprar un paquete de créditos en el plan Hobby:

1. Ve a la página Uso de tu dashboard.
2. En la sección Credit packages, selecciona un paquete del menú desplegable.
3. Confirma el cambio para ser redirigido al checkout.

Para detener el assistant, baja tu paquete de créditos al nivel más bajo. Tu plan vuelve a Hobby y el assistant se deshabilita al final del ciclo de facturación actual.

​

Cambiar tu paquete de assistant

Los paquetes determinan tu asignación mensual de mensajes y los precios.

Consulta y cambia tu paquete actual en la página Uso de tu dashboard. También puedes acceder a la página de Uso seleccionando View usage junto a Billing portal en la página de Facturación.

En la sección Message packages (o Credit packages para assistants basados en créditos), selecciona tu paquete preferido del menú desplegable.

Subir de paquete:

• Tu nueva asignación de mensajes está disponible inmediatamente.
• Pagas una diferencia prorrateada por el ciclo de facturación actual.

Bajar de paquete:

• Tu asignación de mensajes se actualiza inmediatamente.
• Los cambios de precio entran en vigor al inicio de tu próximo ciclo de facturación.
• Los mensajes no utilizados de tu paquete actual no se transfieren.

​

Permitir excedentes

Los excedentes están deshabilitados por defecto. Para permitir excedentes, habilítalos en la sección Billing controls de la página Uso de tu dashboard.

​

Configurar alertas de uso

En la sección Billing controls, configura alertas de uso para recibir un correo electrónico cuando alcances un cierto porcentaje de tu asignación de mensajes.