From 4a4604543fcfc668223cf2e11fb692e1f96427d0 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 1 Jul 2026 23:20:29 +0000 Subject: [PATCH 1/3] docs: document agent publishing options --- agent/index.mdx | 17 ++++++++++++++--- agent/slack.mdx | 6 +++--- 2 files changed, 17 insertions(+), 6 deletions(-) diff --git a/agent/index.mdx b/agent/index.mdx index da2f91c3b7..40f169613a 100644 --- a/agent/index.mdx +++ b/agent/index.mdx @@ -12,9 +12,7 @@ The agent is an AI tool that creates pull requests with proposed changes to your - **Plans**: Creates a structured task list for complex documentation work. - **Writes**: Generates or updates content following writing standards and best practices. - **Validates**: Runs Mintlify CLI checks to ensure documentation builds correctly. -- **Creates a PR**: Opens a pull request with proposed changes for review. - -All changes go through pull requests. The agent never commits directly to your main branch. +- **Publishes changes**: Opens a pull request with proposed changes for review, or commits directly to your deploy branch, depending on your [review process setting](#choose-how-the-agent-publishes-changes). ## What you can do with the agent @@ -36,6 +34,19 @@ Use the agent to: By default, the agent opens pull requests attributed to the Mintlify bot. To attribute pull requests to you, connect your GitHub account on the [My profile](https://app.mintlify.com/settings/account) page of the dashboard. +## Choose how the agent publishes changes + +By default, the agent opens a pull request for every change so your team can review it before it ships. If your deployment is hosted by Mintlify, the agent commits changes directly to your deploy branch so they publish immediately. + +For deployments connected to your own Git provider, you can choose how the agent publishes changes on the [Agent](https://app.mintlify.com/products/agent) page of your dashboard: + +- **Create a pull request**: The agent commits to a new branch and opens a pull request against your deploy branch. Use this option when you want a human to review changes before they publish. +- **Push to deploy branch**: The agent commits directly to your deploy branch, and changes publish as soon as the agent finishes. Use this option when you trust the agent to publish without review, for example on a staging deployment. + + + If your deploy branch has branch protection rules that block direct pushes, the agent falls back to opening a pull request even when **Push to deploy branch** is selected. + + ## Connect repositories as context The agent can only access repositories that you connect through the Mintlify GitHub App. Configure which repositories the agent can access in the agent panel **Settings** or in the [GitHub App settings](https://github.com/apps/mintlify/installations/new). diff --git a/agent/slack.mdx b/agent/slack.mdx index 12f41f8658..490f83a3ab 100644 --- a/agent/slack.mdx +++ b/agent/slack.mdx @@ -86,7 +86,7 @@ Use the agent to update your documentation with a new request or in an existing - **Existing thread**: Reply in the thread and mention `@mintlify` with instructions on what to update. - **With attachments**: Upload images, diagrams, code files, or other documents with your message. The agent automatically processes and includes them in your documentation. In a thread, the agent has access to images and files shared in earlier messages, so you can reference them in follow-up requests without reuploading. -The agent reads the context of the request or thread and creates a pull request in your connected repository with the updates. +The agent reads the context of the request or thread and updates your connected repository. Depending on your [review process setting](/agent/index#choose-how-the-agent-publishes-changes), the agent either opens a pull request or commits directly to your deploy branch. ## Reference other repositories @@ -100,7 +100,7 @@ Example prompts: - "Document the new endpoints added in `acme/backend#1234`." - "What repositories do you have access to?" -The agent treats cloned repositories as read-only. It uses them for context, but always opens pull requests against your documentation repository. +The agent treats cloned repositories as read-only. It uses them for context, but only writes changes to your documentation repository. ## Track progress in real time @@ -111,7 +111,7 @@ When the agent is making changes to your documentation, it provides live feedbac - **Questions**: If the agent needs more information, it presents options for you to select from or reply in the thread with a custom answer. - **Permission requests**: Before the agent runs a third-party action that writes data, such as sending an email or creating a ticket, it asks you to approve or deny the action. The permission request is only visible to the person who triggered the request. Click **Approve** to let the agent proceed or **Deny** to cancel the action. - **Interruptions**: If you send a follow-up message while the agent is still working, it stops the current task and starts on the new one. -- **Completion**: When the agent finishes, it posts a summary with a link to the pull request and a link to open the changes in the web editor. +- **Completion**: When the agent finishes, it posts a summary with a link to the pull request or commit and a link to open the changes in the web editor. ## Roles and permissions From e6c6e82366fb7b3c659baa75aa62d4dedfbde598 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 1 Jul 2026 23:25:57 +0000 Subject: [PATCH 2/3] docs: translate agent publishing options to es, fr, zh --- es/agent/index.mdx | 19 ++++++++++++++++--- es/agent/slack.mdx | 6 +++--- fr/agent/index.mdx | 19 ++++++++++++++++--- fr/agent/slack.mdx | 6 +++--- zh/agent/index.mdx | 19 ++++++++++++++++--- zh/agent/slack.mdx | 6 +++--- 6 files changed, 57 insertions(+), 18 deletions(-) diff --git a/es/agent/index.mdx b/es/agent/index.mdx index 3f9c2cc5f5..e22b253dfb 100644 --- a/es/agent/index.mdx +++ b/es/agent/index.mdx @@ -10,9 +10,7 @@ El agente es una herramienta de IA que crea solicitudes de extracción (pull req * **Planifica**: Crea una lista de tareas estructurada para trabajos de documentación complejos. * **Escribe**: Genera o actualiza contenido siguiendo los estándares y las mejores prácticas de redacción. * **Valida**: Ejecuta comprobaciones con Mintlify CLI para asegurarse de que la documentación se compile correctamente. -* **Crea una PR**: Abre una solicitud de extracción con cambios propuestos para revisión. - -Todos los cambios pasan por solicitudes de extracción (pull requests). El agente nunca realiza confirmaciones directamente en tu branch principal. +* **Publica los cambios**: Abre una solicitud de extracción con los cambios propuestos para revisión, o realiza confirmaciones directamente en tu branch de despliegue, según tu [ajuste de proceso de revisión](/es/agent/index#choose-how-the-agent-publishes-changes).
## Qué puedes hacer con el agente @@ -38,6 +36,21 @@ Usa el agente para: De forma predeterminada, el agente abre solicitudes de extracción a nombre del bot de Mintlify. Para que las solicitudes de extracción se atribuyan a ti, conecta tu cuenta de GitHub en la página [Mi perfil](https://dashboard.mintlify.com/settings/account) del dashboard. +
+ ## Elige cómo publica los cambios el agente +
+ +De forma predeterminada, el agente abre una solicitud de extracción para cada cambio, de modo que tu equipo pueda revisarla antes de que se publique. Si Mintlify aloja tu despliegue, el agente realiza confirmaciones directamente en tu branch de despliegue para que se publiquen de inmediato. + +Para los despliegues conectados a tu propio proveedor de Git, puedes elegir cómo publica los cambios el agente en la página [Agent](https://app.mintlify.com/products/agent) del dashboard: + +- **Crear una solicitud de extracción**: El agente realiza confirmaciones en un branch nuevo y abre una solicitud de extracción contra tu branch de despliegue. Usa esta opción cuando quieras que una persona revise los cambios antes de que se publiquen. +- **Enviar al branch de despliegue**: El agente realiza confirmaciones directamente en tu branch de despliegue, y los cambios se publican en cuanto el agente termina. Usa esta opción cuando confíes en que el agente publique sin revisión, por ejemplo en un despliegue de staging. + + + Si tu branch de despliegue tiene reglas de protección de branch que bloquean los envíos directos, el agente recurre a abrir una solicitud de extracción aunque hayas seleccionado **Enviar al branch de despliegue**. + +
## Conecta repositorios como contexto
diff --git a/es/agent/slack.mdx b/es/agent/slack.mdx index 3327d02b0c..06314dbbde 100644 --- a/es/agent/slack.mdx +++ b/es/agent/slack.mdx @@ -96,7 +96,7 @@ Utiliza el agente para actualizar tu documentación mediante una nueva solicitud - **Hilo existente**: Responde en el hilo y menciona `@mintlify` con instrucciones sobre qué actualizar. - **Con archivos adjuntos**: Sube imágenes, diagramas, archivos de código u otros documentos junto con tu mensaje. El agente los procesa automáticamente y los incluye en tu documentación. En un hilo, el agente tiene acceso a las imágenes y archivos compartidos en mensajes anteriores, por lo que puedes hacer referencia a ellos en las solicitudes posteriores sin necesidad de volver a subirlos. -El agente lee el contexto de la solicitud o del hilo y crea una solicitud de extracción en tu repositorio conectado con las actualizaciones. +El agente lee el contexto de la solicitud o del hilo y actualiza tu repositorio conectado. Según tu [ajuste de proceso de revisión](/es/agent/index#choose-how-the-agent-publishes-changes), el agente abre una solicitud de extracción o realiza confirmaciones directamente en tu branch de despliegue.
## Hacer referencia a otros repositorios @@ -112,7 +112,7 @@ Ejemplos de prompts: - "Documenta los nuevos endpoints añadidos en `acme/backend#1234`." - "¿A qué repositorios tienes acceso?" -Los repositorios clonados son de solo lectura. El agente los utiliza como contexto, pero siempre abre solicitudes de extracción contra tu repositorio de documentación. +Los repositorios clonados son de solo lectura. El agente los utiliza como contexto, pero solo escribe cambios en tu repositorio de documentación.
## Sigue el progreso en tiempo real @@ -125,7 +125,7 @@ Mientras el agente trabaja en tu solicitud, proporciona retroalimentación en vi - **Preguntas**: Si el agente necesita más información, presenta opciones para que selecciones o respondas en el hilo con una respuesta personalizada. - **Solicitudes de permiso**: Antes de que el agente ejecute una acción de terceros que escribe datos, como enviar un correo o crear un ticket, te pide que apruebes o rechaces la acción. La tarjeta de aprobación se envía como un mensaje efímero visible solo para ti, la persona que activó la solicitud, para no interrumpir a otros participantes del hilo. Haz clic en **Approve** para que el agente continúe o en **Deny** para cancelar la acción. - **Interrupciones**: Si envías un mensaje de seguimiento mientras el agente aún está trabajando, detiene la tarea actual y comienza con la nueva. -- **Finalización**: Cuando el agente termina, publica un resumen con un enlace a la solicitud de extracción y un enlace para abrir los cambios en el editor web. +- **Finalización**: Cuando el agente termina, publica un resumen con un enlace a la solicitud de extracción o al commit y un enlace para abrir los cambios en el editor web.
## Roles y permisos diff --git a/fr/agent/index.mdx b/fr/agent/index.mdx index ed61f9a407..8c6e48ecd7 100644 --- a/fr/agent/index.mdx +++ b/fr/agent/index.mdx @@ -10,9 +10,7 @@ L'agent est un outil d'IA qui crée des pull requests (demandes de fusion) avec * **Planifie** : crée une liste de tâches structurée pour les travaux de documentation complexes. * **Rédige** : génère ou met à jour du contenu en suivant les standards de rédaction et les bonnes pratiques. * **Valide** : exécute les vérifications de l'Interface en ligne de commande (CLI) Mintlify pour s'assurer que la documentation se génère correctement. -* **Crée une PR** : ouvre une pull request (demande de fusion) avec les modifications proposées pour relecture. - -Tous les changements passent par des pull requests (demandes de fusion). L'agent ne fait jamais de commit directement sur votre branche principale. +* **Publie les modifications** : ouvre une pull request (demande de fusion) avec les modifications proposées pour relecture, ou pousse les modifications directement sur votre branche de déploiement, selon votre [paramètre de processus de relecture](/fr/agent/index#choose-how-the-agent-publishes-changes).
## Ce que vous pouvez faire avec l’agent @@ -38,6 +36,21 @@ Utilisez l’agent pour : Par défaut, l'agent ouvre des pull requests (demandes de fusion) attribuées au bot Mintlify. Pour que les pull requests vous soient attribuées, connectez votre compte GitHub depuis la page [My profile](https://dashboard.mintlify.com/settings/account) du Dashboard. +
+ ## Choisissez comment l'agent publie les modifications +
+ +Par défaut, l'agent ouvre une pull request pour chaque modification afin que votre équipe puisse la relire avant sa mise en ligne. Si Mintlify héberge votre déploiement, l'agent pousse les modifications directement sur votre branche de déploiement pour qu'elles soient publiées immédiatement. + +Pour les déploiements connectés à votre propre fournisseur Git, vous pouvez choisir comment l'agent publie les modifications sur la page [Agent](https://app.mintlify.com/products/agent) de votre Dashboard : + +- **Créer une pull request** : L'agent pousse ses commits sur une nouvelle branche et ouvre une pull request contre votre branche de déploiement. Utilisez cette option lorsque vous souhaitez qu'une personne relise les modifications avant leur mise en ligne. +- **Pousser sur la branche de déploiement** : L'agent pousse ses commits directement sur votre branche de déploiement, et les modifications sont publiées dès que l'agent a terminé. Utilisez cette option lorsque vous faites confiance à l'agent pour publier sans relecture, par exemple sur un déploiement de staging. + + + Si votre branche de déploiement est protégée par des règles qui bloquent les push directs, l'agent revient à l'ouverture d'une pull request même lorsque **Pousser sur la branche de déploiement** est sélectionné. + +
## Connecter des dépôts en tant que contexte
diff --git a/fr/agent/slack.mdx b/fr/agent/slack.mdx index 416a40c364..e60df6df82 100644 --- a/fr/agent/slack.mdx +++ b/fr/agent/slack.mdx @@ -97,7 +97,7 @@ Utilisez l'agent pour mettre à jour votre documentation au moyen d'une nouvelle - **Fil existant** : Répondez dans le fil et mentionnez `@mintlify` avec des instructions sur ce qu'il faut mettre à jour. - **Avec des pièces jointes** : Téléversez des images, des diagrammes, des fichiers de code ou d'autres documents avec votre message. L'agent les traite automatiquement et les inclut dans votre documentation. Dans un fil, l'agent a accès aux images et fichiers partagés dans les messages précédents, vous pouvez donc y faire référence dans les demandes suivantes sans avoir à les téléverser à nouveau. -L'agent lit le contexte de la demande ou du fil et crée une pull request (demande de fusion) dans votre référentiel connecté avec les mises à jour. +L'agent lit le contexte de la demande ou du fil et met à jour votre référentiel connecté. Selon votre [paramètre de processus de relecture](/fr/agent/index#choose-how-the-agent-publishes-changes), l'agent ouvre une pull request (demande de fusion) ou pousse les modifications directement sur votre branche de déploiement.
## Référencer d'autres dépôts @@ -113,7 +113,7 @@ Exemples de prompts : - « Documentez les nouveaux endpoints ajoutés dans `acme/backend#1234`. » - « À quels dépôts avez-vous accès ? » -Les dépôts clonés sont en lecture seule. L'agent les utilise comme contexte, mais ouvre toujours des pull requests (demandes de fusion) sur votre dépôt de documentation. +Les dépôts clonés sont en lecture seule. L'agent les utilise comme contexte, mais n'écrit des modifications que dans votre dépôt de documentation.
## Suivez la progression en temps réel @@ -126,7 +126,7 @@ Pendant que l'agent travaille sur votre demande, il fournit un retour en direct - **Questions** : Si l'agent a besoin de plus d'informations, il présente des options parmi lesquelles vous pouvez choisir ou vous pouvez répondre dans le fil avec une réponse personnalisée. - **Demandes d'autorisation** : Avant que l'agent n'exécute une action tierce qui écrit des données, comme envoyer un e-mail ou créer un ticket, il vous demande d'approuver ou de refuser l'action. La carte d'approbation est envoyée sous forme de message éphémère visible uniquement par vous, la personne qui a déclenché la demande, afin de ne pas interrompre les autres participants du fil. Cliquez sur **Approve** pour laisser l'agent continuer ou sur **Deny** pour annuler l'action. - **Interruptions** : Si vous envoyez un message de suivi pendant que l'agent travaille encore, il arrête la tâche en cours et commence la nouvelle. -- **Achèvement** : Lorsque l'agent a terminé, il publie un résumé avec un lien vers la pull request (demande de fusion) et un lien pour ouvrir les modifications dans l'éditeur web. +- **Achèvement** : Lorsque l'agent a terminé, il publie un résumé avec un lien vers la pull request (demande de fusion) ou le commit et un lien pour ouvrir les modifications dans l'éditeur web.
## Rôles et autorisations diff --git a/zh/agent/index.mdx b/zh/agent/index.mdx index bdb35cbbec..de6f63f7a3 100644 --- a/zh/agent/index.mdx +++ b/zh/agent/index.mdx @@ -10,9 +10,7 @@ agent 是一款 AI 工具，会根据你的提示，为文档创建包含建议 * **规划**：为复杂的文档工作创建结构化任务清单。 * **撰写**：生成或更新内容，遵循写作规范和最佳实践。 * **验证**：运行 Mintlify 命令行界面 (CLI) 检查，确保文档可以正确构建。 -* **创建 PR**：打开一个包含建议更改的拉取请求 (PR；亦称“合并请求”/Merge Request) ，供你审核。 - -所有更改都会通过拉取请求完成。agent 永远不会直接向你的主 branch 进行提交。 +* **发布更改**：打开一个包含建议更改的拉取请求 (PR；亦称“合并请求”/Merge Request) 供你审核，或直接向你的部署 branch 提交，具体取决于你的[审核流程设置](/zh/agent/index#choose-how-the-agent-publishes-changes)。
## 你可以用智能助手做什么 @@ -38,6 +36,21 @@ agent 是一款 AI 工具，会根据你的提示，为文档创建包含建议 默认情况下，代理会以 Mintlify 机器人身份创建拉取请求 (PR；亦称“合并请求”/Merge Request) 。若要将拉取请求归属到你的账号，请在控制台的 [My profile](https://dashboard.mintlify.com/settings/account) 页面连接你的 GitHub 账户。 +
+ ## 选择 agent 如何发布更改 +
+ +默认情况下，agent 会为每次更改打开一个拉取请求，以便你的团队在更改发布前进行审核。如果你的部署由 Mintlify 托管，agent 会将更改直接提交到你的部署 branch，使其立即发布。 + +对于连接到你自有 Git 提供商的部署，你可以在控制台的 [Agent](https://app.mintlify.com/products/agent) 页面选择 agent 如何发布更改： + +- **创建拉取请求**：agent 在新的 branch 上提交更改，并针对你的部署 branch 打开拉取请求。当你希望有人在更改发布前进行审核时，请使用此选项。 +- **推送到部署 branch**：agent 直接向你的部署 branch 提交更改，agent 完成后更改立即发布。当你信任 agent 无需审核即可发布时（例如在预发布环境的部署中），请使用此选项。 + + + 如果你的部署 branch 设置了阻止直接推送的分支保护规则，即使选择了 **推送到部署 branch**，agent 也会回退到打开拉取请求。 + +
## 将仓库连接为上下文
diff --git a/zh/agent/slack.mdx b/zh/agent/slack.mdx index 35018f47d7..39d3655698 100644 --- a/zh/agent/slack.mdx +++ b/zh/agent/slack.mdx @@ -85,7 +85,7 @@ keywords: ["Slack 集成", "Slack 机器人", "团队协作", "agent 集成", " - **现有线程**：在该线程中回复并提及 `@mintlify`，并说明需要更新的内容。 - **包含附件**：在消息中上传图片、图表、代码文件或其他文档。智能体会自动处理这些附件，并将其内容纳入你的文档中。在线程中，智能体可以访问较早消息中共享的图片和文件，因此你可以在后续请求中引用它们，无需再次上传。 -智能体会读取请求或线程的上下文，并在你已连接的存储库中创建一个包含这些更新的拉取请求（PR；亦称"合并请求"/Merge Request）。 +智能体会读取请求或线程的上下文，并更新你已连接的存储库。根据你的[审核流程设置](/zh/agent/index#choose-how-the-agent-publishes-changes)，智能体会打开拉取请求（PR；亦称"合并请求"/Merge Request）或直接向你的部署 branch 提交。
## 引用其他仓库 @@ -101,7 +101,7 @@ keywords: ["Slack 集成", "Slack 机器人", "团队协作", "agent 集成", " - "为 `acme/backend#1234` 中新增的端点编写文档。" - "你可以访问哪些仓库？" -克隆的仓库为只读。智能体将它们用作上下文，但始终会针对你的文档仓库提交拉取请求（PR；亦称"合并请求"/Merge Request）。 +克隆的仓库为只读。智能体将它们用作上下文，但只会将更改写入你的文档仓库。
## 实时跟踪进度 @@ -114,7 +114,7 @@ keywords: ["Slack 集成", "Slack 机器人", "团队协作", "agent 集成", " - **提问**：如果智能体需要更多信息，它会列出选项供你选择，或者你可以在线程中回复自定义答案。 - **权限请求**：在智能体执行需要写入数据的第三方操作之前（例如发送邮件或创建工单），它会请求你批准或拒绝该操作。审批卡片以临时消息的形式发送，仅对你（即发起请求的人）可见，因此不会打扰线程中的其他参与者。点击 **Approve** 让智能体继续执行，或点击 **Deny** 取消该操作。 - **中断**：如果你在智能体仍在工作时发送后续消息，它会停止当前任务并开始处理新任务。 -- **完成**：当智能体完成后，它会发布一份摘要，其中包含指向拉取请求（PR）的链接和在 Web 编辑器中打开更改的链接。 +- **完成**：当智能体完成后，它会发布一份摘要，其中包含指向拉取请求（PR）或提交的链接和在 Web 编辑器中打开更改的链接。
## 角色与权限 From c9635c8992cd64cecf58ea0e74aebb96e866b6c3 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 2 Jul 2026 16:48:58 +0000 Subject: [PATCH 3/3] docs: align review process wording with dashboard labels --- agent/index.mdx | 6 +++--- es/agent/index.mdx | 8 ++++---- fr/agent/index.mdx | 8 ++++---- zh/agent/index.mdx | 8 ++++---- 4 files changed, 15 insertions(+), 15 deletions(-) diff --git a/agent/index.mdx b/agent/index.mdx index 40f169613a..922603c8ff 100644 --- a/agent/index.mdx +++ b/agent/index.mdx @@ -38,13 +38,13 @@ By default, the agent opens pull requests attributed to the Mintlify bot. To att By default, the agent opens a pull request for every change so your team can review it before it ships. If your deployment is hosted by Mintlify, the agent commits changes directly to your deploy branch so they publish immediately. -For deployments connected to your own Git provider, you can choose how the agent publishes changes on the [Agent](https://app.mintlify.com/products/agent) page of your dashboard: +For deployments connected to your own Git provider, you can change how the agent publishes changes in the **Review process** setting on the [Agent](https://app.mintlify.com/products/agent) page of your dashboard: - **Create a pull request**: The agent commits to a new branch and opens a pull request against your deploy branch. Use this option when you want a human to review changes before they publish. -- **Push to deploy branch**: The agent commits directly to your deploy branch, and changes publish as soon as the agent finishes. Use this option when you trust the agent to publish without review, for example on a staging deployment. +- **Push to main**: The agent commits directly to your deploy branch, and changes publish as soon as the agent finishes. Use this option when you trust the agent to publish without review, for example on a staging deployment. - If your deploy branch has branch protection rules that block direct pushes, the agent falls back to opening a pull request even when **Push to deploy branch** is selected. + If your deploy branch has branch protection rules that block direct pushes, the **Review process** setting is hidden and the agent always opens a pull request. ## Connect repositories as context diff --git a/es/agent/index.mdx b/es/agent/index.mdx index e22b253dfb..1b53873c7c 100644 --- a/es/agent/index.mdx +++ b/es/agent/index.mdx @@ -42,13 +42,13 @@ De forma predeterminada, el agente abre solicitudes de extracción a nombre del De forma predeterminada, el agente abre una solicitud de extracción para cada cambio, de modo que tu equipo pueda revisarla antes de que se publique. Si Mintlify aloja tu despliegue, el agente realiza confirmaciones directamente en tu branch de despliegue para que se publiquen de inmediato. -Para los despliegues conectados a tu propio proveedor de Git, puedes elegir cómo publica los cambios el agente en la página [Agent](https://app.mintlify.com/products/agent) del dashboard: +Para los despliegues conectados a tu propio proveedor de Git, puedes cambiar cómo publica los cambios el agente en el ajuste **Review process** de la página [Agent](https://app.mintlify.com/products/agent) del dashboard: -- **Crear una solicitud de extracción**: El agente realiza confirmaciones en un branch nuevo y abre una solicitud de extracción contra tu branch de despliegue. Usa esta opción cuando quieras que una persona revise los cambios antes de que se publiquen. -- **Enviar al branch de despliegue**: El agente realiza confirmaciones directamente en tu branch de despliegue, y los cambios se publican en cuanto el agente termina. Usa esta opción cuando confíes en que el agente publique sin revisión, por ejemplo en un despliegue de staging. +- **Create a pull request**: El agente realiza confirmaciones en un branch nuevo y abre una solicitud de extracción contra tu branch de despliegue. Usa esta opción cuando quieras que una persona revise los cambios antes de que se publiquen. +- **Push to main**: El agente realiza confirmaciones directamente en tu branch de despliegue, y los cambios se publican en cuanto el agente termina. Usa esta opción cuando confíes en que el agente publique sin revisión, por ejemplo en un despliegue de staging. - Si tu branch de despliegue tiene reglas de protección de branch que bloquean los envíos directos, el agente recurre a abrir una solicitud de extracción aunque hayas seleccionado **Enviar al branch de despliegue**. + Si tu branch de despliegue tiene reglas de protección de branch que bloquean los envíos directos, el ajuste **Review process** se oculta y el agente siempre abre una solicitud de extracción.
diff --git a/fr/agent/index.mdx b/fr/agent/index.mdx index 8c6e48ecd7..1df1e37e2b 100644 --- a/fr/agent/index.mdx +++ b/fr/agent/index.mdx @@ -42,13 +42,13 @@ Par défaut, l'agent ouvre des pull requests (demandes de fusion) attribuées au Par défaut, l'agent ouvre une pull request pour chaque modification afin que votre équipe puisse la relire avant sa mise en ligne. Si Mintlify héberge votre déploiement, l'agent pousse les modifications directement sur votre branche de déploiement pour qu'elles soient publiées immédiatement. -Pour les déploiements connectés à votre propre fournisseur Git, vous pouvez choisir comment l'agent publie les modifications sur la page [Agent](https://app.mintlify.com/products/agent) de votre Dashboard : +Pour les déploiements connectés à votre propre fournisseur Git, vous pouvez modifier la façon dont l'agent publie les modifications dans le paramètre **Review process** de la page [Agent](https://app.mintlify.com/products/agent) de votre Dashboard : -- **Créer une pull request** : L'agent pousse ses commits sur une nouvelle branche et ouvre une pull request contre votre branche de déploiement. Utilisez cette option lorsque vous souhaitez qu'une personne relise les modifications avant leur mise en ligne. -- **Pousser sur la branche de déploiement** : L'agent pousse ses commits directement sur votre branche de déploiement, et les modifications sont publiées dès que l'agent a terminé. Utilisez cette option lorsque vous faites confiance à l'agent pour publier sans relecture, par exemple sur un déploiement de staging. +- **Create a pull request** : L'agent pousse ses commits sur une nouvelle branche et ouvre une pull request contre votre branche de déploiement. Utilisez cette option lorsque vous souhaitez qu'une personne relise les modifications avant leur mise en ligne. +- **Push to main** : L'agent pousse ses commits directement sur votre branche de déploiement, et les modifications sont publiées dès que l'agent a terminé. Utilisez cette option lorsque vous faites confiance à l'agent pour publier sans relecture, par exemple sur un déploiement de staging. - Si votre branche de déploiement est protégée par des règles qui bloquent les push directs, l'agent revient à l'ouverture d'une pull request même lorsque **Pousser sur la branche de déploiement** est sélectionné. + Si votre branche de déploiement est protégée par des règles qui bloquent les push directs, le paramètre **Review process** est masqué et l'agent ouvre toujours une pull request.
diff --git a/zh/agent/index.mdx b/zh/agent/index.mdx index de6f63f7a3..b9f8fae1e5 100644 --- a/zh/agent/index.mdx +++ b/zh/agent/index.mdx @@ -42,13 +42,13 @@ agent 是一款 AI 工具，会根据你的提示，为文档创建包含建议 默认情况下，agent 会为每次更改打开一个拉取请求，以便你的团队在更改发布前进行审核。如果你的部署由 Mintlify 托管，agent 会将更改直接提交到你的部署 branch，使其立即发布。 -对于连接到你自有 Git 提供商的部署，你可以在控制台的 [Agent](https://app.mintlify.com/products/agent) 页面选择 agent 如何发布更改： +对于连接到你自有 Git 提供商的部署，你可以在控制台 [Agent](https://app.mintlify.com/products/agent) 页面的 **Review process** 设置中更改 agent 发布更改的方式： -- **创建拉取请求**：agent 在新的 branch 上提交更改，并针对你的部署 branch 打开拉取请求。当你希望有人在更改发布前进行审核时，请使用此选项。 -- **推送到部署 branch**：agent 直接向你的部署 branch 提交更改，agent 完成后更改立即发布。当你信任 agent 无需审核即可发布时（例如在预发布环境的部署中），请使用此选项。 +- **Create a pull request**：agent 在新的 branch 上提交更改，并针对你的部署 branch 打开拉取请求。当你希望有人在更改发布前进行审核时，请使用此选项。 +- **Push to main**：agent 直接向你的部署 branch 提交更改，agent 完成后更改立即发布。当你信任 agent 无需审核即可发布时（例如在预发布环境的部署中），请使用此选项。 - 如果你的部署 branch 设置了阻止直接推送的分支保护规则，即使选择了 **推送到部署 branch**，agent 也会回退到打开拉取请求。 + 如果你的部署 branch 设置了阻止直接推送的分支保护规则，**Review process** 设置会被隐藏，agent 将始终打开拉取请求。