Preguntar al agente

El editor incluye un agente integrado que puede editar páginas, reorganizar la navegación, actualizar docs.json, buscar en todo su repositorio y gestionar la configuración del dashboard. El agente también está disponible en las páginas de configuración del dashboard.

El agente del editor realiza los cambios directamente en su branch actual. Al igual que sus propias ediciones, los cambios del agente se guardan automáticamente, pero no llegan a su sitio publicado hasta que los publica.

Haga clic en Ask agent en la barra de herramientas del editor o presione Cmd + I (macOS) o Ctrl + I (Windows) cuando no haya texto seleccionado. También puede abrir el agente en las páginas de configuración del dashboard. Su sesión de chat permanece abierta al moverse entre el editor y la configuración.

Escriba @ para mencionar una página concreta en un prompt y que el agente se centre en ella. Sin una mención, el agente usa la página que tiene abierta como contexto inicial. En su dashboard, el agente sabe qué página está viendo, así que puede preguntar por la página actual sin nombrarla.

Prompts de ejemplo:

• simplify the introduction page
• fix all grammar errors across my content
• add a new page that explains authentication
• rename every mention of "Acme Pro" to "Acme Team" across all pages
• update docs.json to add a new group called "Guides"

Haga clic en el icono del clip en el cuadro de chat o arrastre y suelte archivos en el panel. El agente lee los archivos adjuntos como contexto para su solicitud.

Tipos de archivo admitidos:

• Imágenes: JPG, PNG, GIF, WebP, SVG
• Documentos: PDF
• Código y texto: .js, .ts, .jsx, .tsx, .mdx, .md, .json, .yaml, .html, .css, Python, Go, Rust, Ruby, Java, Swift, C, C++, SQL, scripts de shell y más

Tamaño máximo: 5 MB por archivo, salvo los archivos SVG, que Mintlify limita a 256 KB. Máximo: 10 archivos por mensaje.

Mintlify elimina los scripts y otro contenido activo de los archivos SVG antes de que el agente los lea.

En el modo visual, seleccione un texto y haga clic en Add to agent en la barra de herramientas flotante para enviarlo al agente como contexto.

De forma predeterminada, el agente edita el contenido directamente. Para obtener opiniones sin cambiar la página de inmediato, pídale explícitamente que revise la página, deje comentarios o haga sugerencias.

• Las sugerencias proponen un reemplazo concreto que puede aceptar o rechazar. El texto original permanece visible tachado hasta que decida, y el agente puede incluir una explicación en el hilo de la sugerencia.
• Los comentarios dejan una opinión o una pregunta anclada a un texto concreto sin cambiar la página.

Prompts de ejemplo:

• review this page and leave suggestions
• comment on anything that needs more context
• suggest ways to make the introduction more concise

El agente usa la página que tiene abierta salvo que indique otra. Puede anotar el texto representado de la página, incluida la prosa dentro de los componentes. No puede anotar el frontmatter, los metadatos de la página, la configuración ni las etiquetas y atributos MDX en bruto.

Aparece una lista de archivos modificados en el chat a medida que el agente trabaja. Despliéguela para ver todos los archivos modificados en la sesión y haga clic en cualquier archivo para comparar los cambios con el original en la vista de diff.

Para revertir las ediciones del agente, haga clic en Discard changes junto a un archivo o haga clic en Discard all para descartar todos los cambios de la sesión. Para revertir los cambios de una única respuesta, haga clic en Undo changes en ese mensaje. Haga clic en Redo changes para restaurarlos.

El agente puede escribir, reescribir, ampliar y reorganizar el contenido de cualquier página. Lee su contenido existente para adaptarse a su estilo y estructura.

El agente puede buscar en todo su repositorio, no solo en la página que tiene abierta. Úselo para encontrar información, detectar incoherencias o comprobar que un contenido ya existe antes de añadirlo.

El agente puede añadir, renombrar, reordenar y eliminar elementos de navegación. Son los mismos cambios que haría manualmente en el panel de navegación. También puede actualizar la configuración de docs.json directamente, incluido añadir groups nuevos, ajustar opciones y configurar redirecciones.

Ejemplo: add a "Quickstart" group under the Getting Started tab and move the quickstart page into it

El agente puede ejecutar grep, rg y otros comandos de bash sobre su repositorio. Úselo para operaciones masivas que abarcan muchos archivos.

Ejemplo: find every page that mentions the deprecated /v1/auth endpoint

Para solicitudes que van más allá de editar páginas (configurar la autenticación, gestionar workflows o cambiar los ajustes del deployment), el agente pasa al code mode. Escribe y ejecuta un script contra su dashboard de Mintlify en su nombre.

El code mode respeta sus permisos del dashboard. Si no tiene acceso a un ajuste en el dashboard, el agente tampoco puede cambiarlo.

Prompts de ejemplo que usan code mode:

• enable JWT authentication for my site
• create a workflow that updates my site when I merge a PR
• add a custom domain

El agente del editor puede usar aplicaciones de terceros conectadas mediante Integraciones como herramientas de solo lectura mientras investiga, edita páginas o responde a sus preguntas.

• Las integraciones compartidas están disponibles para toda su organización.
• Las integraciones personales usan la cuenta conectada por el miembro del equipo que está chateando con el agente. Por ejemplo, una búsqueda en Google Drive usa su propia conexión de Drive.

Pida al agente que use una aplicación conectada de forma natural en su solicitud, por ejemplo:

• update the migration guide based on the latest Jira issue
• check what the Notion launch brief says about availability and add it to the release notes page

Si la integración que necesita aún no está conectada, pida al agente que la conecte. El agente devuelve un enlace de autorización. Complete el flujo y envíe otro mensaje para que el agente confirme la conexión y continúe.

El agente puede responder preguntas sobre los datos de tráfico, búsqueda, assistant y comentarios de su documentación. El agente devuelve la información en forma de texto, gráfico o lista clasificada. Use el agente para pedir explicaciones específicas, comparar el rendimiento entre páginas o investigar cambios en el tráfico.

Prompts de ejemplo:

• what are the top 5 user agents hitting my site?
• which pages do AI agents visit more often than humans?
• what are people searching for and not finding results for?
• graph traffic for the REST API introduction page over the last month

Si instala la aplicación de Slack de Mintlify, el agente del editor puede leer su espacio de trabajo de Slack como contexto mientras investiga o responde a sus preguntas. El agente del editor tiene acceso de solo lectura. No puede publicar mensajes, añadir reacciones ni realizar otras acciones en Slack.

Pida al agente que use Slack en una solicitud. Por ejemplo:

• check the #engineering channel for context on the new auth flow
• summarize what the team decided about rate limiting yesterday

Si no ha instalado la aplicación de Slack, pida al agente que la conecte por usted. El agente devuelve un enlace de autorización y le guía a lo largo del proceso de instalación.

Cuando abre el editor desde la notificación por Slack o correo electrónico de una automatización, el panel del agente se abre automáticamente con contexto sobre lo que hizo la automatización. Una tarjeta Updated pages en la parte superior del chat enumera todas las páginas que modificó la automatización. Haga clic en cualquier página para abrir una vista de diff.

El agente dispone del prompt de la automatización, de un resumen de los cambios que hizo y de las páginas que modificó. Puede pedirle que refine o amplíe el trabajo de la automatización sin volver a explicarle el contexto.

Por ejemplo: The new section on rate limits is too long. Trim it to three sentences.

Haga clic en el icono del reloj en el encabezado del panel para ver sus sesiones de chat anteriores. Haga clic en cualquier sesión para reabrirla y ver qué cambió el agente. Para empezar de nuevo, haga clic en New chat.

Para dar al agente directrices persistentes, como reglas de voz, terminología o convenciones de formato, configure las instrucciones de IA en la configuración del editor. El agente sigue estas instrucciones en cada solicitud sin que tenga que repetirlas.