Update from code changes: document private editor pages

editor/agent.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Ask agent"
-description: "Use the editor's built-in AI agent to write content, edit pages, search across your site, upload files, and configure settings from a chat interface."
+title: "Use the editor's AI agent to edit and manage pages"
+description: "Learn how to use the editor's AI agent to edit pages, update navigation, run bash commands, manage private pages, and configure your Mintlify site."
 keywords: ["editor", "AI", "assistant", "agent", "chat", "code mode", "file upload"]
 ---
 
@@ -35,6 +35,7 @@
 Click the paperclip icon in the chat box, or drag and drop files onto the panel. The agent reads attached files as context for your request.
 
 Supported file types:
+
 - **Images**: JPG, PNG, GIF, WebP, SVG
 - **Documents**: PDF
 - **Code and text**: `.js`, `.ts`, `.jsx`, `.tsx`, `.mdx`, `.md`, `.json`, `.yaml`, `.html`, `.css`, Python, Go, Rust, Ruby, Java, Swift, C, C++, SQL, shell scripts, and more
@@ -71,6 +72,67 @@
 
 Example: `find every page that mentions the deprecated /v1/auth endpoint`
 
+### Work with private pages
+
+If you have access to private pages, the agent can read and edit them from the private pages root. Use this when you need to review or update content that should not appear in your public navigation. Private pages are available in the editor without an additional feature flag. Your role and page grants still determine what you can access and change.
+
+You can open the agent from the private page editor. The agent button is hidden for users with the viewer role. Private navigation refreshes when the agent or another editor changes the private page tree.
+
+You can also right-click the **Private** section header in the sidebar to create a private page or folder if you have permission to create them.
+
+To promote a private page or folder from the sidebar, open its **More options** menu and select **Promote to workspace**. The action is available for items in your **Private** section when you have **Manager** access to the item and all of its descendants. After you confirm, Mintlify adds the page or folder at the workspace root. Promoting a folder also promotes all nested folders and pages, recreating their structure and copying their content. Mintlify generates page paths from titles and automatically resolves duplicate paths. The confirmation dialog warns that promotion is permanent. You cannot move the promoted content back to private pages.
+
+When the agent works with a private page, its tool activity labels show the page title instead of the UUID-based filename.
+
+When you open a private page, the editor toolbar shows an **Edited** label with how long ago the page was last edited. The label updates after you edit the page.
+
+Private pages use UUID-based filenames. Start by listing the private pages, then read or edit the file you need:
+
+```bash
+ls /home/daytona/private
+cat /home/daytona/private/private-page-<uuid>.mdx
+```
+
+Type `@` in the composer to search for private pages by title. Private pages appear in the mention picker with the label `Private page`. After you select one, its chip does not link to the private page. The agent resolves the mention to its UUID path and includes only pages you can access.
+
+To create a private folder, use a human-readable title as the final path segment. The folder appears under a new `private-folder-<uuid>` path after you list the directory again:
+
+```bash
+mkdir "/home/daytona/private/Onboarding"
+ls /home/daytona/private
+# private-folder-<uuid>
+```
+
+Within `/home/daytona/private`, use `mv` to reparent a private page or folder into another private folder. The item keeps its UUID-based name. Manager access is required. You cannot rename pages or move a folder into itself:
+
+```bash
+mv /home/daytona/private/private-page-<page-uuid>.mdx \
+  /home/daytona/private/private-folder-<folder-uuid>/
+mv /home/daytona/private/private-folder-<source-uuid> \
+  /home/daytona/private/private-folder-<destination-uuid>/
+```
+
+Moving a workspace page into `/home/daytona/private` is not supported.
+
+To duplicate a private page, use `cp` with a human-readable title as the final path segment. The copy appears under a new `private-page-<uuid>.mdx` path after you list the directory again:
+
+```bash
+cp /home/daytona/private/private-page-<source-uuid>.mdx \
+  "/home/daytona/private/Copy of this page"
+ls /home/daytona/private
+# private-page-<new-uuid>.mdx
+```
+
+You can copy private pages only. Copying folders and copying between `/home/daytona/private` and `/home/daytona/workspace` are not supported.
+
+You can also delete a private page if your role allows it. Manager access is required for deletion. To make a private page public, move it into the workspace:
+
+```bash
+mv /home/daytona/private/private-page-<uuid>.mdx /home/daytona/workspace/<path>.mdx
+```
+
+The move adds the page to public navigation and revokes its private-page access. You do not need to configure another filesystem or grant additional access. The agent uses your existing private-page permissions automatically.
+
 ### Configure your site (code mode)
 
 For requests that go beyond editing pages (setting up authentication, managing workflows, or changing deployment settings), the agent switches into code mode. It writes and runs a script against your Mintlify dashboard on your behalf.
@@ -85,9 +147,9 @@
 
 ### Continue an automation run
 
-When you open the editor from a completed automation run by clicking **View changes**, the agent panel opens automatically with context on what the automation did. A **Changed pages** card at the top of the chat lists every page the automation modified—click any page to open a diff view.
+When you open the editor from a completed automation run by clicking **View changes**, the agent panel opens automatically. It includes context on what the automation did. A **Changed pages** card at the top of the chat lists every page the automation modified. Click any page to open a diff view.
 
-The agent has context on the automation's prompt, a summary of the changes it made, and which pages it modified. You can ask it to refine or extend the automation's work without re-explaining the background.
+The agent has context on the automation's prompt, a summary of the changes it made, and the pages it modified. You can ask it to refine or extend the automation's work without re-explaining the background.
 
 For example: `The new section on rate limits is too long. Trim it to three sentences.`
 

es/editor/agent.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Preguntar al agente"
-description: "Use el agente de IA integrado del editor para escribir contenido, editar páginas, buscar en el sitio, subir archivos y ajustar la configuración."
+title: "Usar el agente de IA del editor para editar páginas"
+description: "Aprenda a usar el agente de IA del editor para editar páginas, actualizar la navegación, ejecutar bash y gestionar páginas privadas en Mintlify."
 keywords: ["editor", "AI", "assistant", "agent", "chat", "code mode", "file upload"]
 ---
 
@@ -14,7 +14,7 @@ El agente del editor realiza los cambios directamente en la branch actual.
 
 </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).
+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).
 
 Para cerrar el panel, haga clic en el botón **X** del encabezado del panel o vuelva a presionar <kbd>Cmd</kbd> + <kbd>I</kbd>.
 
@@ -24,7 +24,7 @@ Para cerrar el panel, haga clic en el botón **X** del encabezado del panel o vu
 
 </div>
 
-Escriba su solicitud en el cuadro de chat en la parte inferior del panel y presione <kbd>Enter</kbd> o haga clic en el botón de envío <Icon icon="arrow-up" />.
+Escriba su solicitud en el cuadro de chat en la parte inferior del panel. Presione <kbd>Enter</kbd> o haga clic en el botón de envío <Icon icon="arrow-up" />.
 
 Escriba <kbd>@</kbd> para mencionar una página específica. El agente se centra en esa página al procesar su solicitud. Si no menciona ninguna página, el agente utiliza la página que tiene abierta en ese momento.
 
@@ -42,9 +42,10 @@ Ejemplos de prompts:
 
 </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.
+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
@@ -95,7 +96,7 @@ El agente puede buscar en todo su repositorio, no solo en la página que tiene a
 
 </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, incluyendo añadir nuevos grupos, ajustar opciones y configurar redirecciones.
+El agente puede añadir, renombrar, reordenar y eliminar elementos de navegación, igual que usted haría manualmente en el panel de navegación. También puede actualizar directamente la configuración de `docs.json`, lo que incluye añadir nuevos grupos, ajustar opciones y configurar redirecciones.
 
 Ejemplo: `add a "Quickstart" group under the Getting Started tab and move the quickstart page into it`
 
@@ -109,6 +110,71 @@ El agente puede ejecutar `grep`, `rg` y otros comandos bash sobre su repositorio
 
 Ejemplo: `find every page that mentions the deprecated /v1/auth endpoint`
 
+<div id="work-with-private-pages">
+
+### Trabajar con páginas privadas
+
+</div>
+
+Si tiene acceso a páginas privadas, el agente puede leerlas y editarlas desde la raíz de páginas privadas. Use esta opción cuando necesite revisar o actualizar contenido que no debería aparecer en su navegación pública. Las páginas privadas están disponibles en el editor sin necesidad de activar un indicador de funcionalidad adicional. Su rol y los permisos de cada página siguen determinando a qué páginas puede acceder y qué cambios puede realizar.
+
+Puede abrir el agente desde el editor de páginas privadas. El botón del agente está oculto para los usuarios con el rol de viewer. La navegación privada se actualiza cuando el agente u otro editor cambia el árbol de páginas privadas.
+
+También puede hacer clic derecho en el encabezado de la sección **Private** en la barra lateral para crear una página o carpeta privada si tiene permiso para crearlas.
+
+Para promocionar una página o carpeta privada desde la barra lateral, abra su menú **More options** y seleccione **Promote to workspace**. La acción está disponible para los elementos de su sección **Private** cuando tiene acceso de **Manager** al elemento y a todos sus descendientes. Después de confirmar, Mintlify añade la página o carpeta en la raíz del espacio de trabajo. Al promocionar una carpeta, también se promocionan todas las carpetas y páginas anidadas, se recrea su estructura y se copia su contenido. Mintlify genera las rutas de las páginas a partir de sus títulos y resuelve automáticamente las rutas duplicadas. El diálogo de confirmación advierte que la promoción es permanente. No puede mover el contenido promocionado de vuelta a páginas privadas.
+
+Cuando el agente trabaja con una página privada, las etiquetas de sus herramientas muestran el título de la página en lugar del nombre de archivo basado en UUID.
+
+Al abrir una página privada, la barra de herramientas del editor muestra la etiqueta **Edited** con el tiempo transcurrido desde la última edición. La etiqueta se actualiza después de editar la página.
+
+Las páginas privadas utilizan nombres de archivo basados en UUID. Empiece por enumerar las páginas privadas y, después, lea o edite el archivo que necesite:
+
+```bash
+ls /home/daytona/private
+cat /home/daytona/private/private-page-<uuid>.mdx
+```
+
+Escriba `@` en el compositor para buscar páginas privadas por título. Las páginas privadas aparecen en el selector de menciones con la etiqueta `Private page`. Después de seleccionar una, su chip no enlaza a la página privada. El agente resuelve la mención a su ruta basada en UUID e incluye solo páginas a las que tiene acceso.
+
+Para crear una carpeta privada, use `mkdir` con un título legible como segmento final de la ruta. La carpeta aparece con una ruta `private-folder-<uuid>` después de volver a enumerar el directorio:
+
+```bash
+mkdir "/home/daytona/private/Onboarding"
+ls /home/daytona/private
+# private-folder-<uuid>
+```
+
+Dentro de `/home/daytona/private`, `mv` cambia el padre de una página o carpeta a otra carpeta privada. También conserva su nombre basado en UUID. Se requiere acceso de **Manager**. No admite renombrar páginas ni mover una carpeta dentro de sí misma:
+
+```bash
+mv /home/daytona/private/private-page-<page-uuid>.mdx \
+  /home/daytona/private/private-folder-<folder-uuid>/
+mv /home/daytona/private/private-folder-<source-uuid> \
+  /home/daytona/private/private-folder-<destination-uuid>/
+```
+
+No se admite mover una página del espacio de trabajo a `/home/daytona/private`.
+
+Para duplicar una página privada, use `cp` con un título legible como segmento final. Al volver a enumerar el directorio, la copia aparece con una nueva ruta `private-page-<uuid>.mdx`:
+
+```bash
+cp /home/daytona/private/private-page-<source-uuid>.mdx \
+  "/home/daytona/private/Copy of this page"
+ls /home/daytona/private
+# private-page-<new-uuid>.mdx
+```
+
+Solo se pueden copiar páginas privadas. `cp` no admite carpetas ni copias entre `/home/daytona/private` y `/home/daytona/workspace`.
+
+También puede eliminar una página privada si su rol lo permite. Para eliminarla, se requiere acceso de **Manager**. Para hacer pública una página privada, muévala al espacio de trabajo:
+
+```bash
+mv /home/daytona/private/private-page-<uuid>.mdx /home/daytona/workspace/<path>.mdx
+```
+
+El traslado añade la página a la navegación pública y revoca su acceso de página privada. No necesita configurar otro sistema de archivos ni conceder permisos adicionales. El agente utiliza automáticamente sus permisos existentes para páginas privadas.
+
 <div id="configure-your-site-code-mode">
 
 ### Configurar su sitio (code mode)
@@ -131,9 +197,9 @@ Ejemplos de prompts que usan code mode:
 
 </div>
 
-Cuando abres el editor desde una ejecución de automatización completada haciendo clic en **Ver cambios**, el panel del agente se abre automáticamente con contexto sobre lo que hizo la automatización. Una tarjeta de **Páginas modificadas** en la parte superior del chat lista cada página que la automatización modificó: haz clic en cualquier página para abrir una vista de diff.
+Al hacer clic en **Ver cambios** en una ejecución de automatización completada, el editor se abre. Muestra el panel del agente. El panel incluye el contexto sobre lo que hizo la automatización. Una tarjeta de **Páginas modificadas** en la parte superior del chat lista cada página que la automatización modificó. Haga clic en cualquier página para abrir una vista de diff.
 
-El agente tiene contexto sobre el prompt de la automatización, un resumen de los cambios que realizó y qué páginas modificó. Puedes pedirle que refine o amplíe el trabajo de la automatización sin tener que volver a explicar el contexto.
+El agente tiene contexto sobre el prompt de la automatización, un resumen de los cambios que realizó y las páginas que modificó. Puede pedirle que refine o amplíe el trabajo de la automatización sin tener que volver a explicar el contexto.
 
 Por ejemplo: `The new section on rate limits is too long. Trim it to three sentences.`
 
@@ -151,4 +217,4 @@ Haga clic en el icono del reloj en el encabezado del panel para ver sus sesiones
 
 </div>
 
-Para dar al agente pautas 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.
+Para dar al agente pautas 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.