Saltar al contenido principal
El editor incluye un agente integrado que puede editar páginas, reorganizar la navegación, actualizar docs.json, buscar en el contenido de su sitio 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 la rama del chat, que inicialmente es la rama que tiene abierta al iniciar el chat. Puede pedirle al agente que trabaje en otra rama. 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. También puede pedirle al agente que publique por usted. Los cambios que el agente realiza en la configuración del dashboard se aplican de inmediato.

​
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. 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 botón del cuadro de chat y seleccione Add attachment, 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, y responderlos. Pídale que resuma las opiniones, que actúe en consecuencia o que las responda. Por ejemplo:
  • what feedback has been left on this page?
  • apply the changes requested in the open comments
  • reply to each comment with what you changed and resolve the thread
El agente solo lee los hilos sin resolver. También indica cuándo el texto comentado ya no existe en la página. El agente también puede resolver hilos de comentarios y, cuando lo hace, le explica por qué. No puede resolver hilos de sugerencias. Para que el agente responda o resuelva un hilo, debe tener permiso para editar la página.

​
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 el contenido de su sitio, 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

​
Mencionar a compañeros de equipo y páginas

Pida al agente que mencione a un compañero de equipo o una página, y añadirá la mención al contenido de la página. El agente busca a los compañeros de su organización por nombre o por dirección de correo electrónico completa. Si un nombre coincide con más de un compañero, el agente le pregunta a cuál se refiere. Una mención de página es un enlace a una página de su sitio. Las menciones que añade el agente no envían notificaciones por correo electrónico a los compañeros mencionados.

​
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

​
Trabajar en otras ramas

Pídale al agente que liste las ramas de su repositorio, cree una rama o cambie el chat a una rama existente. Después de un cambio, el agente lee, edita y publica en la nueva rama. Cuando el agente crea una rama, la crea a partir de su rama de despliegue y le asigna el nombre del título de su pull request. Incluya un título en su prompt para elegirlo. Crear una rama no cambia el chat a esa rama, por lo que el agente cambia de rama antes de editar en ella. Cambiar de rama no mueve los cambios sin publicar. Los cambios que el agente ya realizó permanecen en la rama donde los hizo. Cambiar la rama del chat no cambia la rama que está viendo en el editor. El agente le proporciona un enlace para abrir la rama a la que cambió. El agente no puede crear ni cambiar de rama cuando la Publicación automática está activada, porque su sitio no tiene ramas. Ejemplo: create a branch called "Update quickstart" and rewrite the quickstart page there

​
Ejecutar comandos de bash

El agente puede ejecutar comandos de shell de solo lectura como grep, rg y find en el contenido de su sitio. Úselo para encontrar contenido que abarca muchos archivos. Ejemplo: find every page that mentions the deprecated /v1/auth endpoint

​
Configurar su sitio

El agente puede cambiar la configuración del dashboard por usted, como la autenticación, los dominios personalizados, la configuración de Git, los miembros y los workflows. Estos cambios se aplican a su despliegue publicado de inmediato. No esperan a que publique. El agente respeta sus permisos del dashboard. Si no puede cambiar un ajuste en el dashboard, el agente tampoco puede cambiarlo. Prompts de ejemplo:
  • enable JWT authentication for my site
  • create a workflow that updates my site when I merge a PR
  • add a custom domain

​
Investigar código y sitios web

Proporcione al agente un enlace a un repositorio de GitHub o GitLab, y leerá el código fuente mientras escribe. El agente también puede buscar en la web y leer sitios web públicos, como el sitio de marketing de su producto o documentación existente. Ejemplo: read https://github.com/acme/sdk and document the client configuration options

​
Trabajar con páginas privadas

El agente puede leer sus páginas privadas y las páginas compartidas con usted. Puede crear, mover y duplicar páginas y carpetas en Personal, y mover una página privada a su sitio cuando se lo pida.

​
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 botón Show agent history en el encabezado del panel para ver sus sesiones de chat anteriores. Las sesiones se agrupan en Today, Last 30 days y Older. Cada sesión muestra su primer mensaje como título y la hora en que comenzó.
  • Un indicador de carga reemplaza la hora mientras el agente sigue trabajando en una sesión.
  • Un punto azul y un título en negrita marcan una sesión con mensajes del agente que no ha leído.
  • Si el selector de rama está visible, las sesiones en una rama distinta de su rama de despliegue muestran el nombre de la rama.
Haga clic en cualquier sesión para reabrirla y ver qué cambió el agente. Para empezar de nuevo, haga clic en New chat. Para eliminar una sesión, pase el cursor sobre ella, haga clic en More actions, luego en Delete y confirme. No puede eliminar una sesión mientras el agente sigue trabajando en ella. Si elimina la sesión que tiene abierta, el panel inicia un nuevo 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.

​
Skills

Las skills son conjuntos reutilizables de instrucciones que el agente sigue para tipos específicos de tareas, como escribir una nota de versión o revisar una página de referencia de la API. El agente ve el nombre y la descripción de cada skill activada y solo carga las instrucciones completas de una skill cuando su solicitud coincide con ella. Use las instrucciones de IA para directrices que se aplican a todas las solicitudes. Administre las skills en la página Skills de la configuración de su organización. La página tiene dos secciones:
  • Organization: Skills disponibles para todos los miembros de su organización. Los administradores pueden agregar y administrar las skills de la organización. Los editores y lectores pueden verlas, pero no modificarlas.
  • Personal: Skills disponibles solo para usted, además de las skills de su organización.
Las skills del agente del editor son independientes de las skills del assistant, que guían al assistant en su sitio de documentación y se encuentran en su repositorio.

​
Agregar una skill

Haga clic en Add skill en la sección donde desea la skill y, a continuación, elija una de estas opciones:
  • Create a skill: Introduzca un nombre, una descripción y las instrucciones. La descripción le indica al agente cuándo usar la skill, así que describa las tareas a las que se aplica.
  • Upload a skill: Suelte o busque un archivo SKILL.md, un archivo comprimido .skill o .zip, o una carpeta. Cada carpeta que contiene un archivo SKILL.md se convierte en una skill, y el agente puede leer los demás archivos de esa carpeta como referencias. Puede subir hasta 20 skills a la vez.
Un archivo SKILL.md necesita frontmatter YAML con un name y una description, seguidos de las instrucciones:
SKILL.md
Los nombres de las skills solo pueden contener letras minúsculas, números y guiones simples, con un máximo de 64 caracteres.

​
Administrar skills

Use el interruptor junto a una skill para activarla o desactivarla. El agente solo usa las skills que están activadas. Haga clic en el menú junto a una skill para Edit, Download o Delete. Los administradores también pueden seleccionar Move to organization en una skill personal para compartirla con todos los miembros de la organización. Para ver qué skills puede usar el agente en un chat, haga clic en el botón del cuadro de chat y seleccione Skills.