Usar el assistant

Abre el assistant con atajos de teclado, texto resaltado, bloques de código, archivos adjuntos o parámetros de URL, y pruébalo en local.

Los usuarios tienen múltiples formas de iniciar una conversación con el assistant. Cada método abre un panel de chat en el lado derecho de tu documentación. Los usuarios pueden hacer cualquier pregunta y el assistant busca en tu documentación una respuesta. Si el assistant no puede recuperar información relevante, responde que no puede contestar la pregunta.

​

Usar el assistant en la previsualización local

El assistant está disponible en tu previsualización local cuando inicias sesión con la CLI. Esto te permite probar el comportamiento del assistant, las instrucciones personalizadas en Assistant.md y las respuestas mientras desarrollas documentación localmente.

1. Si aún no lo has hecho, instala la CLI con npm i -g mint.
2. Ejecuta mint login para autenticarte.
3. Ejecuta mint dev para iniciar la previsualización local.

El assistant en la previsualización local usa el mismo contenido indexado que tu sitio de documentación desplegado.

​

Ubicación en la interfaz

El assistant aparece en dos ubicaciones: como un botón junto a la barra de búsqueda y como una barra en la parte inferior de la página.

​

Atajo de teclado

Abre el panel de chat del assistant con el atajo de teclado Command + I en macOS y Ctrl + I en Windows.

​

Parámetros de URL

Abre el assistant desde cualquier página de tu sitio de documentación añadiendo el parámetro de consulta ?assistant a la URL. Úsalo para crear enlaces directos al assistant desde contenido externo como correos, respuestas de soporte, banners en la aplicación o flujos de incorporación.

• ?assistant: Abre el panel de chat del assistant sin enviar ningún mensaje.
• ?assistant=<mensaje>: Abre el panel de chat del assistant y envía <mensaje> como el primer mensaje del usuario. Codifica el valor en URL para que los espacios y caracteres especiales se conserven en la solicitud.

Ejemplos

https://yourdocs.mintlify.site/quickstart?assistant
https://yourdocs.mintlify.site/quickstart?assistant=How%20do%20I%20get%20started%3F

​

Resaltar texto

Resalta texto en una página y haz clic en el botón emergente Add to assistant para abrir el panel de chat del assistant y agregar el texto resaltado como contexto. Puedes agregar múltiples fragmentos de texto o bloques de código al contexto del assistant.

​

Bloques de código

Haz clic en el botón Preguntar al asistente en un bloque de código para abrir el panel de chat del assistant y agregar el bloque de código como contexto. Puedes agregar múltiples bloques de código o fragmentos de texto al contexto del assistant.

​

Archivos adjuntos

Adjunta archivos a los mensajes del assistant para proporcionar contexto adicional.

Tipos de archivo compatibles:

• Imágenes: JPEG, PNG, GIF, WebP, SVG
• Documentos: PDF
• Archivos de código y texto: JavaScript (.js, .jsx, .mjs, .cjs), TypeScript (.ts, .tsx), Python, HTML, CSS, Markdown, MDX, JSON, YAML, XML, SQL, CSV, texto plano, scripts de shell (.sh, .bash, .env), GraphQL, TOML, Go, Rust, Ruby, Java, Kotlin, Swift, C (.c, .h), C++ (.cpp, .hpp), C#, PHP, Lua, R, Scala

Límites:

• Tamaño máximo de archivo: 5 MB por adjunto
• Máximo de adjuntos por mensaje: 10

​

Solución de problemas

La barra de chat del assistant no es visible

Si la interfaz del assistant no es visible en ciertos navegadores, es posible que necesites enviar un reporte de falso positivo a EasyList. Los navegadores que usan EasyList Cookies List, como Brave y Comet, a veces bloquean el assistant u otros elementos de la interfaz. EasyList Cookies List incluye una regla específica de dominio que oculta elementos fijos en ciertos dominios para bloquear banners de cookies. Esta regla afecta inadvertidamente a componentes legítimos de la interfaz.

Envía un reporte de falso positivo a EasyList para solicitar la eliminación de la regla. Esto resuelve el problema para todos los usuarios una vez que se actualice la lista de filtros.

Assistant bloqueado en una red corporativa, VPN o firewall

Si el assistant se carga en redes personales pero falla en una red del trabajo, VPN u otra red restringida, el bloqueo está ocurriendo a nivel de red y no en el sitio de documentación. Los proxies corporativos, las VPN y los firewalls a veces bloquean las solicitudes salientes que el assistant necesita hacer, por lo que el panel de chat no puede conectarse aunque el resto del sitio se cargue con normalidad.

Para lectores: Pídele a tu equipo de TI que permita solicitudes HTTPS salientes a los siguientes hosts desde tu red. Si puedes, prueba el assistant desde una red personal para confirmar que el problema es específico de la red.

• leaves.mintlify.com — API del assistant
• *.mintlify.dev — streaming del assistant y servicios de soporte
• *.mintlify.com — dashboard, API y analíticas
• hcaptcha.com y *.hcaptcha.com — verificación CAPTCHA para el assistant

Para propietarios del sitio: Si un lector informa que el assistant no se carga en su red corporativa o VPN, casi siempre se trata de un bloqueo de red saliente y no de un problema con tu documentación. Indícale los hosts anteriores y sugiérele que comparta la lista con su equipo de TI. Se trata de una lista de permitidos a nivel de red que se aplica al dispositivo o la red del visitante, no algo que puedas configurar desde tu sitio. Si tu documentación está autoalojada detrás de un proxy inverso que sobrescribe la CSP predeterminada, consulta Configuración de CSP para conocer los dominios que debes permitir.