Saltar al contenido principal
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.

​
Abrir el agente

Solo los editors y admins pueden abrir el agente.
Haga clic en Ask agent en la barra de herramientas del editor o presione Cmd + J (macOS) o Ctrl + J (Windows). 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. Para chatear con el agente en una página completa, haga clic en el botón Agent de la barra de navegación.
Captura de pantalla del agente en una página completa en modo claroCaptura de pantalla del agente en una página completa en modo oscuro
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"
Si una decisión pendiente cambiaría sustancialmente el resultado, el agente se detiene y le hace hasta cuatro preguntas en el panel de chat. Seleccione una opción sugerida o escriba su propia respuesta.

​
Elegir un modelo y el nivel de esfuerzo

Haga clic en el nombre del modelo en el cuadro de chat para cambiar el modelo que usa el agente y cuánto esfuerzo dedica a una respuesta.
  • Modelo: Busque un modelo o elija uno de las listas Suggested u Other models.
  • Esfuerzo: Elija un nivel de esfuerzo más alto para solicitudes complejas o uno más bajo para obtener respuestas más rápidas. Los niveles disponibles dependen del modelo, y algunos modelos no admiten niveles de esfuerzo.
Cambiar de modelo a mitad de un chat puede reducir la calidad y la velocidad de las respuestas, así que inicie un chat nuevo cuando cambie de modelo. Si su proyecto usa su propio modelo, el agente siempre usa el modelo configurado y no puede elegir uno diferente.

​
Adjuntar archivos

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.

​
Pedir comentarios y sugerencias

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.

​
Trabajar con opiniones existentes

El agente puede leer los comentarios y sugerencias abiertos de una página, incluidas las respuestas. Pídale que resuma las opiniones o que actúe en consecuencia. Por ejemplo:
  • what feedback has been left on this page?
  • apply the changes requested in the open comments
El agente solo lee los hilos sin resolver. También indica cuándo el texto comentado ya no existe en la página. Leer los comentarios no los responde ni los resuelve.

​
Revisar lo que cambió el agente

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.

​
Qué puede hacer el agente

​
Editar páginas

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.

​
Buscar y navegar por su contenido

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.

​
Ver imágenes

El agente puede ver imágenes JPEG, PNG, GIF y WebP en sus páginas. Esto incluye imágenes publicadas, imágenes que subió en su rama actual e imágenes de páginas privadas que puede abrir. Úselo para describir imágenes, escribir texto alternativo o comprobar si las capturas de pantalla coinciden con el contenido que las rodea. El agente no puede ver archivos SVG ni imágenes alojadas en otros sitios. Ejemplo: write alt text for every image on this page

​
Actualizar la navegación y docs.json

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

​
Ejecutar comandos de bash

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

​
Configurar su sitio (code mode)

Para solicitudes que van más allá de editar páginas (configurar la autenticación, gestionar workflows o cambiar los ajustes del proyecto), 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

​
Usar integraciones conectadas

Las integraciones requieren un plan Enterprise.
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.

​
Preguntar sobre sus analíticas

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

​
Leer su espacio de trabajo de Slack

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.

​
Continuar una ejecución de automatizació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.

​
Historial de sesiones

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.

​
Instrucciones de IA

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.

Temas relacionados

¿Qué es el agente?Integraciones para el agente y las automatizacionesReferencia de comandos de la CLI de Mintlify