From 9929c93c400703b9e1b8d76595907dff78a6a612 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 4 Aug 2026 21:50:59 +0000 Subject: [PATCH 01/17] docs: document editor agent private pages --- editor/agent.mdx | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/editor/agent.mdx b/editor/agent.mdx index 78beda5864..539311ac75 100644 --- a/editor/agent.mdx +++ b/editor/agent.mdx @@ -71,6 +71,25 @@ The agent can run `grep`, `rg`, and other bash commands against your repository. 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 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-.mdx +``` + +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-.mdx /home/daytona/workspace/.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. 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. From 6a29ecaf6d0f0cc073f814105f74796692e4bd59 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 4 Aug 2026 21:54:26 +0000 Subject: [PATCH 02/17] docs: refine private pages translations and metadata --- editor/agent.mdx | 2 +- es/editor/agent.mdx | 25 ++++++++++++++++++++++++- fr/editor/agent.mdx | 25 ++++++++++++++++++++++++- zh/editor/agent.mdx | 23 ++++++++++++++++++++++- 4 files changed, 71 insertions(+), 4 deletions(-) diff --git a/editor/agent.mdx b/editor/agent.mdx index 539311ac75..e4765f2c80 100644 --- a/editor/agent.mdx +++ b/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." +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"] --- diff --git a/es/editor/agent.mdx b/es/editor/agent.mdx index f75d77ec44..dcf1564d22 100644 --- a/es/editor/agent.mdx +++ b/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." +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"] --- @@ -109,6 +109,29 @@ El agente puede ejecutar `grep`, `rg` y otros comandos bash sobre su repositorio Ejemplo: `find every page that mentions the deprecated /v1/auth endpoint` +
+ +### Trabajar con páginas privadas + +
+ +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 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-.mdx +``` + +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-.mdx /home/daytona/workspace/.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 otro permiso. El agente utiliza automáticamente sus permisos existentes para páginas privadas. +
### Configurar su sitio (code mode) diff --git a/fr/editor/agent.mdx b/fr/editor/agent.mdx index 876c9b6237..eaf7f7b5c6 100644 --- a/fr/editor/agent.mdx +++ b/fr/editor/agent.mdx @@ -1,6 +1,6 @@ --- title: "Demander à l'agent" -description: "Utilisez l'agent IA intégré pour rédiger du contenu, modifier des pages, rechercher dans le site, téléverser des fichiers et configurer les paramètres." +description: "Découvrez comment utiliser l'agent IA de l'éditeur pour modifier des pages, actualiser la navigation, exécuter bash et gérer les pages privées." keywords: ["editor", "AI", "assistant", "agent", "chat", "code mode", "file upload"] --- @@ -109,6 +109,29 @@ L'agent peut exécuter `grep`, `rg` et d'autres commandes bash sur votre référ Exemple : `find every page that mentions the deprecated /v1/auth endpoint` +
+ +### Travailler avec des pages privées + +
+ +Si vous avez accès aux pages privées, l'agent peut les lire et les modifier depuis la racine des pages privées. Utilisez cette fonctionnalité lorsque vous devez examiner ou mettre à jour du contenu qui ne doit pas apparaître dans votre navigation publique. + +Les pages privées utilisent des noms de fichiers basés sur des UUID. Commencez par lister les pages privées, puis lisez ou modifiez le fichier dont vous avez besoin : + +```bash +ls /home/daytona/private +cat /home/daytona/private/private-page-.mdx +``` + +Vous pouvez également supprimer une page privée si votre rôle vous y autorise. Un accès Manager est requis pour la suppression. Pour rendre une page privée publique, déplacez-la dans l'espace de travail : + +```bash +mv /home/daytona/private/private-page-.mdx /home/daytona/workspace/.mdx +``` + +Le déplacement ajoute la page à la navigation publique et révoque son accès en tant que page privée. Vous n'avez pas besoin de configurer un autre système de fichiers ou une autre autorisation. L'agent utilise automatiquement vos autorisations existantes pour les pages privées. +
### Configurer votre site (mode code) diff --git a/zh/editor/agent.mdx b/zh/editor/agent.mdx index a154eaf143..c4e6017e26 100644 --- a/zh/editor/agent.mdx +++ b/zh/editor/agent.mdx @@ -1,6 +1,6 @@ --- title: "向代理提问" -description: "使用编辑器内置的 AI 代理，通过聊天界面撰写内容、编辑页面、跨站点搜索、上传文件并配置设置。" +description: "了解如何使用编辑器的 AI 代理编辑页面、更新导航、运行 bash 命令、管理私有页面，并配置 Mintlify 站点。" keywords: ["编辑器", "AI", "助手", "代理", "聊天", "code mode", "文件上传"] --- @@ -89,6 +89,27 @@ keywords: ["编辑器", "AI", "助手", "代理", "聊天", "code mode", "文件 示例：`find every page that mentions the deprecated /v1/auth endpoint` +
+ ### 处理私有页面 +
+ +如果你有权访问私有页面，代理可以从私有页面根目录读取和编辑这些页面。当你需要查看或更新不应出现在公共导航中的内容时，可以使用此功能。 + +私有页面使用基于 UUID 的文件名。首先列出私有页面，然后读取或编辑所需的文件： + +```bash +ls /home/daytona/private +cat /home/daytona/private/private-page-.mdx +``` + +如果你的角色允许，你还可以删除私有页面。删除操作需要 Manager 权限。要将私有页面设为公开，请将其移动到工作区： + +```bash +mv /home/daytona/private/private-page-.mdx /home/daytona/workspace/.mdx +``` + +移动操作会将该页面添加到公共导航中，并撤销其私有页面访问权限。你无需配置其他文件系统或授权。代理会自动使用你现有的私有页面权限。 +
### 配置你的站点 (code mode)
From 5f638c23762834559b607a820c98030e2abecb4f Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 4 Aug 2026 22:34:24 +0000 Subject: [PATCH 03/17] docs: document private editor agent availability --- editor/agent.mdx | 2 ++ es/editor/agent.mdx | 2 ++ fr/editor/agent.mdx | 2 ++ zh/editor/agent.mdx | 2 ++ 4 files changed, 8 insertions(+) diff --git a/editor/agent.mdx b/editor/agent.mdx index e4765f2c80..fce750a50d 100644 --- a/editor/agent.mdx +++ b/editor/agent.mdx @@ -75,6 +75,8 @@ Example: `find every page that mentions the deprecated /v1/auth endpoint` 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. +You can open the agent from the private page editor. The agent button is hidden for viewer roles. Private navigation refreshes when the agent or another editor changes the private page tree. + Private pages use UUID-based filenames. Start by listing the private pages, then read or edit the file you need: ```bash diff --git a/es/editor/agent.mdx b/es/editor/agent.mdx index dcf1564d22..bc1ac6eeba 100644 --- a/es/editor/agent.mdx +++ b/es/editor/agent.mdx @@ -117,6 +117,8 @@ Ejemplo: `find every page that mentions the deprecated /v1/auth endpoint` 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. +Puede abrir el agente desde el editor de páginas privadas. El botón del agente está oculto para los roles de viewer. La navegación privada se actualiza cuando el agente u otro editor cambia el árbol de páginas privadas. + 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 diff --git a/fr/editor/agent.mdx b/fr/editor/agent.mdx index eaf7f7b5c6..3f34f6dd76 100644 --- a/fr/editor/agent.mdx +++ b/fr/editor/agent.mdx @@ -117,6 +117,8 @@ Exemple : `find every page that mentions the deprecated /v1/auth endpoint` Si vous avez accès aux pages privées, l'agent peut les lire et les modifier depuis la racine des pages privées. Utilisez cette fonctionnalité lorsque vous devez examiner ou mettre à jour du contenu qui ne doit pas apparaître dans votre navigation publique. +Vous pouvez ouvrir l'agent depuis l'éditeur de pages privées. Le bouton de l'agent est masqué pour les rôles de viewer. La navigation privée s'actualise lorsque l'agent ou un autre éditeur modifie l'arborescence des pages privées. + Les pages privées utilisent des noms de fichiers basés sur des UUID. Commencez par lister les pages privées, puis lisez ou modifiez le fichier dont vous avez besoin : ```bash diff --git a/zh/editor/agent.mdx b/zh/editor/agent.mdx index c4e6017e26..4a6e6d15e1 100644 --- a/zh/editor/agent.mdx +++ b/zh/editor/agent.mdx @@ -95,6 +95,8 @@ keywords: ["编辑器", "AI", "助手", "代理", "聊天", "code mode", "文件 如果你有权访问私有页面，代理可以从私有页面根目录读取和编辑这些页面。当你需要查看或更新不应出现在公共导航中的内容时，可以使用此功能。 +你可以从私有页面编辑器中打开代理。viewer 角色不会显示代理按钮。当代理或其他编辑者更改私有页面树时，私有导航会自动刷新。 + 私有页面使用基于 UUID 的文件名。首先列出私有页面，然后读取或编辑所需的文件： ```bash From de2d9a468d2f6488985ccca9e5cebc0e6de2cce9 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 4 Aug 2026 22:36:07 +0000 Subject: [PATCH 04/17] docs: clarify private agent role wording --- editor/agent.mdx | 2 +- es/editor/agent.mdx | 2 +- fr/editor/agent.mdx | 2 +- zh/editor/agent.mdx | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/editor/agent.mdx b/editor/agent.mdx index fce750a50d..a54d423811 100644 --- a/editor/agent.mdx +++ b/editor/agent.mdx @@ -75,7 +75,7 @@ Example: `find every page that mentions the deprecated /v1/auth endpoint` 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. -You can open the agent from the private page editor. The agent button is hidden for viewer roles. Private navigation refreshes when the agent or another editor changes the private page tree. +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. Private pages use UUID-based filenames. Start by listing the private pages, then read or edit the file you need: diff --git a/es/editor/agent.mdx b/es/editor/agent.mdx index bc1ac6eeba..46c91454dd 100644 --- a/es/editor/agent.mdx +++ b/es/editor/agent.mdx @@ -117,7 +117,7 @@ Ejemplo: `find every page that mentions the deprecated /v1/auth endpoint` 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. -Puede abrir el agente desde el editor de páginas privadas. El botón del agente está oculto para los roles de viewer. La navegación privada se actualiza cuando el agente u otro editor cambia el árbol de páginas privadas. +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. 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: diff --git a/fr/editor/agent.mdx b/fr/editor/agent.mdx index 3f34f6dd76..2bf09542eb 100644 --- a/fr/editor/agent.mdx +++ b/fr/editor/agent.mdx @@ -117,7 +117,7 @@ Exemple : `find every page that mentions the deprecated /v1/auth endpoint` Si vous avez accès aux pages privées, l'agent peut les lire et les modifier depuis la racine des pages privées. Utilisez cette fonctionnalité lorsque vous devez examiner ou mettre à jour du contenu qui ne doit pas apparaître dans votre navigation publique. -Vous pouvez ouvrir l'agent depuis l'éditeur de pages privées. Le bouton de l'agent est masqué pour les rôles de viewer. La navigation privée s'actualise lorsque l'agent ou un autre éditeur modifie l'arborescence des pages privées. +Vous pouvez ouvrir l'agent depuis l'éditeur de pages privées. Le bouton de l'agent est masqué pour les utilisateurs ayant le rôle de viewer. La navigation privée s'actualise lorsque l'agent ou un autre éditeur modifie l'arborescence des pages privées. Les pages privées utilisent des noms de fichiers basés sur des UUID. Commencez par lister les pages privées, puis lisez ou modifiez le fichier dont vous avez besoin : diff --git a/zh/editor/agent.mdx b/zh/editor/agent.mdx index 4a6e6d15e1..a2c3758408 100644 --- a/zh/editor/agent.mdx +++ b/zh/editor/agent.mdx @@ -95,7 +95,7 @@ keywords: ["编辑器", "AI", "助手", "代理", "聊天", "code mode", "文件 如果你有权访问私有页面，代理可以从私有页面根目录读取和编辑这些页面。当你需要查看或更新不应出现在公共导航中的内容时，可以使用此功能。 -你可以从私有页面编辑器中打开代理。viewer 角色不会显示代理按钮。当代理或其他编辑者更改私有页面树时，私有导航会自动刷新。 +你可以从私有页面编辑器中打开代理。具有 viewer 角色的用户不会看到代理按钮。当代理或其他编辑者更改私有页面树时，私有导航会自动刷新。 私有页面使用基于 UUID 的文件名。首先列出私有页面，然后读取或编辑所需的文件： From 925b1bfdbac40885d8228d1400d1a44d78e9a4b5 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 4 Aug 2026 22:55:09 +0000 Subject: [PATCH 05/17] docs: show private page titles in agent tools --- editor/agent.mdx | 2 ++ es/editor/agent.mdx | 2 ++ fr/editor/agent.mdx | 2 ++ zh/editor/agent.mdx | 2 ++ 4 files changed, 8 insertions(+) diff --git a/editor/agent.mdx b/editor/agent.mdx index a54d423811..ba877996e6 100644 --- a/editor/agent.mdx +++ b/editor/agent.mdx @@ -77,6 +77,8 @@ If you have access to private pages, the agent can read and edit them from the p 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. +When the agent works with a private page, its tool activity labels show the page title instead of the UUID-based filename. + Private pages use UUID-based filenames. Start by listing the private pages, then read or edit the file you need: ```bash diff --git a/es/editor/agent.mdx b/es/editor/agent.mdx index 46c91454dd..f96e559a69 100644 --- a/es/editor/agent.mdx +++ b/es/editor/agent.mdx @@ -119,6 +119,8 @@ Si tiene acceso a páginas privadas, el agente puede leerlas y editarlas desde l 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. +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. + 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 diff --git a/fr/editor/agent.mdx b/fr/editor/agent.mdx index 2bf09542eb..3393f60800 100644 --- a/fr/editor/agent.mdx +++ b/fr/editor/agent.mdx @@ -119,6 +119,8 @@ Si vous avez accès aux pages privées, l'agent peut les lire et les modifier de Vous pouvez ouvrir l'agent depuis l'éditeur de pages privées. Le bouton de l'agent est masqué pour les utilisateurs ayant le rôle de viewer. La navigation privée s'actualise lorsque l'agent ou un autre éditeur modifie l'arborescence des pages privées. +Lorsque l'agent utilise une page privée, les libellés de ses outils affichent le titre de la page au lieu du nom de fichier basé sur l'UUID. + Les pages privées utilisent des noms de fichiers basés sur des UUID. Commencez par lister les pages privées, puis lisez ou modifiez le fichier dont vous avez besoin : ```bash diff --git a/zh/editor/agent.mdx b/zh/editor/agent.mdx index a2c3758408..b3868add73 100644 --- a/zh/editor/agent.mdx +++ b/zh/editor/agent.mdx @@ -97,6 +97,8 @@ keywords: ["编辑器", "AI", "助手", "代理", "聊天", "code mode", "文件 你可以从私有页面编辑器中打开代理。具有 viewer 角色的用户不会看到代理按钮。当代理或其他编辑者更改私有页面树时，私有导航会自动刷新。 +代理处理私有页面时，其工具活动标签会显示页面标题，而不是基于 UUID 的文件名。 + 私有页面使用基于 UUID 的文件名。首先列出私有页面，然后读取或编辑所需的文件： ```bash From e2544918f559216fc545d67a227d47c9ab93d044 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 4 Aug 2026 22:59:20 +0000 Subject: [PATCH 06/17] docs: refine editor agent metadata --- editor/agent.mdx | 2 +- es/editor/agent.mdx | 2 +- fr/editor/agent.mdx | 2 +- zh/editor/agent.mdx | 4 ++-- 4 files changed, 5 insertions(+), 5 deletions(-) diff --git a/editor/agent.mdx b/editor/agent.mdx index ba877996e6..be607e2b83 100644 --- a/editor/agent.mdx +++ b/editor/agent.mdx @@ -1,5 +1,5 @@ --- -title: "Ask agent" +title: "Use the editor's AI agent to edit 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"] --- diff --git a/es/editor/agent.mdx b/es/editor/agent.mdx index f96e559a69..4852dda7f3 100644 --- a/es/editor/agent.mdx +++ b/es/editor/agent.mdx @@ -1,5 +1,5 @@ --- -title: "Preguntar al agente" +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"] --- diff --git a/fr/editor/agent.mdx b/fr/editor/agent.mdx index 3393f60800..059ebcbace 100644 --- a/fr/editor/agent.mdx +++ b/fr/editor/agent.mdx @@ -1,5 +1,5 @@ --- -title: "Demander à l'agent" +title: "Utiliser l'agent IA de l'éditeur pour modifier des pages" description: "Découvrez comment utiliser l'agent IA de l'éditeur pour modifier des pages, actualiser la navigation, exécuter bash et gérer les pages privées." keywords: ["editor", "AI", "assistant", "agent", "chat", "code mode", "file upload"] --- diff --git a/zh/editor/agent.mdx b/zh/editor/agent.mdx index b3868add73..5f68d5d156 100644 --- a/zh/editor/agent.mdx +++ b/zh/editor/agent.mdx @@ -1,6 +1,6 @@ --- -title: "向代理提问" -description: "了解如何使用编辑器的 AI 代理编辑页面、更新导航、运行 bash 命令、管理私有页面，并配置 Mintlify 站点。" +title: "使用编辑器 AI 代理编辑和管理页面" +description: "了解如何使用编辑器的 AI 代理编辑和管理页面、更新导航、运行 bash 命令、处理私有页面并配置 Mintlify 站点。本文介绍私有页面权限、UUID 文件路径、页面发布方式、工具活动标签以及自动化运行管理，并说明如何附加文件、查看更改、查看会话历史以及设置 AI 指令。" keywords: ["编辑器", "AI", "助手", "代理", "聊天", "code mode", "文件上传"] --- From 007de7357dd29b7fbb05a4f43e0b1bbd5e79a86b Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 5 Aug 2026 21:53:26 +0000 Subject: [PATCH 07/17] docs: document private editor filesystem workflows --- editor/agent.mdx | 32 ++++++++++++++++++++++++++++++++ es/editor/agent.mdx | 32 ++++++++++++++++++++++++++++++++ fr/editor/agent.mdx | 32 ++++++++++++++++++++++++++++++++ zh/editor/agent.mdx | 30 ++++++++++++++++++++++++++++++ 4 files changed, 126 insertions(+) diff --git a/editor/agent.mdx b/editor/agent.mdx index be607e2b83..60e4010803 100644 --- a/editor/agent.mdx +++ b/editor/agent.mdx @@ -86,6 +86,38 @@ ls /home/daytona/private cat /home/daytona/private/private-page-.mdx ``` +You can also mention a private page by title in the composer. 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-` path after you list the directory again: + +```bash +mkdir "/home/daytona/private/Onboarding" +ls /home/daytona/private +# private-folder- +``` + +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-.mdx \ + /home/daytona/private/private-folder-/ +mv /home/daytona/private/private-folder- \ + /home/daytona/private/private-folder-/ +``` + +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-.mdx` path after you list the directory again: + +```bash +cp /home/daytona/private/private-page-.mdx \ + "/home/daytona/private/Copy of this page" +ls /home/daytona/private +# private-page-.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 diff --git a/es/editor/agent.mdx b/es/editor/agent.mdx index 4852dda7f3..e8c0788cb7 100644 --- a/es/editor/agent.mdx +++ b/es/editor/agent.mdx @@ -128,6 +128,38 @@ ls /home/daytona/private cat /home/daytona/private/private-page-.mdx ``` +En el compositor, escriba `@` para buscar y mencionar una página privada por su título. El agente resuelve la mención a la ruta basada en UUID y la lista solo incluye 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-` después de volver a enumerar el directorio: + +```bash +mkdir "/home/daytona/private/Onboarding" +ls /home/daytona/private +# private-folder- +``` + +Dentro de `/home/daytona/private`, `mv` cambia el padre de una página o carpeta a otra carpeta privada y 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-.mdx \ + /home/daytona/private/private-folder- +mv /home/daytona/private/private-folder- \ + /home/daytona/private/private-folder- +``` + +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-.mdx`: + +```bash +cp /home/daytona/private/private-page-.mdx \ + "/home/daytona/private/Copy of Secret" +ls /home/daytona/private +# private-page-.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 diff --git a/fr/editor/agent.mdx b/fr/editor/agent.mdx index 059ebcbace..70aab53443 100644 --- a/fr/editor/agent.mdx +++ b/fr/editor/agent.mdx @@ -128,6 +128,38 @@ ls /home/daytona/private cat /home/daytona/private/private-page-.mdx ``` +Vous pouvez également mentionner une page privée par son titre dans le composeur avec @. L'agent résout la mention vers le chemin UUID de la page et ne prend en compte que les pages auxquelles vous avez accès. + +Pour créer un dossier privé, donnez-lui un titre humain comme dernier segment du chemin. Après une nouvelle liste, le dossier apparaît sous un chemin `private-folder-` : + +```bash +mkdir /home/daytona/private/ +ls /home/daytona/private +# private-folder-/ +``` + +Pour réorganiser une page ou un dossier, `mv` peut le reparenter dans un autre dossier sous `/home/daytona/private` : + +```bash +mv /home/daytona/private/private-page-.mdx /home/daytona/private/private-folder-/ +mv /home/daytona/private/private-folder- /home/daytona/private/private-folder-/ +``` + +Le déplacement d'une page de l'espace de travail vers `/home/daytona/private` n'est pas pris en charge. + +Cette opération exige l'accès **Manager**. Elle conserve le nom UUID de l'élément ; `mv` ne renomme pas les pages et ne peut pas déplacer un dossier dans lui-même. + +Pour copier une page privée, utilisez `cp` avec un nouveau titre humain comme dernier segment du chemin de destination : + +```bash +cp /home/daytona/private/private-page-.mdx \ + "/home/daytona/private/" +ls /home/daytona/private +# private-page-.mdx +``` + +La copie est une nouvelle page privée et apparaît sous un chemin `private-page-.mdx` après la prochaine liste. La copie de dossiers n'est pas prise en charge, pas plus que les copies entre les racines `/home/daytona/private` et `/home/daytona/workspace`. + Vous pouvez également supprimer une page privée si votre rôle vous y autorise. Un accès Manager est requis pour la suppression. Pour rendre une page privée publique, déplacez-la dans l'espace de travail : ```bash diff --git a/zh/editor/agent.mdx b/zh/editor/agent.mdx index 5f68d5d156..2f6b488f86 100644 --- a/zh/editor/agent.mdx +++ b/zh/editor/agent.mdx @@ -106,6 +106,36 @@ ls /home/daytona/private cat /home/daytona/private/private-page-.mdx ``` +在代理聊天框中输入 `@` 后，可以按标题提及私有页面。代理会将提及解析为对应的 UUID 文件路径，并且只会显示和包含你有权访问的页面。 + +要创建私有文件夹，请使用人类可读的标题作为路径的最后一段。重新列出私有页面后，新文件夹会显示为 `private-folder-` 路径： + +```bash +mkdir "/home/daytona/private/" +ls /home/daytona/private +# /home/daytona/private/private-folder- +``` + +在 `/home/daytona/private` 中，`mv` 可以将页面或文件夹移动到另一个私有文件夹，同时保留其 UUID 名称。此操作需要 Manager 权限；不能使用它重命名页面，也不能将文件夹移动到自身内部： + +```bash +mv /home/daytona/private/private-page-.mdx \ + /home/daytona/private/private-folder-/ +mv /home/daytona/private/private-folder- \ + /home/daytona/private/private-folder-/ +``` + +不支持将工作区页面移动到 `/home/daytona/private`。 + +`cp` 可以将私有页面复制到新的私有路径。目标路径的最后一段应使用人类可读的标题；重新列出私有页面后，副本会显示为新的 `private-page-.mdx` 路径。`cp` 只支持复制私有页面，不支持复制文件夹，也不支持在私有根目录和工作区根目录之间复制： + +```bash +cp /home/daytona/private/private-page-.mdx \ + "/home/daytona/private/" +ls /home/daytona/private +# /home/daytona/private/private-page-.mdx +``` + 如果你的角色允许，你还可以删除私有页面。删除操作需要 Manager 权限。要将私有页面设为公开，请将其移动到工作区： ```bash From e4c6fa6276fd8df5ea3a8e94c0ff1a27c2ce622c Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 5 Aug 2026 21:58:13 +0000 Subject: [PATCH 08/17] docs: align translated editor examples --- editor/agent.mdx | 2 +- es/editor/agent.mdx | 8 ++++---- fr/editor/agent.mdx | 16 +++++++++------- zh/editor/agent.mdx | 14 +++++++------- 4 files changed, 21 insertions(+), 19 deletions(-) diff --git a/editor/agent.mdx b/editor/agent.mdx index 60e4010803..f752db2b4e 100644 --- a/editor/agent.mdx +++ b/editor/agent.mdx @@ -140,7 +140,7 @@ Example prompts that use code mode: ### 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 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. 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. diff --git a/es/editor/agent.mdx b/es/editor/agent.mdx index e8c0788cb7..2791d65995 100644 --- a/es/editor/agent.mdx +++ b/es/editor/agent.mdx @@ -142,9 +142,9 @@ Dentro de `/home/daytona/private`, `mv` cambia el padre de una página o carpeta ```bash mv /home/daytona/private/private-page-.mdx \ - /home/daytona/private/private-folder- + /home/daytona/private/private-folder-/ mv /home/daytona/private/private-folder- \ - /home/daytona/private/private-folder- + /home/daytona/private/private-folder-/ ``` No se admite mover una página del espacio de trabajo a `/home/daytona/private`. @@ -153,14 +153,14 @@ Para duplicar una página privada, use `cp` con un título legible como segmento ```bash cp /home/daytona/private/private-page-.mdx \ - "/home/daytona/private/Copy of Secret" + "/home/daytona/private/Copy of this page" ls /home/daytona/private # private-page-.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: +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-.mdx /home/daytona/workspace/.mdx diff --git a/fr/editor/agent.mdx b/fr/editor/agent.mdx index 70aab53443..73c6dd74ac 100644 --- a/fr/editor/agent.mdx +++ b/fr/editor/agent.mdx @@ -133,16 +133,18 @@ Vous pouvez également mentionner une page privée par son titre dans le compose Pour créer un dossier privé, donnez-lui un titre humain comme dernier segment du chemin. Après une nouvelle liste, le dossier apparaît sous un chemin `private-folder-` : ```bash -mkdir /home/daytona/private/ +mkdir "/home/daytona/private/Onboarding" ls /home/daytona/private -# private-folder-/ +# private-folder- ``` Pour réorganiser une page ou un dossier, `mv` peut le reparenter dans un autre dossier sous `/home/daytona/private` : ```bash -mv /home/daytona/private/private-page-.mdx /home/daytona/private/private-folder-/ -mv /home/daytona/private/private-folder- /home/daytona/private/private-folder-/ +mv /home/daytona/private/private-page-.mdx \ + /home/daytona/private/private-folder-/ +mv /home/daytona/private/private-folder- \ + /home/daytona/private/private-folder-/ ``` Le déplacement d'une page de l'espace de travail vers `/home/daytona/private` n'est pas pris en charge. @@ -152,8 +154,8 @@ Cette opération exige l'accès **Manager**. Elle conserve le nom UUID de l'él Pour copier une page privée, utilisez `cp` avec un nouveau titre humain comme dernier segment du chemin de destination : ```bash -cp /home/daytona/private/private-page-.mdx \ - "/home/daytona/private/" +cp /home/daytona/private/private-page-.mdx \ + "/home/daytona/private/Copy of this page" ls /home/daytona/private # private-page-.mdx ``` @@ -190,7 +192,7 @@ Exemples de prompts qui utilisent le mode code :
-Lorsque vous ouvrez l'éditeur depuis une exécution d'automatisation terminée en cliquant sur **View changes**, le panneau de l'agent s'ouvre automatiquement avec le contexte de ce que l'automatisation a fait. Une carte **Pages modifiées** en haut du chat liste chaque page modifiée par l'automatisation — cliquez sur une page pour ouvrir une vue de diff. +Lorsque vous ouvrez l'éditeur depuis une exécution d'automatisation terminée en cliquant sur **View changes**, le panneau de l'agent s'ouvre automatiquement avec le contexte de ce que l'automatisation a fait. Une carte **Pages modifiées** en haut du chat liste chaque page modifiée par l'automatisation. Cliquez sur une page pour ouvrir une vue de diff. L'agent dispose du contexte du prompt de l'automatisation, d'un résumé des modifications qu'elle a effectuées et des pages qu'elle a modifiées. Vous pouvez lui demander d'affiner ou d'étendre le travail de l'automatisation sans avoir à réexpliquer le contexte. diff --git a/zh/editor/agent.mdx b/zh/editor/agent.mdx index 2f6b488f86..dd6a7cbc95 100644 --- a/zh/editor/agent.mdx +++ b/zh/editor/agent.mdx @@ -111,9 +111,9 @@ cat /home/daytona/private/private-page-.mdx 要创建私有文件夹，请使用人类可读的标题作为路径的最后一段。重新列出私有页面后，新文件夹会显示为 `private-folder-` 路径： ```bash -mkdir "/home/daytona/private/" +mkdir "/home/daytona/private/Onboarding" ls /home/daytona/private -# /home/daytona/private/private-folder- +# private-folder- ``` 在 `/home/daytona/private` 中，`mv` 可以将页面或文件夹移动到另一个私有文件夹，同时保留其 UUID 名称。此操作需要 Manager 权限；不能使用它重命名页面，也不能将文件夹移动到自身内部： @@ -122,7 +122,7 @@ ls /home/daytona/private mv /home/daytona/private/private-page-.mdx \ /home/daytona/private/private-folder-/ mv /home/daytona/private/private-folder- \ - /home/daytona/private/private-folder-/ + /home/daytona/private/private-folder-/ ``` 不支持将工作区页面移动到 `/home/daytona/private`。 @@ -130,10 +130,10 @@ mv /home/daytona/private/private-folder- \ `cp` 可以将私有页面复制到新的私有路径。目标路径的最后一段应使用人类可读的标题；重新列出私有页面后，副本会显示为新的 `private-page-.mdx` 路径。`cp` 只支持复制私有页面，不支持复制文件夹，也不支持在私有根目录和工作区根目录之间复制： ```bash -cp /home/daytona/private/private-page-.mdx \ - "/home/daytona/private/" +cp /home/daytona/private/private-page-.mdx \ + "/home/daytona/private/Copy of this page" ls /home/daytona/private -# /home/daytona/private/private-page-.mdx +# private-page-.mdx ``` 如果你的角色允许，你还可以删除私有页面。删除操作需要 Manager 权限。要将私有页面设为公开，请将其移动到工作区： @@ -162,7 +162,7 @@ Code mode 会遵循你在控制台中的权限。如果你在控制台中无权 ### 继续自动化运行
-当你通过点击 **View changes** 从已完成的自动化运行中打开编辑器时，代理面板会自动打开，并带有关于该自动化所执行操作的上下文。聊天顶部会显示一张 **Changed pages** 卡片，列出该自动化修改的每个页面——点击任意页面可打开差异视图。 +当你通过点击 **View changes** 从已完成的自动化运行中打开编辑器时，代理面板会自动打开，并带有关于该自动化所执行操作的上下文。聊天顶部会显示一张 **Changed pages** 卡片，列出该自动化修改的每个页面。点击任意页面可打开差异视图。 代理拥有该自动化提示词、所做更改的摘要以及它修改的页面的上下文。你可以让它细化或扩展该自动化的工作，无需再次说明背景。 From b1bbf79866ba9266b44d1980d9878bd59fbba55d Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 5 Aug 2026 22:46:12 +0000 Subject: [PATCH 09/17] docs: document private page mention picker --- editor/agent.mdx | 4 +++- es/editor/agent.mdx | 4 +++- fr/editor/agent.mdx | 4 +++- zh/editor/agent.mdx | 4 +++- 4 files changed, 12 insertions(+), 4 deletions(-) diff --git a/editor/agent.mdx b/editor/agent.mdx index f752db2b4e..e93443d93d 100644 --- a/editor/agent.mdx +++ b/editor/agent.mdx @@ -77,6 +77,8 @@ If you have access to private pages, the agent can read and edit them from the p 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. + When the agent works with a private page, its tool activity labels show the page title instead of the UUID-based filename. Private pages use UUID-based filenames. Start by listing the private pages, then read or edit the file you need: @@ -86,7 +88,7 @@ ls /home/daytona/private cat /home/daytona/private/private-page-.mdx ``` -You can also mention a private page by title in the composer. The agent resolves the mention to its UUID path and includes only pages you can access. +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-` path after you list the directory again: diff --git a/es/editor/agent.mdx b/es/editor/agent.mdx index 2791d65995..fbc23f169b 100644 --- a/es/editor/agent.mdx +++ b/es/editor/agent.mdx @@ -119,6 +119,8 @@ Si tiene acceso a páginas privadas, el agente puede leerlas y editarlas desde l 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. + 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. 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: @@ -128,7 +130,7 @@ ls /home/daytona/private cat /home/daytona/private/private-page-.mdx ``` -En el compositor, escriba `@` para buscar y mencionar una página privada por su título. El agente resuelve la mención a la ruta basada en UUID y la lista solo incluye páginas a las que tiene acceso. +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-` después de volver a enumerar el directorio: diff --git a/fr/editor/agent.mdx b/fr/editor/agent.mdx index 73c6dd74ac..7ddea4a377 100644 --- a/fr/editor/agent.mdx +++ b/fr/editor/agent.mdx @@ -119,6 +119,8 @@ Si vous avez accès aux pages privées, l'agent peut les lire et les modifier de Vous pouvez ouvrir l'agent depuis l'éditeur de pages privées. Le bouton de l'agent est masqué pour les utilisateurs ayant le rôle de viewer. La navigation privée s'actualise lorsque l'agent ou un autre éditeur modifie l'arborescence des pages privées. +Vous pouvez également cliquer avec le bouton droit sur l'en-tête de la section **Private** dans la barre latérale pour créer une page ou un dossier privé si vous disposez des autorisations nécessaires. + Lorsque l'agent utilise une page privée, les libellés de ses outils affichent le titre de la page au lieu du nom de fichier basé sur l'UUID. Les pages privées utilisent des noms de fichiers basés sur des UUID. Commencez par lister les pages privées, puis lisez ou modifiez le fichier dont vous avez besoin : @@ -128,7 +130,7 @@ ls /home/daytona/private cat /home/daytona/private/private-page-.mdx ``` -Vous pouvez également mentionner une page privée par son titre dans le composeur avec @. L'agent résout la mention vers le chemin UUID de la page et ne prend en compte que les pages auxquelles vous avez accès. +Dans le composeur, saisissez @ pour rechercher une page privée par son titre. Les pages privées apparaissent dans le sélecteur de mentions avec le libellé `Private page`. Après sélection, sa puce ne contient pas de lien vers la page privée. L'agent résout la mention vers son chemin UUID et ne prend en compte que les pages auxquelles vous avez accès. Pour créer un dossier privé, donnez-lui un titre humain comme dernier segment du chemin. Après une nouvelle liste, le dossier apparaît sous un chemin `private-folder-` : diff --git a/zh/editor/agent.mdx b/zh/editor/agent.mdx index dd6a7cbc95..14433832fc 100644 --- a/zh/editor/agent.mdx +++ b/zh/editor/agent.mdx @@ -97,6 +97,8 @@ keywords: ["编辑器", "AI", "助手", "代理", "聊天", "code mode", "文件 你可以从私有页面编辑器中打开代理。具有 viewer 角色的用户不会看到代理按钮。当代理或其他编辑者更改私有页面树时，私有导航会自动刷新。 +如果你有创建权限，还可以右键点击侧边栏中的 **Private** 分区标题来创建私有页面或文件夹。 + 代理处理私有页面时，其工具活动标签会显示页面标题，而不是基于 UUID 的文件名。 私有页面使用基于 UUID 的文件名。首先列出私有页面，然后读取或编辑所需的文件： @@ -106,7 +108,7 @@ ls /home/daytona/private cat /home/daytona/private/private-page-.mdx ``` -在代理聊天框中输入 `@` 后，可以按标题提及私有页面。代理会将提及解析为对应的 UUID 文件路径，并且只会显示和包含你有权访问的页面。 +在代理聊天框中输入 `@`，即可按标题搜索私有页面。私有页面会在提及选择器中显示为 `Private page`。选择后，对应的提及标签不会链接到私有页面。代理会将提及解析为对应的 UUID 文件路径，并且只会显示和包含你有权访问的页面。 要创建私有文件夹，请使用人类可读的标题作为路径的最后一段。重新列出私有页面后，新文件夹会显示为 `private-folder-` 路径： From c79251e53c5fd2e47ebfa0a455cbb081001a50ed Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 5 Aug 2026 23:17:54 +0000 Subject: [PATCH 10/17] docs: document private page edit times --- editor/agent.mdx | 2 ++ es/editor/agent.mdx | 2 ++ fr/editor/agent.mdx | 2 ++ zh/editor/agent.mdx | 2 ++ 4 files changed, 8 insertions(+) diff --git a/editor/agent.mdx b/editor/agent.mdx index e93443d93d..3049bdd825 100644 --- a/editor/agent.mdx +++ b/editor/agent.mdx @@ -81,6 +81,8 @@ You can also right-click the **Private** section header in the sidebar to create 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. + Private pages use UUID-based filenames. Start by listing the private pages, then read or edit the file you need: ```bash diff --git a/es/editor/agent.mdx b/es/editor/agent.mdx index fbc23f169b..89d06cee25 100644 --- a/es/editor/agent.mdx +++ b/es/editor/agent.mdx @@ -123,6 +123,8 @@ También puede hacer clic derecho en el encabezado de la sección **Private** en 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. + 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 diff --git a/fr/editor/agent.mdx b/fr/editor/agent.mdx index 7ddea4a377..e812c0e932 100644 --- a/fr/editor/agent.mdx +++ b/fr/editor/agent.mdx @@ -123,6 +123,8 @@ Vous pouvez également cliquer avec le bouton droit sur l'en-tête de la section Lorsque l'agent utilise une page privée, les libellés de ses outils affichent le titre de la page au lieu du nom de fichier basé sur l'UUID. +Lorsque vous ouvrez une page privée, la barre d'outils de l'éditeur affiche le libellé **Edited** et indique depuis combien de temps la page a été modifiée. + Les pages privées utilisent des noms de fichiers basés sur des UUID. Commencez par lister les pages privées, puis lisez ou modifiez le fichier dont vous avez besoin : ```bash diff --git a/zh/editor/agent.mdx b/zh/editor/agent.mdx index 14433832fc..c08e4d1597 100644 --- a/zh/editor/agent.mdx +++ b/zh/editor/agent.mdx @@ -101,6 +101,8 @@ keywords: ["编辑器", "AI", "助手", "代理", "聊天", "code mode", "文件 代理处理私有页面时，其工具活动标签会显示页面标题，而不是基于 UUID 的文件名。 +打开私有页面时，编辑器工具栏会显示 **Edited** 标签，并指出距页面上次编辑经过了多长时间。 + 私有页面使用基于 UUID 的文件名。首先列出私有页面，然后读取或编辑所需的文件： ```bash From ae8ab372ef38bc025a20cc1cab7ae39c293c3a65 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 5 Aug 2026 23:20:32 +0000 Subject: [PATCH 11/17] docs: clarify private page promotion access --- editor/agent.mdx | 2 +- es/editor/agent.mdx | 2 +- fr/editor/agent.mdx | 2 +- zh/editor/agent.mdx | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/editor/agent.mdx b/editor/agent.mdx index 3049bdd825..a8f75103f9 100644 --- a/editor/agent.mdx +++ b/editor/agent.mdx @@ -128,7 +128,7 @@ You can also delete a private page if your role allows it. Manager access is req mv /home/daytona/private/private-page-.mdx /home/daytona/workspace/.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. The agent uses your existing private-page permissions automatically. +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) diff --git a/es/editor/agent.mdx b/es/editor/agent.mdx index 89d06cee25..146bbbe700 100644 --- a/es/editor/agent.mdx +++ b/es/editor/agent.mdx @@ -170,7 +170,7 @@ También puede eliminar una página privada si su rol lo permite. Para eliminarl mv /home/daytona/private/private-page-.mdx /home/daytona/workspace/.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 otro permiso. El agente utiliza automáticamente sus permisos existentes para páginas privadas. +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.
diff --git a/fr/editor/agent.mdx b/fr/editor/agent.mdx index e812c0e932..3c25b1ff02 100644 --- a/fr/editor/agent.mdx +++ b/fr/editor/agent.mdx @@ -172,7 +172,7 @@ Vous pouvez également supprimer une page privée si votre rôle vous y autorise mv /home/daytona/private/private-page-.mdx /home/daytona/workspace/.mdx ``` -Le déplacement ajoute la page à la navigation publique et révoque son accès en tant que page privée. Vous n'avez pas besoin de configurer un autre système de fichiers ou une autre autorisation. L'agent utilise automatiquement vos autorisations existantes pour les pages privées. +Le déplacement ajoute la page à la navigation publique et révoque son accès en tant que page privée. Vous n'avez pas besoin de configurer un autre système de fichiers ni d'accorder un accès supplémentaire. L'agent utilise automatiquement vos autorisations existantes pour les pages privées.
diff --git a/zh/editor/agent.mdx b/zh/editor/agent.mdx index c08e4d1597..cfcca1f895 100644 --- a/zh/editor/agent.mdx +++ b/zh/editor/agent.mdx @@ -146,7 +146,7 @@ ls /home/daytona/private mv /home/daytona/private/private-page-.mdx /home/daytona/workspace/.mdx ``` -移动操作会将该页面添加到公共导航中，并撤销其私有页面访问权限。你无需配置其他文件系统或授权。代理会自动使用你现有的私有页面权限。 +移动操作会将该页面添加到公共导航中，并撤销其私有页面访问权限。你无需配置其他文件系统或额外授权。代理会自动使用你现有的私有页面权限。
### 配置你的站点 (code mode) From b77908f3ef346f7dc5a11a0590932ed258dd7523 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 5 Aug 2026 23:24:03 +0000 Subject: [PATCH 12/17] docs: document private edit time refresh --- editor/agent.mdx | 2 +- es/editor/agent.mdx | 2 +- fr/editor/agent.mdx | 2 +- zh/editor/agent.mdx | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/editor/agent.mdx b/editor/agent.mdx index a8f75103f9..9b6ae58938 100644 --- a/editor/agent.mdx +++ b/editor/agent.mdx @@ -81,7 +81,7 @@ You can also right-click the **Private** section header in the sidebar to create 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. +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: diff --git a/es/editor/agent.mdx b/es/editor/agent.mdx index 146bbbe700..41fd53af06 100644 --- a/es/editor/agent.mdx +++ b/es/editor/agent.mdx @@ -123,7 +123,7 @@ También puede hacer clic derecho en el encabezado de la sección **Private** en 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. +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: diff --git a/fr/editor/agent.mdx b/fr/editor/agent.mdx index 3c25b1ff02..de07b3be66 100644 --- a/fr/editor/agent.mdx +++ b/fr/editor/agent.mdx @@ -123,7 +123,7 @@ Vous pouvez également cliquer avec le bouton droit sur l'en-tête de la section Lorsque l'agent utilise une page privée, les libellés de ses outils affichent le titre de la page au lieu du nom de fichier basé sur l'UUID. -Lorsque vous ouvrez une page privée, la barre d'outils de l'éditeur affiche le libellé **Edited** et indique depuis combien de temps la page a été modifiée. +Lorsque vous ouvrez une page privée, la barre d'outils de l'éditeur affiche le libellé **Edited** et indique depuis combien de temps la page a été modifiée. Le libellé se met à jour après la modification de la page. Les pages privées utilisent des noms de fichiers basés sur des UUID. Commencez par lister les pages privées, puis lisez ou modifiez le fichier dont vous avez besoin : diff --git a/zh/editor/agent.mdx b/zh/editor/agent.mdx index cfcca1f895..bc8f25207d 100644 --- a/zh/editor/agent.mdx +++ b/zh/editor/agent.mdx @@ -101,7 +101,7 @@ keywords: ["编辑器", "AI", "助手", "代理", "聊天", "code mode", "文件 代理处理私有页面时，其工具活动标签会显示页面标题，而不是基于 UUID 的文件名。 -打开私有页面时，编辑器工具栏会显示 **Edited** 标签，并指出距页面上次编辑经过了多长时间。 +打开私有页面时，编辑器工具栏会显示 **Edited** 标签，并指出距页面上次编辑经过了多长时间。编辑页面后，标签会更新。 私有页面使用基于 UUID 的文件名。首先列出私有页面，然后读取或编辑所需的文件： From ebebe12014e54368e3a68b0bb7c682caa86e331f Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 5 Aug 2026 23:29:56 +0000 Subject: [PATCH 13/17] docs: polish localized editor metadata --- editor/agent.mdx | 2 +- es/editor/agent.mdx | 4 ++-- zh/editor/agent.mdx | 4 ++-- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/editor/agent.mdx b/editor/agent.mdx index 9b6ae58938..1c8ead99cc 100644 --- a/editor/agent.mdx +++ b/editor/agent.mdx @@ -1,5 +1,5 @@ --- -title: "Use the editor's AI agent to edit pages" +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"] --- diff --git a/es/editor/agent.mdx b/es/editor/agent.mdx index 41fd53af06..ea21c5a4ab 100644 --- a/es/editor/agent.mdx +++ b/es/editor/agent.mdx @@ -194,9 +194,9 @@ Ejemplos de prompts que usan code mode:
-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. +Cuando abra el editor desde una ejecución de automatización completada al hacer 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ó. 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 qué páginas 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.` diff --git a/zh/editor/agent.mdx b/zh/editor/agent.mdx index bc8f25207d..02707eb366 100644 --- a/zh/editor/agent.mdx +++ b/zh/editor/agent.mdx @@ -1,5 +1,5 @@ --- -title: "使用编辑器 AI 代理编辑和管理页面" +title: "使用编辑器 AI 代理编辑和管理页面、更新导航、运行命令、管理私有页面并配置 Mintlify 站点" description: "了解如何使用编辑器的 AI 代理编辑和管理页面、更新导航、运行 bash 命令、处理私有页面并配置 Mintlify 站点。本文介绍私有页面权限、UUID 文件路径、页面发布方式、工具活动标签以及自动化运行管理，并说明如何附加文件、查看更改、查看会话历史以及设置 AI 指令。" keywords: ["编辑器", "AI", "助手", "代理", "聊天", "code mode", "文件上传"] --- @@ -73,7 +73,7 @@ keywords: ["编辑器", "AI", "助手", "代理", "聊天", "code mode", "文件 代理可以在整个仓库中搜索，而不仅限于你当前打开的页面。可借助它查找信息、检查不一致之处，或在添加内容前确认内容是否已经存在。 -
+
### 更新导航和 docs.json
From 30c3f4ccac2764a4878c26d1b7d01841e57db5d0 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 6 Aug 2026 00:46:35 +0000 Subject: [PATCH 14/17] docs: document private pages availability --- editor/agent.mdx | 2 +- es/editor/agent.mdx | 2 +- fr/editor/agent.mdx | 2 +- zh/editor/agent.mdx | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/editor/agent.mdx b/editor/agent.mdx index 1c8ead99cc..7812d2b406 100644 --- a/editor/agent.mdx +++ b/editor/agent.mdx @@ -73,7 +73,7 @@ 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. +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. diff --git a/es/editor/agent.mdx b/es/editor/agent.mdx index ea21c5a4ab..20f9874772 100644 --- a/es/editor/agent.mdx +++ b/es/editor/agent.mdx @@ -115,7 +115,7 @@ Ejemplo: `find every page that mentions the deprecated /v1/auth endpoint`
-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. +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. diff --git a/fr/editor/agent.mdx b/fr/editor/agent.mdx index de07b3be66..4f974c120b 100644 --- a/fr/editor/agent.mdx +++ b/fr/editor/agent.mdx @@ -115,7 +115,7 @@ Exemple : `find every page that mentions the deprecated /v1/auth endpoint`
-Si vous avez accès aux pages privées, l'agent peut les lire et les modifier depuis la racine des pages privées. Utilisez cette fonctionnalité lorsque vous devez examiner ou mettre à jour du contenu qui ne doit pas apparaître dans votre navigation publique. +Si vous avez accès aux pages privées, l'agent peut les lire et les modifier depuis la racine des pages privées. Utilisez cette fonctionnalité lorsque vous devez examiner ou mettre à jour du contenu qui ne doit pas apparaître dans votre navigation publique. Les pages privées sont disponibles dans l'éditeur sans activation d'un indicateur de fonctionnalité supplémentaire. Votre rôle et les autorisations de chaque page déterminent toujours les pages auxquelles vous pouvez accéder et les modifications que vous pouvez effectuer. Vous pouvez ouvrir l'agent depuis l'éditeur de pages privées. Le bouton de l'agent est masqué pour les utilisateurs ayant le rôle de viewer. La navigation privée s'actualise lorsque l'agent ou un autre éditeur modifie l'arborescence des pages privées. diff --git a/zh/editor/agent.mdx b/zh/editor/agent.mdx index 02707eb366..6ce0b68454 100644 --- a/zh/editor/agent.mdx +++ b/zh/editor/agent.mdx @@ -93,7 +93,7 @@ keywords: ["编辑器", "AI", "助手", "代理", "聊天", "code mode", "文件 ### 处理私有页面
-如果你有权访问私有页面，代理可以从私有页面根目录读取和编辑这些页面。当你需要查看或更新不应出现在公共导航中的内容时，可以使用此功能。 +如果你有权访问私有页面，代理可以从私有页面根目录读取和编辑这些页面。当你需要查看或更新不应出现在公共导航中的内容时，可以使用此功能。编辑器无需额外启用功能开关即可使用私有页面。你的角色和页面权限仍决定你可以访问和修改哪些页面。 你可以从私有页面编辑器中打开代理。具有 viewer 角色的用户不会看到代理按钮。当代理或其他编辑者更改私有页面树时，私有导航会自动刷新。 From d5e72807cad146b6bc7894882453cdb1b9a9d208 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 6 Aug 2026 00:50:06 +0000 Subject: [PATCH 15/17] docs: polish translated editor prose --- es/editor/agent.mdx | 2 +- fr/editor/agent.mdx | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/es/editor/agent.mdx b/es/editor/agent.mdx index 20f9874772..0835cc4c6d 100644 --- a/es/editor/agent.mdx +++ b/es/editor/agent.mdx @@ -194,7 +194,7 @@ Ejemplos de prompts que usan code mode: -Cuando abra el editor desde una ejecución de automatización completada al hacer 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ó. Haga 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 y 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ó. Puede pedirle que refine o amplíe el trabajo de la automatización sin tener que volver a explicar el contexto. diff --git a/fr/editor/agent.mdx b/fr/editor/agent.mdx index 4f974c120b..9977d374e4 100644 --- a/fr/editor/agent.mdx +++ b/fr/editor/agent.mdx @@ -4,7 +4,7 @@ description: "Découvrez comment utiliser l'agent IA de l'éditeur pour modifier keywords: ["editor", "AI", "assistant", "agent", "chat", "code mode", "file upload"] --- -L'éditeur inclut un agent intégré qui peut modifier des pages, réorganiser la navigation, mettre à jour `docs.json`, effectuer des recherches dans l'ensemble de votre référentiel et gérer les paramètres du tableau de bord. +L'éditeur inclut un agent intégré. Il peut modifier des pages, réorganiser la navigation, mettre à jour `docs.json`, effectuer des recherches dans l'ensemble de votre référentiel et gérer les paramètres du tableau de bord. L'agent de l'éditeur effectue les modifications directement sur votre branche actuelle. @@ -119,7 +119,7 @@ Si vous avez accès aux pages privées, l'agent peut les lire et les modifier de Vous pouvez ouvrir l'agent depuis l'éditeur de pages privées. Le bouton de l'agent est masqué pour les utilisateurs ayant le rôle de viewer. La navigation privée s'actualise lorsque l'agent ou un autre éditeur modifie l'arborescence des pages privées. -Vous pouvez également cliquer avec le bouton droit sur l'en-tête de la section **Private** dans la barre latérale pour créer une page ou un dossier privé si vous disposez des autorisations nécessaires. +Si vous disposez des autorisations nécessaires, cliquez avec le bouton droit sur l'en-tête de la section **Private** dans la barre latérale. Vous pouvez ainsi créer une page ou un dossier privé. Lorsque l'agent utilise une page privée, les libellés de ses outils affichent le titre de la page au lieu du nom de fichier basé sur l'UUID. From 66abca44ddc547155c2ddb880531b80591115363 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 8 Aug 2026 00:12:38 +0000 Subject: [PATCH 16/17] docs: document private page promotion UI --- editor/agent.mdx | 2 ++ es/editor/agent.mdx | 2 ++ fr/editor/agent.mdx | 2 ++ zh/editor/agent.mdx | 2 ++ 4 files changed, 8 insertions(+) diff --git a/editor/agent.mdx b/editor/agent.mdx index 7812d2b406..8ee11466dc 100644 --- a/editor/agent.mdx +++ b/editor/agent.mdx @@ -79,6 +79,8 @@ You can open the agent from the private page editor. The agent button is hidden 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. diff --git a/es/editor/agent.mdx b/es/editor/agent.mdx index 0835cc4c6d..899ea1f689 100644 --- a/es/editor/agent.mdx +++ b/es/editor/agent.mdx @@ -121,6 +121,8 @@ Puede abrir el agente desde el editor de páginas privadas. El botón del agente 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. diff --git a/fr/editor/agent.mdx b/fr/editor/agent.mdx index 9977d374e4..0af8562d22 100644 --- a/fr/editor/agent.mdx +++ b/fr/editor/agent.mdx @@ -121,6 +121,8 @@ Vous pouvez ouvrir l'agent depuis l'éditeur de pages privées. Le bouton de l'a Si vous disposez des autorisations nécessaires, cliquez avec le bouton droit sur l'en-tête de la section **Private** dans la barre latérale. Vous pouvez ainsi créer une page ou un dossier privé. +Pour promouvoir une page ou un dossier privé depuis la barre latérale, ouvrez son menu **More options** et sélectionnez **Promote to workspace**. L'action est disponible pour les éléments de votre section **Private** si vous disposez de l'accès **Manager** à l'élément et à tous ses descendants. Après confirmation, Mintlify ajoute la page ou le dossier à la racine de l'espace de travail. La promotion d'un dossier inclut tous les dossiers et pages imbriqués, recrée leur structure et copie leur contenu. Mintlify génère les chemins des pages à partir de leurs titres et résout automatiquement les chemins en double. La boîte de dialogue de confirmation indique que la promotion est définitive. Vous ne pouvez pas déplacer le contenu promu vers des pages privées. + Lorsque l'agent utilise une page privée, les libellés de ses outils affichent le titre de la page au lieu du nom de fichier basé sur l'UUID. Lorsque vous ouvrez une page privée, la barre d'outils de l'éditeur affiche le libellé **Edited** et indique depuis combien de temps la page a été modifiée. Le libellé se met à jour après la modification de la page. diff --git a/zh/editor/agent.mdx b/zh/editor/agent.mdx index 6ce0b68454..6a07e40e91 100644 --- a/zh/editor/agent.mdx +++ b/zh/editor/agent.mdx @@ -99,6 +99,8 @@ keywords: ["编辑器", "AI", "助手", "代理", "聊天", "code mode", "文件 如果你有创建权限，还可以右键点击侧边栏中的 **Private** 分区标题来创建私有页面或文件夹。 +要从侧边栏提升私有页面或文件夹，请打开其 **More options** 菜单，然后选择 **Promote to workspace**。此操作适用于你拥有的 **Private** 分区中的项目，且你需要对该项目及其所有后代拥有 Manager 权限。确认后，Mintlify 会将页面或文件夹添加到工作区根目录。提升文件夹时，其所有嵌套文件夹和页面也会一并提升，重新创建原有结构并复制内容。Mintlify 会根据页面标题生成路径，并自动解决重复路径。确认对话框会提示提升操作不可撤销。你无法将已提升的内容移回私有页面。 + 代理处理私有页面时，其工具活动标签会显示页面标题，而不是基于 UUID 的文件名。 打开私有页面时，编辑器工具栏会显示 **Edited** 标签，并指出距页面上次编辑经过了多长时间。编辑页面后，标签会更新。 From c1a51e6bd31010b3f18f7f3af65d3482bb5845c0 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 8 Aug 2026 00:17:19 +0000 Subject: [PATCH 17/17] docs: polish editor agent translations --- editor/agent.mdx | 5 +++-- es/editor/agent.mdx | 19 ++++++++++--------- fr/editor/agent.mdx | 13 +++++++------ zh/editor/agent.mdx | 19 ++++++++++--------- 4 files changed, 30 insertions(+), 26 deletions(-) diff --git a/editor/agent.mdx b/editor/agent.mdx index 8ee11466dc..ad2352821d 100644 --- a/editor/agent.mdx +++ b/editor/agent.mdx @@ -35,6 +35,7 @@ Example prompts: 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 @@ -146,9 +147,9 @@ Example prompts that use code mode: ### 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.` diff --git a/es/editor/agent.mdx b/es/editor/agent.mdx index 899ea1f689..0c9ad5e9b0 100644 --- a/es/editor/agent.mdx +++ b/es/editor/agent.mdx @@ -14,7 +14,7 @@ El agente del editor realiza los cambios directamente en la branch actual. -Haga clic en **Ask agent** en la barra de herramientas del editor, o presione Cmd + I (macOS) o Ctrl + I (Windows). +Haga clic en **Ask agent** en la barra de herramientas del editor o presione Cmd + I (macOS) o Ctrl + I (Windows). Para cerrar el panel, haga clic en el botón **X** del encabezado del panel o vuelva a presionar Cmd + I. @@ -24,7 +24,7 @@ Para cerrar el panel, haga clic en el botón **X** del encabezado del panel o vu -Escriba su solicitud en el cuadro de chat en la parte inferior del panel y presione Enter o haga clic en el botón de envío . +Escriba su solicitud en el cuadro de chat en la parte inferior del panel. Presione Enter o haga clic en el botón de envío . Escriba @ 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: -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 -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` @@ -144,7 +145,7 @@ ls /home/daytona/private # private-folder- ``` -Dentro de `/home/daytona/private`, `mv` cambia el padre de una página o carpeta a otra carpeta privada y conserva su nombre basado en UUID. Se requiere acceso de **Manager**. No admite renombrar páginas ni mover una carpeta dentro de sí misma: +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-.mdx \ @@ -166,7 +167,7 @@ ls /home/daytona/private 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: +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-.mdx /home/daytona/workspace/.mdx @@ -196,9 +197,9 @@ Ejemplos de prompts que usan code mode: -Al hacer clic en **Ver cambios** en una ejecución de automatización completada, el editor se abre y 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. +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ó. Puede 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.` @@ -216,4 +217,4 @@ Haga clic en el icono del reloj en el encabezado del panel para ver sus sesiones -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. diff --git a/fr/editor/agent.mdx b/fr/editor/agent.mdx index 0af8562d22..e60bffb02f 100644 --- a/fr/editor/agent.mdx +++ b/fr/editor/agent.mdx @@ -14,7 +14,7 @@ L'agent de l'éditeur effectue les modifications directement sur votre branche a -Cliquez sur **Ask agent** dans la barre d'outils de l'éditeur, ou appuyez sur Cmd + I (macOS) ou Ctrl + I (Windows). +Cliquez sur **Ask agent** dans la barre d'outils de l'éditeur ou appuyez sur Cmd + I (macOS) ou Ctrl + I (Windows). Pour fermer le panneau, cliquez sur le bouton **X** dans l'en-tête du panneau ou appuyez à nouveau sur Cmd + I. @@ -42,9 +42,10 @@ Exemples de prompts : -Cliquez sur l'icône en forme de trombone dans la zone de chat, ou faites glisser-déposer des fichiers dans le panneau. L'agent lit les fichiers joints comme contexte pour votre requête. +Cliquez sur l'icône en forme de trombone dans la zone de chat ou faites glisser-déposer des fichiers dans le panneau. L'agent lit les fichiers joints comme contexte pour votre requête. Types de fichiers pris en charge : + - **Images** : JPG, PNG, GIF, WebP, SVG - **Documents** : PDF - **Code et texte** : `.js`, `.ts`, `.jsx`, `.tsx`, `.mdx`, `.md`, `.json`, `.yaml`, `.html`, `.css`, Python, Go, Rust, Ruby, Java, Swift, C, C++, SQL, scripts shell, et plus encore @@ -95,7 +96,7 @@ L'agent peut effectuer une recherche dans l'ensemble de votre référentiel, et -L'agent peut ajouter, renommer, réordonner et supprimer des éléments de navigation, les mêmes modifications que vous feriez manuellement dans le panneau de navigation. Il peut aussi mettre à jour la configuration `docs.json` directement, y compris en ajoutant de nouveaux groupes, en ajustant des paramètres et en configurant des redirections. +L'agent peut ajouter, renommer, réordonner et supprimer des éléments de navigation. Ce sont les mêmes modifications que vous feriez manuellement dans le panneau de navigation. Il peut aussi mettre à jour la configuration `docs.json` directement, y compris en ajoutant de nouveaux groupes, en ajustant des paramètres et en configurant des redirections. Exemple : `add a "Quickstart" group under the Getting Started tab and move the quickstart page into it` @@ -155,7 +156,7 @@ mv /home/daytona/private/private-folder- \ Le déplacement d'une page de l'espace de travail vers `/home/daytona/private` n'est pas pris en charge. -Cette opération exige l'accès **Manager**. Elle conserve le nom UUID de l'élément ; `mv` ne renomme pas les pages et ne peut pas déplacer un dossier dans lui-même. +Cette opération exige l'accès **Manager**. Elle conserve le nom UUID de l'élément ; `mv` ne renomme pas les pages et ne peut pas déplacer un dossier à l'intérieur de lui-même. Pour copier une page privée, utilisez `cp` avec un nouveau titre humain comme dernier segment du chemin de destination : @@ -198,7 +199,7 @@ Exemples de prompts qui utilisent le mode code : -Lorsque vous ouvrez l'éditeur depuis une exécution d'automatisation terminée en cliquant sur **View changes**, le panneau de l'agent s'ouvre automatiquement avec le contexte de ce que l'automatisation a fait. Une carte **Pages modifiées** en haut du chat liste chaque page modifiée par l'automatisation. Cliquez sur une page pour ouvrir une vue de diff. +Lorsque vous ouvrez l'éditeur depuis une exécution d'automatisation terminée en cliquant sur **View changes**, le panneau de l'agent s'ouvre automatiquement. Il contient le contexte de ce que l'automatisation a fait. Une carte **Pages modifiées** en haut du chat liste chaque page modifiée par l'automatisation. Cliquez sur une page pour ouvrir une vue de diff. L'agent dispose du contexte du prompt de l'automatisation, d'un résumé des modifications qu'elle a effectuées et des pages qu'elle a modifiées. Vous pouvez lui demander d'affiner ou d'étendre le travail de l'automatisation sans avoir à réexpliquer le contexte. @@ -218,4 +219,4 @@ Cliquez sur l'icône d'horloge dans l'en-tête du panneau pour voir vos précéd -Pour donner à l'agent des consignes persistantes telles que des règles de voix, de terminologie ou des conventions de mise en forme, configurez des instructions d'IA dans les [Paramètres de l'éditeur](/fr/editor/settings#ai-instructions). L'agent suit ces instructions à chaque requête sans que vous ayez besoin de les répéter. +Pour donner à l'agent des consignes persistantes, configurez des instructions d'IA dans les [Paramètres de l'éditeur](/fr/editor/settings#ai-instructions). Ces consignes peuvent comprendre des règles de voix, de terminologie ou des conventions de mise en forme. L'agent suit ces instructions à chaque requête sans que vous ayez besoin de les répéter. diff --git a/zh/editor/agent.mdx b/zh/editor/agent.mdx index 6a07e40e91..eab7012624 100644 --- a/zh/editor/agent.mdx +++ b/zh/editor/agent.mdx @@ -6,13 +6,13 @@ keywords: ["编辑器", "AI", "助手", "代理", "聊天", "code mode", "文件 编辑器内置了一个代理，可以编辑页面、重新组织导航、更新 `docs.json`、在整个仓库中搜索以及管理控制台设置。 -编辑器代理会直接在你的当前 branch 中进行更改。 +编辑器代理会直接在你当前的 branch 中进行更改。
## 打开代理
-点击编辑器工具栏中的 **Ask agent**，或按 Cmd + I (macOS) 或 Ctrl + I (Windows)。 +点击编辑器工具栏中的 **Ask agent**，或按 Cmd + I（macOS）或 Ctrl + I（Windows）。 要关闭面板，请点击面板标题栏中的 **X** 按钮，或再次按 Cmd + I。 @@ -39,17 +39,18 @@ keywords: ["编辑器", "AI", "助手", "代理", "聊天", "code mode", "文件 点击聊天框中的回形针图标，或将文件拖放到面板上。代理会读取附加的文件作为请求的上下文。 支持的文件类型： + - **图像**：JPG、PNG、GIF、WebP、SVG - **文档**：PDF - **代码和文本**：`.js`、`.ts`、`.jsx`、`.tsx`、`.mdx`、`.md`、`.json`、`.yaml`、`.html`、`.css`、Python、Go、Rust、Ruby、Java、Swift、C、C++、SQL、shell 脚本等 -最大大小：每个文件 5 MB。最多：每条消息 10 个文件。 +每个文件最大为 5 MB；每条消息最多 10 个文件。
## 将选中内容添加到代理
-在可视化模式下，在页面上选中文本。选区上方会出现一个浮动工具栏。点击 **Add to agent**，将所选文本作为上下文发送给代理。 +在可视化模式下，选中页面上的文本。选区上方会出现一个浮动工具栏。点击 **Add to agent**，将所选文本作为上下文发送给代理。
## 查看代理的更改 @@ -85,7 +86,7 @@ keywords: ["编辑器", "AI", "助手", "代理", "聊天", "code mode", "文件 ### 运行 bash 命令
-代理可以对你的仓库运行 `grep`、`rg` 和其他 bash 命令。可用于跨多个文件的批量操作。 +代理可以对你的仓库运行 `grep`、`rg` 和其他 bash 命令，用于跨多个文件执行批量操作。 示例：`find every page that mentions the deprecated /v1/auth endpoint` @@ -148,13 +149,13 @@ ls /home/daytona/private mv /home/daytona/private/private-page-.mdx /home/daytona/workspace/.mdx ``` -移动操作会将该页面添加到公共导航中，并撤销其私有页面访问权限。你无需配置其他文件系统或额外授权。代理会自动使用你现有的私有页面权限。 +移动操作会将该页面添加到公共导航中，并撤销其私有页面的访问权限。你无需配置其他文件系统或额外授权。代理会自动使用你现有的私有页面权限。
- ### 配置你的站点 (code mode) + ### 配置你的站点（code mode）
-对于超出页面编辑范围的请求 (例如设置身份验证、管理工作流或更改部署设置)，代理会切换到 code mode。它会代你编写并对 Mintlify 控制台运行脚本。 +对于超出页面编辑范围的请求（例如设置身份验证、管理工作流或更改部署设置），代理会切换到 code mode。它会代你编写脚本，并在 Mintlify 控制台中运行这些脚本。 Code mode 会遵循你在控制台中的权限。如果你在控制台中无权访问某项设置，代理也无法更改它。 @@ -184,4 +185,4 @@ Code mode 会遵循你在控制台中的权限。如果你在控制台中无权 ## AI 指令 -要为代理提供持久性指引 (例如语气规则、术语或格式约定)，请在[编辑器设置](/zh/editor/settings#ai-instructions)中配置 AI 指令。代理会在每次请求时遵循这些指令，无需你重复说明。 +要为代理提供持久性指引（例如语气规则、术语或格式约定），请在[编辑器设置](/zh/editor/settings#ai-instructions)中配置 AI 指令。代理会在每次请求时遵循这些指令，无需你重复说明。