mintlify__docs/es/editor/agent.mdx

---
title: "Preguntar al agente"
description: "Use el agente de IA integrado del editor para escribir contenido, editar páginas, dejar comentarios y sugerencias, y buscar en su sitio."
keywords: ["editor", "AI", "assistant", "agent", "chat", "comments", "suggestions", "code mode", "file upload"]
---

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](/es/editor/publish).

Los mensajes del agente del editor son gratuitos y no cuentan para el [saldo de créditos](/es/credits) de su organización.

<div id="open-the-agent">

## Abrir el agente

</div>

Haga clic en **Ask agent** en la barra de herramientas del editor o presione <kbd>Cmd</kbd> + <kbd>I</kbd> (macOS) o <kbd>Ctrl</kbd> + <kbd>I</kbd> (Windows). El mismo botón y atajo funcionan en las páginas de configuración del dashboard, donde el panel se acopla junto a la navegación de configuración. Su sesión de chat permanece abierta al moverse entre el editor y la configuración. El agente está disponible para los editors y admins. Los [viewers](/es/dashboard/roles) no ven el botón **Ask agent**.

El agente del editor está incluido en los [planes Pro y Enterprise](https://mintlify.com/pricing). Usarlo no consume [créditos](/es/credits).

Escriba <kbd>@</kbd> para mencionar una página concreta y el agente se centrará en ella. Sin una mención, usa la página que tiene abierta. En las páginas del dashboard, el agente sabe qué página está viendo, incluidas las pantallas de configuración y las páginas de producto como Analytics, Assistant y Automations. 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"`

<div id="attach-files">

## Adjuntar archivos

</div>

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, limitados 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.

<div id="add-a-selection-to-the-agent">

## Añadir una selección al agente

</div>

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.

<div id="ask-for-comments-and-suggestions">

## Pedir comentarios y sugerencias

</div>

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](/es/editor/collaborate#suggestions) 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](/es/editor/collaborate#comments) 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.

<div id="review-what-the-agent-changed">

## Revisar lo que cambió el agente

</div>

Aparece un panel **Changed files** en el chat mientras el agente trabaja. Despliéguelo para ver todos los archivos modificados en la sesión y haga clic en cualquiera para comparar los cambios con el original en la vista de diff.

Para revertir las ediciones del agente, haga clic en el botón de descartar junto a un archivo en el panel **Changed files** o descarte todos los cambios de la sesión.

<div id="what-the-agent-can-do">

## Qué puede hacer el agente

</div>

<div id="edit-pages">

### Editar páginas

</div>

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.

<div id="search-and-navigate-your-content">

### Buscar y navegar por su contenido

</div>

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.

<div id="update-navigation-and-docsjson">

### Actualizar la navegación y docs.json

</div>

El agente puede añadir, renombrar, reordenar y eliminar elementos de navegación, 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`

<div id="run-bash-commands">

### Ejecutar comandos de bash

</div>

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`

<div id="configure-your-site-code-mode">

### Configurar su sitio (code mode)

</div>

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`

<div id="continue-an-automation-run">

### Continuar una ejecución de automatización

</div>

Cuando abre el editor desde un resultado de automatización haciendo clic en **Preview**, el panel del agente se abre automáticamente con contexto sobre lo que hizo la automatización. Una tarjeta **Changed 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 su trabajo sin volver a explicarle el contexto.

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

<div id="session-history">

## Historial de sesiones

</div>

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.

<div id="ai-instructions">

## Instrucciones de IA

</div>

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](/es/editor/settings#ai-instructions). El agente sigue estas instrucciones en cada solicitud sin que tenga que repetirlas.