From 3be24c50f7aa8ad71bb55fd7a8e60dbb551ed512 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Mon, 24 Aug 2026 20:16:00 +0000
Subject: [PATCH 1/2] docs: document mentioning the editor agent in comments
---
editor/comments.mdx | 6 ++++++
es/editor/comments.mdx | 6 ++++++
fr/editor/comments.mdx | 6 ++++++
zh/editor/comments.mdx | 6 ++++++
4 files changed, 24 insertions(+)
diff --git a/editor/comments.mdx b/editor/comments.mdx
index aa104b931b..b3b946abad 100644
--- a/editor/comments.mdx
+++ b/editor/comments.mdx
@@ -57,6 +57,12 @@ Type `@` in a comment or reply to mention a teammate. People must be a member of
Mentioned teammates receive an email notification.
+## Mention the agent
+
+Type `@mintlify` in a comment, suggestion, or reply to mention the editor agent. The agent appears at the top of the mention list alongside your teammates.
+
+Mentioning the agent lets you ask it to respond to a thread in context. Use it to request a rewrite, ask a question about the highlighted text, or hand off a review to the agent without leaving the comment thread.
+
## Resolve a comment
Editors and admins can resolve threads when a discussion is complete.
diff --git a/es/editor/comments.mdx b/es/editor/comments.mdx
index a28f6b4fd5..5a64310013 100644
--- a/es/editor/comments.mdx
+++ b/es/editor/comments.mdx
@@ -62,6 +62,12 @@ Escribe `@` en un comentario o respuesta para mencionar a un compañero. Las per
Los compañeros mencionados reciben una notificación por correo electrónico.
+## Mencionar al agente
+
+Escribe `@mintlify` en un comentario, sugerencia o respuesta para mencionar al agente del editor. El agente aparece al inicio de la lista de menciones junto a tus compañeros.
+
+Mencionar al agente te permite pedirle que responda a un hilo en contexto. Úsalo para solicitar una reescritura, hacer una pregunta sobre el texto resaltado o delegar una revisión al agente sin salir del hilo del comentario.
+
diff --git a/fr/editor/comments.mdx b/fr/editor/comments.mdx
index fe2da9c16f..9a1fa3d21a 100644
--- a/fr/editor/comments.mdx
+++ b/fr/editor/comments.mdx
@@ -62,6 +62,12 @@ Tapez `@` dans un commentaire ou une réponse pour mentionner un coéquipier. Le
Les coéquipiers mentionnés reçoivent une notification par e-mail.
+## Mentionner l'agent
+
+Tapez `@mintlify` dans un commentaire, une suggestion ou une réponse pour mentionner l'agent de l'éditeur. L'agent apparaît en haut de la liste des mentions aux côtés de vos coéquipiers.
+
+Mentionner l'agent vous permet de lui demander de répondre à un fil en contexte. Utilisez-le pour demander une réécriture, poser une question sur le texte surligné ou déléguer une relecture à l'agent sans quitter le fil de commentaires.
+
diff --git a/zh/editor/comments.mdx b/zh/editor/comments.mdx
index c959613763..5318d5bf1c 100644
--- a/zh/editor/comments.mdx
+++ b/zh/editor/comments.mdx
@@ -62,6 +62,12 @@ keywords: ["editor", "评论", "协作", "反馈", "提及", "讨论线程"]
被提及的团队成员会收到电子邮件通知。
+## 提及 agent
+
+在评论、建议或回复中输入 `@mintlify` 即可提及编辑器 agent。agent 会与你的团队成员一起显示在提及列表的顶部。
+
+提及 agent 可以让它在上下文中回复某个讨论线程。使用它来请求改写、就高亮文本提出问题,或在不离开评论线程的情况下将审阅工作交给 agent。
+
From 35aaf9728994b9be97b73bf2ce005d266edbd372 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Mon, 24 Aug 2026 20:17:50 +0000
Subject: [PATCH 2/2] docs: wrap translated agent mention headings with anchor
divs
---
es/editor/comments.mdx | 4 +++-
fr/editor/comments.mdx | 4 +++-
zh/editor/comments.mdx | 4 +++-
3 files changed, 9 insertions(+), 3 deletions(-)
diff --git a/es/editor/comments.mdx b/es/editor/comments.mdx
index 5a64310013..4720681dfe 100644
--- a/es/editor/comments.mdx
+++ b/es/editor/comments.mdx
@@ -62,7 +62,9 @@ Escribe `@` en un comentario o respuesta para mencionar a un compañero. Las per
Los compañeros mencionados reciben una notificación por correo electrónico.
-## Mencionar al agente
+
+ ## Mencionar al agente
+
Escribe `@mintlify` en un comentario, sugerencia o respuesta para mencionar al agente del editor. El agente aparece al inicio de la lista de menciones junto a tus compañeros.
diff --git a/fr/editor/comments.mdx b/fr/editor/comments.mdx
index 9a1fa3d21a..3f24d55bc0 100644
--- a/fr/editor/comments.mdx
+++ b/fr/editor/comments.mdx
@@ -62,7 +62,9 @@ Tapez `@` dans un commentaire ou une réponse pour mentionner un coéquipier. Le
Les coéquipiers mentionnés reçoivent une notification par e-mail.
-## Mentionner l'agent
+
+ ## Mentionner l'agent
+
Tapez `@mintlify` dans un commentaire, une suggestion ou une réponse pour mentionner l'agent de l'éditeur. L'agent apparaît en haut de la liste des mentions aux côtés de vos coéquipiers.
diff --git a/zh/editor/comments.mdx b/zh/editor/comments.mdx
index 5318d5bf1c..596156f424 100644
--- a/zh/editor/comments.mdx
+++ b/zh/editor/comments.mdx
@@ -62,7 +62,9 @@ keywords: ["editor", "评论", "协作", "反馈", "提及", "讨论线程"]
被提及的团队成员会收到电子邮件通知。
-## 提及 agent
+
+ ## 提及 agent
+
在评论、建议或回复中输入 `@mintlify` 即可提及编辑器 agent。agent 会与你的团队成员一起显示在提及列表的顶部。