From 19c662913432daa3b6ff1f17371cc7742d60f38d Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 26 Aug 2026 18:41:09 +0000 Subject: [PATCH 1/4] docs: update automations pages for dedicated configure page --- api/automations/trigger.mdx | 2 +- automations/create.mdx | 12 ++++++------ automations/manage.mdx | 32 +++++++++++++++----------------- automations/reference.mdx | 4 ++-- es/api/automations/trigger.mdx | 2 +- es/automations/create.mdx | 12 ++++++------ es/automations/manage.mdx | 32 +++++++++++++++----------------- es/automations/reference.mdx | 4 ++-- es/guides/use-automations.mdx | 4 ++-- fr/api/automations/trigger.mdx | 2 +- fr/automations/create.mdx | 12 ++++++------ fr/automations/manage.mdx | 32 +++++++++++++++----------------- fr/automations/reference.mdx | 4 ++-- fr/guides/use-automations.mdx | 4 ++-- guides/use-automations.mdx | 4 ++-- zh/api/automations/trigger.mdx | 2 +- zh/automations/create.mdx | 12 ++++++------ zh/automations/manage.mdx | 32 +++++++++++++++----------------- zh/automations/reference.mdx | 4 ++-- zh/guides/use-automations.mdx | 4 ++-- 20 files changed, 104 insertions(+), 112 deletions(-) diff --git a/api/automations/trigger.mdx b/api/automations/trigger.mdx index 33d3805236..5eaeb8b45c 100644 --- a/api/automations/trigger.mdx +++ b/api/automations/trigger.mdx @@ -16,7 +16,7 @@ This endpoint only supports automations configured with a **Custom schedule** tr ## Find the automation ID -Copy the automation ID from the automation's settings panel on the [Automations](https://app.mintlify.com/products/automations) page in your dashboard. +Run [`mint automations list`](/cli/commands#mint-automations-list) in your terminal and copy the ID from the output. ## Example diff --git a/automations/create.mdx b/automations/create.mdx index d6a74b6a83..93a32ab69b 100644 --- a/automations/create.mdx +++ b/automations/create.mdx @@ -23,9 +23,9 @@ For an overview of triggers, update modes, and configuration options shared acro 1. Open the [Automations](https://app.mintlify.com/products/automations) page in your dashboard. -2. Click **Create a custom automation**. -3. Configure the automation name, trigger, instructions, context repositories, integrations, and update mode. For details on each field, see [Configurations](/automations/manage#configurations). -4. Click **Create automation**. +2. Click **New automation**. +3. On the configure page, set the automation name, trigger, prompt, context repositories, integrations, and update mode. For details on each field, see [Configurations](/automations/manage#configurations). +4. Click **Save**. You can also ask the [agent in Slack](/agent/slack#manage-automations) to create an automation for you by describing what you want the automation to do. @@ -50,7 +50,7 @@ For more examples and patterns, see [Use automations](/guides/use-automations). ## Edit a custom automation 1. Open the [Automations](https://app.mintlify.com/products/automations) page in your dashboard. -2. Click the settings button beside an automation. +2. Click the settings button on the automation's card to open its configure page. 3. Update any of the fields described in [Configurations](/automations/manage#configurations). 4. Click **Save**. @@ -59,5 +59,5 @@ For more examples and patterns, see [Use automations](/guides/use-automations). Deleting an automation is permanent and removes its configuration and run history. 1. Open the [Automations](https://app.mintlify.com/products/automations) page in your dashboard. -2. Click the settings button beside an automation. -3. Click **Delete**. +2. Click the settings button on the automation's card to open its configure page. +3. Click **Delete automation** at the bottom of the page and confirm. diff --git a/automations/manage.mdx b/automations/manage.mdx index f159c2a3c4..92ab595320 100644 --- a/automations/manage.mdx +++ b/automations/manage.mdx @@ -25,21 +25,16 @@ import GitlabAutomationSetup from '/snippets/gitlab-automation-setup.mdx'; The automations dashboard. - If the automation can run with default settings, it activates immediately. Otherwise, the settings panel opens so you can fill in any required configurations. - - The configuration options for an automation. - The configuration options for an automation. - -3. If the settings panel opens, fill in the required fields. -4. Click **Turn on automation**. + If the automation can run with default settings, it activates immediately. Otherwise, the automation's configure page opens so you can fill in any required configurations. +3. If the configure page opens, fill in the required fields and click **Save**. -To change settings for an active automation, click the settings button beside it. Use the toggle in the modal header to enable or disable the automation without leaving the settings view. +To change settings for an active automation, click the settings button on its card to open its configure page. Use the toggle in the page header to enable or disable the automation, and click **Save** to apply your changes. ## Configurations ### Trigger -Each automation has a default trigger that controls when it runs. To change the trigger, select a different option in the settings panel. +Each automation has a default trigger that controls when it runs. To change the trigger, select a different trigger type on the automation's configure page. - **Content update**: Runs whenever you push content to your project repository, including pull request merges and direct pushes. - **Code change**: Runs when a pull request merges in a connected source code repository. You must specify at least one source repository. @@ -50,7 +45,7 @@ Each automation has a default trigger that controls when it runs. To change the Each automation has a default mode for how it makes updates: either directly merging changes into your content repository, or opening a pull request for review. -To require a review before the automation updates your content, select **Require review** in the settings panel. +Choose the mode in the **After automation runs** section of the automation's configure page. Select **Update and merge changes** to merge changes automatically. Select **Modify and wait for review** to require a review before changes go live. For GitHub repositories, automatic updates require the Mintlify GitHub App to have bypass permissions on every ruleset targeting your deploy branch, including organization-level and repository-level rulesets. See [Configure automerge](/guides/configure-automerge) for setup instructions. @@ -68,7 +63,7 @@ You can add up to 10 context repositories per automation. For each GitHub reposi For custom automations and supported predefined automations, enable connected [integrations](/automations/integrations). The agent pulls context from shared tools like Notion, Jira, or Linear when the automation runs. -To enable integrations for an automation, open its settings and select the integrations you want to use in **Tools**. +To enable integrations for an automation, open its configure page and select the integrations you want to use in **Tools**. If you select **Integration** as the trigger for a custom automation, the triggering integration is always a tool for that automation. See [Integrations](/automations/integrations) for connection scopes, supported events, and permissions. @@ -100,7 +95,7 @@ When you enable the **Translate content** automation, select one or more languag - You must select at least one target language to save the automation. - You cannot select the source language as a target. -You can add target languages at any time by opening the automation's settings and editing the **Translate to** field. +You can add target languages at any time by opening the automation's configure page and editing the **Translate to** field. @@ -114,19 +109,22 @@ When you re-enable a scheduled automation or change its schedule, Mintlify recal ## Delete an automation 1. Navigate to the [Automations](https://app.mintlify.com/products/automations) page in your dashboard. -2. Click the settings button beside the custom automation you want to delete. -3. Click **Delete** at the bottom of the settings panel and confirm. +2. Click the settings button on the custom automation's card to open its configure page. +3. Click **Delete automation** at the bottom of the page and confirm. To delete any automation from the terminal, use [`mint automations`](/cli/commands#mint-automations). Deletion is permanent and cannot be undone. ## Run an automation manually -You can trigger any enabled automation on demand without waiting for its next scheduled or event-based run. +You can trigger an automation on demand without waiting for its next scheduled or event-based run. 1. Open the [Automations](https://app.mintlify.com/products/automations) page in your dashboard. -2. Click the run button beside the automation you want to start. +2. Click the settings button on the automation's card to open its configure page. +3. Click the run button (**Test run** or **Run now**, depending on the automation). + +Manual runs save the automation's current configuration before starting, count toward your credit usage, and appear in the run history alongside scheduled runs. -Manual runs use the automation's current configuration, count toward your credit usage, and appear in the run history alongside scheduled runs. +Most automations can run manually only when they have a schedule trigger. If the run button is unavailable, hover over it to see what to change. The **Translate content** automation can always run manually. ## Trigger a scheduled automation via API diff --git a/automations/reference.mdx b/automations/reference.mdx index da1b517f92..3ada70db5f 100644 --- a/automations/reference.mdx +++ b/automations/reference.mdx @@ -21,7 +21,7 @@ Mintlify includes predefined automations for the most common documentation maint | Fix grammar & typos | Content update | Pull request | Not supported | None | | Enforce your style guide | Content update | Pull request | Not supported | None | -You can change all defaults from the automation's settings panel. See [Configurations](/automations/manage#configurations) for the available options. +You can change all defaults from the automation's configure page. See [Configurations](/automations/manage#configurations) for the available options. ## Self-updating content automations @@ -59,7 +59,7 @@ You must enable feedback collection on the [Add-ons](https://app.mintlify.com/pr Reviews resolved support conversations from [Intercom](/automations/integrations), [Plain](/automations/integrations), [Pylon](/automations/integrations), or [Zendesk](/automations/integrations) to identify recurring gaps in your content, then opens a pull request to address them. The agent focuses on themes across multiple conversations rather than one-off questions, so results improve as your support volume grows. -Select a single support platform when you configure the automation. Connect it from the settings panel if it isn't already connected for your organization. Add source code repositories as context to help the agent tie support themes back to the product areas they describe. +Select a single support platform when you configure the automation. Connect it from the configure page if it isn't already connected for your organization. Add source code repositories as context to help the agent tie support themes back to the product areas they describe. Each scheduled run groups related findings into up to three themes, and opens a separate pull request for each. Every run lists the resolved support conversations it reviewed and links back to the source platform, so you can trace every content suggestion to the underlying customer feedback. diff --git a/es/api/automations/trigger.mdx b/es/api/automations/trigger.mdx index 7a258d3465..6319843cf0 100644 --- a/es/api/automations/trigger.mdx +++ b/es/api/automations/trigger.mdx @@ -20,7 +20,7 @@ Este endpoint solo admite automatizaciones configuradas con un activador de **Pr ## Encuentra el ID de la automatización -Copia el ID de la automatización desde el panel de configuración de la automatización en la página [Automatizaciones](https://app.mintlify.com/products/automations) de tu dashboard. +Ejecuta [`mint automations list`](/es/cli/commands#mint-automations-list) en tu terminal y copia el ID de la salida.
## Ejemplo diff --git a/es/automations/create.mdx b/es/automations/create.mdx index db011748bf..01eb06b1ff 100644 --- a/es/automations/create.mdx +++ b/es/automations/create.mdx @@ -25,9 +25,9 @@ Una automatización personalizada ejecuta al agente según un calendario, en res 1. Abre la página [Automatizaciones](https://app.mintlify.com/products/automations) en tu dashboard. -2. Haz clic en **Create a custom automation**. -3. Configura el nombre de la automatización, el activador, las instrucciones, los repositorios de contexto, las integraciones y el modo de actualización. Para más detalles sobre cada campo, consulta [Configuraciones](/es/automations/manage#configurations). -4. Haz clic en **Create automation**. +2. Haz clic en **New automation**. +3. En la página de configuración, define el nombre de la automatización, el activador, el prompt, los repositorios de contexto, las integraciones y el modo de actualización. Para más detalles sobre cada campo, consulta [Configuraciones](/es/automations/manage#configurations). +4. Haz clic en **Save**. También puedes pedirle al [agente en Slack](/es/agent/slack#manage-automations) que cree una automatización por ti describiendo lo que quieres que haga. @@ -56,7 +56,7 @@ Para ver más ejemplos y patrones, consulta [Usar automatizaciones](/es/guides/u
1. Abre la página [Automatizaciones](https://app.mintlify.com/products/automations) en tu dashboard. -2. Haz clic en el botón de configuración junto a una automatización. +2. Haz clic en el botón de configuración en la tarjeta de la automatización para abrir su página de configuración. 3. Actualiza cualquiera de los campos descritos en [Configuraciones](/es/automations/manage#configurations). 4. Haz clic en **Save**. @@ -67,5 +67,5 @@ Para ver más ejemplos y patrones, consulta [Usar automatizaciones](/es/guides/u Eliminar una automatización es permanente y elimina su configuración y el historial de ejecuciones. 1. Ve a la página [Automatizaciones](https://app.mintlify.com/products/automations) en tu dashboard. -2. Haz clic en el botón de configuración junto a una automatización. -3. Haz clic en **Delete**. +2. Haz clic en el botón de configuración en la tarjeta de la automatización para abrir su página de configuración. +3. Haz clic en **Delete automation** en la parte inferior de la página y confirma. diff --git a/es/automations/manage.mdx b/es/automations/manage.mdx index 70c7340340..6d0f690f4e 100644 --- a/es/automations/manage.mdx +++ b/es/automations/manage.mdx @@ -29,15 +29,10 @@ import GitlabAutomationSetup from '/snippets/es/gitlab-automation-setup.mdx'; El dashboard de automatizaciones. - Si la automatización puede ejecutarse con la configuración predeterminada, se activa de inmediato. De lo contrario, se abre el panel de configuración para que completes los ajustes obligatorios. - - Las opciones de configuración de una automatización. - Las opciones de configuración de una automatización. - -3. Si se abre el panel de configuración, completa los campos obligatorios. -4. Haz clic en **Turn on automation**. + Si la automatización puede ejecutarse con la configuración predeterminada, se activa de inmediato. De lo contrario, se abre la página de configuración de la automatización para que completes los ajustes obligatorios. +3. Si se abre la página de configuración, completa los campos obligatorios y haz clic en **Save**. -Para cambiar la configuración de una automatización activa, haz clic en el botón de configuración junto a ella. Usa el interruptor en el encabezado del modal para activarla o desactivarla sin salir de la vista de configuración. +Para cambiar la configuración de una automatización activa, haz clic en el botón de configuración en su tarjeta para abrir su página de configuración. Usa el interruptor en el encabezado de la página para activar o desactivar la automatización y haz clic en **Save** para aplicar los cambios.
## Configuraciones @@ -47,7 +42,7 @@ Para cambiar la configuración de una automatización activa, haz clic en el bot ### Activador
-Cada automatización tiene un activador predeterminado que controla cuándo se ejecuta. Para cambiar el activador, selecciona otra opción en el panel de configuración. +Cada automatización tiene un activador predeterminado que controla cuándo se ejecuta. Para cambiar el activador, selecciona otro tipo de activador en la página de configuración de la automatización. - **Actualización de contenido**: se ejecuta cada vez que envías contenido al repositorio de tu proyecto, incluidas las fusiones de pull requests y los pushes directos. - **Cambio de código**: se ejecuta cuando se fusiona una pull request en un repositorio de código fuente conectado. Debes especificar al menos un repositorio de origen. @@ -60,7 +55,7 @@ Cada automatización tiene un activador predeterminado que controla cuándo se e Cada automatización tiene un modo predeterminado para realizar actualizaciones. Puede fusionar los cambios directamente en tu repositorio de contenido o abrir una pull request para revisión. -Para requerir una revisión antes de que la automatización actualice tu contenido, selecciona **Require review** en el panel de configuración. +Elige el modo en la sección **After automation runs** de la página de configuración de la automatización. Selecciona **Update and merge changes** para fusionar los cambios automáticamente. Selecciona **Modify and wait for review** para requerir una revisión antes de que los cambios se publiquen. Para repositorios de GitHub, las actualizaciones automáticas requieren que la aplicación de GitHub de Mintlify tenga permisos de bypass en todos los rulesets que apunten a tu rama de implementación, incluidos los rulesets a nivel de organización y de repositorio. Consulta [Configurar automerge](/es/guides/configure-automerge) para ver las instrucciones de configuración. @@ -82,7 +77,7 @@ Puedes añadir hasta 10 repositorios de contexto por automatización. Para cada Para automatizaciones personalizadas y otras automatizaciones predefinidas compatibles, puedes habilitar [integraciones](/es/automations/integrations) para que el agente obtenga contexto desde herramientas compartidas como Notion, Jira o Linear. -Abre la configuración de la automatización y selecciona las integraciones en **Tools**. Puedes conectar una integración compartida desde el selector. Las integraciones personales solo están disponibles para su propietario al usar el agente de Slack y no pueden añadirse a automatizaciones. +Abre la página de configuración de la automatización y selecciona las integraciones que quieres usar en **Tools**. Puedes conectar una integración compartida desde el selector. Las integraciones personales solo están disponibles para su propietario al usar el agente de Slack y no pueden añadirse a automatizaciones. Si seleccionas **Integración** como activador, la integración que activa la automatización se añade automáticamente como herramienta. Consulta [Integraciones](/es/automations/integrations) para conocer los alcances, eventos y permisos. @@ -120,7 +115,7 @@ Cuando activas la automatización **Translate content**, selecciona uno o más i - Debes seleccionar al menos un idioma de destino para guardar la automatización. - No puedes seleccionar el idioma fuente como idioma de destino. -Puedes añadir idiomas de destino en cualquier momento abriendo la configuración de la automatización y editando el campo **Translate to**. +Puedes añadir idiomas de destino en cualquier momento abriendo la página de configuración de la automatización y editando el campo **Translate to**. @@ -140,8 +135,8 @@ Cuando vuelves a activar una automatización programada o cambias su programaci Puedes eliminar automatizaciones personalizadas desde el dashboard. Las automatizaciones predefinidas no se pueden eliminar desde el dashboard. Desactívalas en su lugar o usa la CLI para eliminarlas. 1. Abre la página [Automatizaciones](https://app.mintlify.com/products/automations) en tu dashboard. -2. Haz clic en el botón de configuración junto a la automatización personalizada que quieres eliminar. -3. Haz clic en **Delete** en la parte inferior del panel de configuración y confirma. +2. Haz clic en el botón de configuración en la tarjeta de la automatización personalizada para abrir su página de configuración. +3. Haz clic en **Delete automation** en la parte inferior de la página y confirma. Para eliminar cualquier automatización desde la terminal, usa [`mint automations`](/es/cli/commands#mint-automations). La eliminación es permanente y no se puede deshacer. @@ -149,12 +144,15 @@ Para eliminar cualquier automatización desde la terminal, usa [`mint automation ## Ejecutar una automatización manualmente -Puedes activar cualquier automatización habilitada bajo demanda sin esperar a su próxima ejecución programada o basada en eventos. +Puedes activar una automatización bajo demanda sin esperar a su próxima ejecución programada o basada en eventos. 1. Abre la página [Automatizaciones](https://app.mintlify.com/products/automations) en tu dashboard. -2. Haz clic en el botón de ejecución junto a la automatización que quieres iniciar. +2. Haz clic en el botón de configuración en la tarjeta de la automatización para abrir su página de configuración. +3. Haz clic en el botón de ejecución (**Test run** o **Run now**, según la automatización). + +Las ejecuciones manuales guardan la configuración actual de la automatización antes de comenzar, cuentan para tu uso de créditos y aparecen en el historial de ejecuciones junto a las ejecuciones programadas. -Las ejecuciones manuales usan la configuración actual de la automatización, cuentan para tu uso de créditos y aparecen en el historial de ejecuciones junto a las ejecuciones programadas. +La mayoría de las automatizaciones solo pueden ejecutarse manualmente cuando tienen un activador de programación. Si el botón de ejecución no está disponible, pasa el cursor sobre él para ver qué debes cambiar. La automatización **Translate content** siempre puede ejecutarse manualmente.
## Activar una automatización programada mediante la API diff --git a/es/automations/reference.mdx b/es/automations/reference.mdx index f77d94e6a2..af36302648 100644 --- a/es/automations/reference.mdx +++ b/es/automations/reference.mdx @@ -23,7 +23,7 @@ Mintlify incluye automatizaciones predefinidas para las tareas de mantenimiento | Fix grammar & typos | Actualización de contenido | Pull request | No compatible | Ninguna | | Enforce your style guide | Actualización de contenido | Pull request | No compatible | Ninguna | -Todos los valores predeterminados pueden cambiarse desde el panel de configuración de la automatización. Consulta [Configuraciones](/es/automations/manage#configurations) para ver las opciones disponibles. +Todos los valores predeterminados pueden cambiarse desde la página de configuración de la automatización. Consulta [Configuraciones](/es/automations/manage#configurations) para ver las opciones disponibles.
## Automatizaciones de contenido autoactualizable @@ -69,7 +69,7 @@ Debes habilitar la recopilación de comentarios en la página [Complementos](htt Revisa las conversaciones de soporte resueltas de [Intercom](/es/automations/integrations), [Plain](/es/automations/integrations), [Pylon](/es/automations/integrations) o [Zendesk](/es/automations/integrations) para identificar lagunas recurrentes en tu contenido y luego abre una pull request para abordarlas. El agente se centra en los temas que se repiten en varias conversaciones en lugar de en preguntas aisladas, por lo que los resultados mejoran a medida que crece tu volumen de soporte. -Selecciona una única plataforma de soporte al configurar la automatización y conéctala desde el panel de configuración si aún no está conectada para tu organización. Añade repositorios de código fuente como contexto para ayudar al agente a vincular los temas de soporte con las áreas del producto que describen. +Selecciona una única plataforma de soporte al configurar la automatización y conéctala desde la página de configuración si aún no está conectada para tu organización. Añade repositorios de código fuente como contexto para ayudar al agente a vincular los temas de soporte con las áreas del producto que describen. Cada ejecución programada agrupa los hallazgos relacionados en hasta tres temas y abre una pull request independiente para cada uno. Cada ejecución enumera las conversaciones de soporte resueltas que revisó y enlaza de vuelta a la plataforma de origen, para que puedas rastrear cada sugerencia de contenido hasta los comentarios de los clientes subyacentes. diff --git a/es/guides/use-automations.mdx b/es/guides/use-automations.mdx index 071d6e438c..ef3a3af97b 100644 --- a/es/guides/use-automations.mdx +++ b/es/guides/use-automations.mdx @@ -102,8 +102,8 @@ Puedes añadir hasta 10 repositorios de contexto por automatización. Decide cuánta revisión deseas antes de que los cambios se publiquen. -- **Automático**: los cambios se fusionan directamente en el repositorio de tu proyecto de Mintlify sin revisión. Ideal para tareas de bajo riesgo y alta frecuencia, como traducciones, comprobaciones gramaticales y correcciones de enlaces. -- **Requiere revisión**: el agente abre una pull request y una persona la revisa antes de fusionarla. Ideal para tareas que cambian el significado del contenido, como sincronizar con cambios de código o actualizar referencias de API. +- **Update and merge changes**: los cambios se fusionan directamente en el repositorio de tu proyecto de Mintlify sin revisión. Ideal para tareas de bajo riesgo y alta frecuencia, como traducciones, comprobaciones gramaticales y correcciones de enlaces. +- **Modify and wait for review**: el agente abre una pull request y una persona la revisa antes de fusionarla. Ideal para tareas que cambian el significado del contenido, como sincronizar con cambios de código o actualizar referencias de API.
## Controlar el uso de créditos diff --git a/fr/api/automations/trigger.mdx b/fr/api/automations/trigger.mdx index fb0acdd2c1..889793350f 100644 --- a/fr/api/automations/trigger.mdx +++ b/fr/api/automations/trigger.mdx @@ -20,7 +20,7 @@ Cet endpoint ne prend en charge que les automatisations configurées avec un dé ## Trouver l'identifiant de l'automatisation
-Copiez l'identifiant de l'automatisation depuis le panneau de paramètres de l'automatisation sur la page [Automations](https://app.mintlify.com/products/automations) de votre dashboard. +Exécutez [`mint automations list`](/fr/cli/commands#mint-automations-list) dans votre terminal et copiez l'identifiant depuis la sortie.
## Exemple diff --git a/fr/automations/create.mdx b/fr/automations/create.mdx index e244acf9d1..af3e72a675 100644 --- a/fr/automations/create.mdx +++ b/fr/automations/create.mdx @@ -25,9 +25,9 @@ Une automatisation personnalisée exécute l'agent selon un calendrier, en répo 1. Ouvrez la page [Automations](https://app.mintlify.com/products/automations) dans votre dashboard. -2. Cliquez sur **Create a custom automation**. -3. Configurez le nom de l'automatisation, le déclencheur, les instructions, les dépôts de contexte, les intégrations et le mode de mise à jour. Pour plus de détails sur chaque champ, consultez [Configurations](/fr/automations/manage#configurations). -4. Cliquez sur **Create automation**. +2. Cliquez sur **New automation**. +3. Sur la page de configuration, définissez le nom de l'automatisation, le déclencheur, le prompt, les dépôts de contexte, les intégrations et le mode de mise à jour. Pour plus de détails sur chaque champ, consultez [Configurations](/fr/automations/manage#configurations). +4. Cliquez sur **Save**. Vous pouvez également demander à l'[agent dans Slack](/fr/agent/slack#manage-automations) de créer une automatisation pour vous en décrivant ce que vous souhaitez qu'elle fasse. @@ -56,7 +56,7 @@ Pour plus d'exemples et de modèles, consultez [Utiliser les automatisations](/f
1. Ouvrez la page [Automations](https://app.mintlify.com/products/automations) dans votre dashboard. -2. Cliquez sur le bouton de paramètres à côté d'une automatisation. +2. Cliquez sur le bouton de paramètres sur la carte de l'automatisation pour ouvrir sa page de configuration. 3. Mettez à jour n'importe quel des champs décrits dans [Configurations](/fr/automations/manage#configurations). 4. Cliquez sur **Save**. @@ -67,5 +67,5 @@ Pour plus d'exemples et de modèles, consultez [Utiliser les automatisations](/f La suppression d'une automatisation est définitive et supprime sa configuration ainsi que l'historique de ses exécutions. 1. Accédez à la page [Automations](https://app.mintlify.com/products/automations) dans votre dashboard. -2. Cliquez sur le bouton de paramètres à côté d'une automatisation. -3. Cliquez sur **Delete**. +2. Cliquez sur le bouton de paramètres sur la carte de l'automatisation pour ouvrir sa page de configuration. +3. Cliquez sur **Delete automation** en bas de la page et confirmez. diff --git a/fr/automations/manage.mdx b/fr/automations/manage.mdx index c2da417e00..b6e47be43e 100644 --- a/fr/automations/manage.mdx +++ b/fr/automations/manage.mdx @@ -29,15 +29,10 @@ import GitlabAutomationSetup from '/snippets/fr/gitlab-automation-setup.mdx'; Le dashboard des automatisations. - Si l'automatisation peut s'exécuter avec les paramètres par défaut, elle s'active immédiatement. Sinon, le panneau de paramètres s'ouvre pour vous permettre de remplir les configurations requises. - - Les options de configuration d'une automatisation. - Les options de configuration d'une automatisation. - -3. Si le panneau de paramètres s'ouvre, remplissez les champs requis. -4. Cliquez sur **Turn on automation**. + Si l'automatisation peut s'exécuter avec les paramètres par défaut, elle s'active immédiatement. Sinon, la page de configuration de l'automatisation s'ouvre pour vous permettre de remplir les configurations requises. +3. Si la page de configuration s'ouvre, remplissez les champs requis et cliquez sur **Save**. -Pour modifier les paramètres d'une automatisation active, cliquez sur le bouton de paramètres à côté de celle-ci. Utilisez le bouton bascule dans l'en-tête de la modale pour activer ou désactiver l'automatisation sans quitter la vue des paramètres. +Pour modifier les paramètres d'une automatisation active, cliquez sur le bouton de paramètres sur sa carte pour ouvrir sa page de configuration. Utilisez le bouton bascule dans l'en-tête de la page pour activer ou désactiver l'automatisation, et cliquez sur **Save** pour appliquer vos modifications.
## Configurations @@ -47,7 +42,7 @@ Pour modifier les paramètres d'une automatisation active, cliquez sur le bouton ### Déclencheur
-Chaque automatisation possède un déclencheur par défaut qui contrôle son moment d'exécution. Pour changer le déclencheur, sélectionnez une autre option dans le panneau des paramètres. +Chaque automatisation possède un déclencheur par défaut qui contrôle son moment d'exécution. Pour changer le déclencheur, sélectionnez un autre type de déclencheur sur la page de configuration de l'automatisation. - **Mise à jour de contenu** : s'exécute chaque fois que vous poussez du contenu vers le dépôt de votre projet, y compris les fusions de pull requests et les pushes directs. - **Modification de code** : s'exécute lorsqu'une pull request est fusionnée dans un dépôt de code source connecté. Vous devez spécifier au moins un dépôt source. @@ -60,7 +55,7 @@ Chaque automatisation possède un déclencheur par défaut qui contrôle son mom Chaque automatisation possède un mode par défaut pour effectuer les mises à jour. Soit fusionner directement les modifications dans votre dépôt de contenu, soit ouvrir une pull request pour relecture. -Pour exiger une relecture avant que l'automatisation ne mette à jour votre contenu, sélectionnez **Require review** dans le panneau des paramètres. +Choisissez le mode dans la section **After automation runs** de la page de configuration de l'automatisation. Sélectionnez **Update and merge changes** pour fusionner les modifications automatiquement. Sélectionnez **Modify and wait for review** pour exiger une relecture avant que les modifications soient mises en ligne. Pour les dépôts GitHub, les mises à jour automatiques nécessitent que la GitHub App Mintlify dispose d'autorisations de contournement (bypass) sur chaque ensemble de règles ciblant votre branche de déploiement, y compris les ensembles de règles au niveau de l'organisation et du dépôt. Consultez [Configurer l'automerge](/fr/guides/configure-automerge) pour les instructions d'installation. @@ -82,7 +77,7 @@ Vous pouvez ajouter jusqu'à 10 dépôts de contexte par automatisation. Pour ch Pour les automatisations personnalisées et les autres automatisations prédéfinies compatibles, vous pouvez activer des [intégrations](/fr/automations/integrations) afin que l'agent récupère du contexte depuis des outils partagés comme Notion, Jira ou Linear. -Ouvrez les paramètres de l'automatisation et sélectionnez les intégrations dans **Tools**. Vous pouvez connecter une intégration partagée depuis le sélecteur. Les intégrations personnelles ne sont disponibles que pour leur propriétaire lorsqu'il utilise l'agent Slack et ne peuvent pas être ajoutées aux automatisations. +Ouvrez la page de configuration de l'automatisation et sélectionnez les intégrations que vous souhaitez utiliser dans **Tools**. Vous pouvez connecter une intégration partagée depuis le sélecteur. Les intégrations personnelles ne sont disponibles que pour leur propriétaire lorsqu'il utilise l'agent Slack et ne peuvent pas être ajoutées aux automatisations. Si vous sélectionnez **Intégration** comme déclencheur, l'intégration déclencheuse est automatiquement ajoutée comme outil. Consultez [Intégrations](/fr/automations/integrations) pour les portées, événements et autorisations. @@ -120,7 +115,7 @@ Lorsque vous activez l'automatisation **Translate content**, sélectionnez une o - Vous devez sélectionner au moins une langue cible pour enregistrer l'automatisation. - Vous ne pouvez pas sélectionner la langue source comme cible. -Vous pouvez ajouter des langues cibles à tout moment en ouvrant les paramètres de l'automatisation et en modifiant le champ **Translate to**. +Vous pouvez ajouter des langues cibles à tout moment en ouvrant la page de configuration de l'automatisation et en modifiant le champ **Translate to**. @@ -140,8 +135,8 @@ Lorsque vous réactivez une automatisation planifiée ou modifiez son calendrier Vous pouvez supprimer les automatisations personnalisées depuis le dashboard. Les automatisations prédéfinies ne peuvent pas être supprimées depuis le dashboard. Désactivez-les à la place, ou utilisez la CLI pour les supprimer. 1. Ouvrez la page [Automations](https://app.mintlify.com/products/automations) dans votre dashboard. -2. Cliquez sur le bouton de paramètres à côté de l'automatisation personnalisée que vous souhaitez supprimer. -3. Cliquez sur **Delete** en bas du panneau des paramètres et confirmez. +2. Cliquez sur le bouton de paramètres sur la carte de l'automatisation personnalisée pour ouvrir sa page de configuration. +3. Cliquez sur **Delete automation** en bas de la page et confirmez. Pour supprimer n'importe quelle automatisation depuis le terminal, utilisez [`mint automations`](/fr/cli/commands#mint-automations). La suppression est définitive et ne peut pas être annulée. @@ -149,12 +144,15 @@ Pour supprimer n'importe quelle automatisation depuis le terminal, utilisez [`mi ## Exécuter une automatisation manuellement
-Vous pouvez déclencher toute automatisation activée à la demande sans attendre sa prochaine exécution planifiée ou déclenchée par un événement. +Vous pouvez déclencher une automatisation à la demande sans attendre sa prochaine exécution planifiée ou déclenchée par un événement. 1. Ouvrez la page [Automations](https://app.mintlify.com/products/automations) dans votre dashboard. -2. Cliquez sur le bouton d'exécution à côté de l'automatisation que vous souhaitez démarrer. +2. Cliquez sur le bouton de paramètres sur la carte de l'automatisation pour ouvrir sa page de configuration. +3. Cliquez sur le bouton d'exécution (**Test run** ou **Run now**, selon l'automatisation). + +Les exécutions manuelles enregistrent la configuration actuelle de l'automatisation avant de démarrer, sont décomptées de votre utilisation de crédits et apparaissent dans l'historique des exécutions aux côtés des exécutions planifiées. -Les exécutions manuelles utilisent la configuration actuelle de l'automatisation, sont décomptées de votre utilisation de crédits et apparaissent dans l'historique des exécutions aux côtés des exécutions planifiées. +La plupart des automatisations ne peuvent être exécutées manuellement que lorsqu'elles ont un déclencheur de calendrier. Si le bouton d'exécution est indisponible, survolez-le pour voir ce qu'il faut modifier. L'automatisation **Translate content** peut toujours être exécutée manuellement.
## Déclencher une automatisation planifiée via l'API diff --git a/fr/automations/reference.mdx b/fr/automations/reference.mdx index dbb69662c8..479d77d073 100644 --- a/fr/automations/reference.mdx +++ b/fr/automations/reference.mdx @@ -23,7 +23,7 @@ Mintlify inclut des automatisations prédéfinies pour les tâches de maintenanc | Fix grammar & typos | Mise à jour de contenu | Pull request | Non pris en charge | Aucune | | Enforce your style guide | Mise à jour de contenu | Pull request | Non pris en charge | Aucune | -Tous les paramètres par défaut peuvent être modifiés depuis le panneau de paramètres de l'automatisation. Consultez [Configurations](/fr/automations/manage#configurations) pour les options disponibles. +Tous les paramètres par défaut peuvent être modifiés depuis la page de configuration de l'automatisation. Consultez [Configurations](/fr/automations/manage#configurations) pour les options disponibles.
## Automatisations de contenu auto-mis à jour @@ -69,7 +69,7 @@ Vous devez activer la collecte des retours sur la page [Add-ons](https://app.min Examine les conversations de support résolues depuis [Intercom](/fr/automations/integrations), [Plain](/fr/automations/integrations), [Pylon](/fr/automations/integrations) ou [Zendesk](/fr/automations/integrations) pour identifier les lacunes récurrentes dans votre contenu, puis ouvre une pull request pour y remédier. L'agent se concentre sur les thèmes qui reviennent dans plusieurs conversations plutôt que sur des questions ponctuelles, de sorte que les résultats s'améliorent à mesure que votre volume de support augmente. -Sélectionnez une seule plateforme de support lorsque vous configurez l'automatisation et connectez-la depuis le panneau de paramètres si elle n'est pas déjà connectée pour votre organisation. Ajoutez des dépôts de code source comme contexte pour aider l'agent à relier les thèmes de support aux domaines produit qu'ils décrivent. +Sélectionnez une seule plateforme de support lorsque vous configurez l'automatisation et connectez-la depuis la page de configuration si elle n'est pas déjà connectée pour votre organisation. Ajoutez des dépôts de code source comme contexte pour aider l'agent à relier les thèmes de support aux domaines produit qu'ils décrivent. Chaque exécution planifiée regroupe les résultats connexes en trois thèmes maximum et ouvre une pull request distincte pour chacun. Chaque exécution liste les conversations de support résolues qu'elle a examinées et renvoie vers la plateforme source, afin que vous puissiez remonter de chaque suggestion de contenu jusqu'au retour client d'origine. diff --git a/fr/guides/use-automations.mdx b/fr/guides/use-automations.mdx index 4f3c9851e7..27b8467973 100644 --- a/fr/guides/use-automations.mdx +++ b/fr/guides/use-automations.mdx @@ -102,8 +102,8 @@ Vous pouvez ajouter jusqu'à 10 dépôts de contexte par automatisation. Décidez du niveau de relecture souhaité avant que les modifications soient mises en ligne. -- **Automatique** : les modifications sont fusionnées directement dans votre dépôt de projet Mintlify sans relecture. Idéal pour les tâches à faible risque et à fréquence élevée comme la traduction, les vérifications grammaticales et les corrections de liens. -- **Exiger une relecture** : l'agent ouvre une pull request et un humain la relit avant la fusion. Idéal pour les tâches qui modifient le sens du contenu, comme la synchronisation avec les modifications de code ou la mise à jour des références d'API. +- **Update and merge changes** : les modifications sont fusionnées directement dans votre dépôt de projet Mintlify sans relecture. Idéal pour les tâches à faible risque et à fréquence élevée comme la traduction, les vérifications grammaticales et les corrections de liens. +- **Modify and wait for review** : l'agent ouvre une pull request et un humain la relit avant la fusion. Idéal pour les tâches qui modifient le sens du contenu, comme la synchronisation avec les modifications de code ou la mise à jour des références d'API.
## Contrôler l'utilisation des crédits diff --git a/guides/use-automations.mdx b/guides/use-automations.mdx index 303af9ef68..baf1f94d48 100644 --- a/guides/use-automations.mdx +++ b/guides/use-automations.mdx @@ -88,8 +88,8 @@ You can add up to 10 context repositories per automation. Decide how much review you want before changes go live. -- **Automatic**: Changes merge directly into your Mintlify project repository without review. Best for low-risk, high-frequency tasks like translation, grammar checks, and link fixes. -- **Require review**: The agent opens a pull request and a human reviews it before merging. Best for tasks that change content meaning, like syncing with code changes or updating API references. +- **Update and merge changes**: Changes merge directly into your Mintlify project repository without review. Best for low-risk, high-frequency tasks like translation, grammar checks, and link fixes. +- **Modify and wait for review**: The agent opens a pull request and a human reviews it before merging. Best for tasks that change content meaning, like syncing with code changes or updating API references. ## Control credit usage diff --git a/zh/api/automations/trigger.mdx b/zh/api/automations/trigger.mdx index 4f698940f0..c0b00ce49d 100644 --- a/zh/api/automations/trigger.mdx +++ b/zh/api/automations/trigger.mdx @@ -20,7 +20,7 @@ keywords: ["automation", "workflow", "trigger", "webhook", "schedule", "CI"] ## 查找自动化 ID
-在控制台的 [Automations](https://app.mintlify.com/products/automations) 页面,从自动化的设置面板中复制自动化 ID。 +在终端中运行 [`mint automations list`](/zh/cli/commands#mint-automations-list),并从输出中复制自动化 ID。
## 示例 diff --git a/zh/automations/create.mdx b/zh/automations/create.mdx index 47b15beaa1..24e268e528 100644 --- a/zh/automations/create.mdx +++ b/zh/automations/create.mdx @@ -25,9 +25,9 @@ import GitlabAutomationSetup from '/snippets/zh/gitlab-automation-setup.mdx'; 1. 在控制台中打开 [Automations](https://app.mintlify.com/products/automations) 页面。 -2. 点击 **Create a custom automation**。 -3. 配置自动化名称、触发器、指令、上下文仓库、集成和更新模式。有关各字段的详细说明,请参见[配置](/zh/automations/manage#configurations)。 -4. 点击 **Create automation**。 +2. 点击 **New automation**。 +3. 在配置页面上,设置自动化名称、触发器、提示词、上下文仓库、集成和更新模式。有关各字段的详细说明,请参见[配置](/zh/automations/manage#configurations)。 +4. 点击 **Save**。 你也可以让 [Slack 中的 agent](/zh/agent/slack#manage-automations) 为你创建自动化,只需描述你希望该自动化执行的操作。 @@ -56,7 +56,7 @@ import GitlabAutomationSetup from '/snippets/zh/gitlab-automation-setup.mdx';
1. 在控制台中打开 [Automations](https://app.mintlify.com/products/automations) 页面。 -2. 点击自动化旁边的 设置按钮。 +2. 点击自动化卡片上的 设置按钮以打开其配置页面。 3. 更新[配置](/zh/automations/manage#configurations)中描述的任何字段。 4. 点击 **Save**。 @@ -67,5 +67,5 @@ import GitlabAutomationSetup from '/snippets/zh/gitlab-automation-setup.mdx'; 删除自动化是永久性的,会移除其配置和运行历史。 1. 在控制台中打开 [Automations](https://app.mintlify.com/products/automations) 页面。 -2. 点击自动化旁边的 设置按钮。 -3. 点击 **Delete**。 +2. 点击自动化卡片上的 设置按钮以打开其配置页面。 +3. 点击页面底部的 **Delete automation** 并确认。 diff --git a/zh/automations/manage.mdx b/zh/automations/manage.mdx index 59456d2a0f..cf24d8c48d 100644 --- a/zh/automations/manage.mdx +++ b/zh/automations/manage.mdx @@ -29,15 +29,10 @@ import GitlabAutomationSetup from '/snippets/zh/gitlab-automation-setup.mdx'; 自动化控制台。 - 如果自动化可以使用默认设置运行,它会立即激活。否则,设置面板会打开,让你填写任何必需的配置。 - - 自动化的配置选项。 - 自动化的配置选项。 - -3. 如果设置面板打开,请填写必填字段。 -4. 点击 **Turn on automation**。 + 如果自动化可以使用默认设置运行,它会立即激活。否则,该自动化的配置页面会打开,让你填写任何必需的配置。 +3. 如果配置页面打开,请填写必填字段并点击 **Save**。 -要更改已激活自动化的设置,点击它旁边的 设置按钮。使用弹窗头部的开关可以在不离开设置视图的情况下启用或禁用自动化。 +要更改已激活自动化的设置,点击其卡片上的 设置按钮以打开其配置页面。使用页面头部的开关可以启用或禁用自动化,然后点击 **Save** 应用你的更改。
## 配置 @@ -47,7 +42,7 @@ import GitlabAutomationSetup from '/snippets/zh/gitlab-automation-setup.mdx'; ### 触发器
-每个自动化都有一个默认触发器来控制运行时机。要更改触发器,在设置面板中选择不同选项。 +每个自动化都有一个默认触发器来控制运行时机。要更改触发器,在自动化的配置页面上选择不同的触发器类型。 - **内容更新(Content update)**:每当你向项目仓库推送内容时运行,包括 pull request 合并和直接推送。 - **代码变更(Code change)**:当已连接的源代码仓库中有 pull request 合并时运行。你必须至少指定一个源仓库。 @@ -60,7 +55,7 @@ import GitlabAutomationSetup from '/snippets/zh/gitlab-automation-setup.mdx'; 每个自动化都有一种默认的更新方式:要么直接将更改合并到你的内容仓库,要么打开一个 pull request 以供审查。 -要在自动化更新内容之前要求审查,请在设置面板中选择 **Require review**。 +在自动化配置页面的 **After automation runs** 部分选择更新模式。选择 **Update and merge changes** 可自动合并更改。选择 **Modify and wait for review** 则要求在更改上线前进行审查。 对于 GitHub 仓库,自动更新要求 Mintlify GitHub 应用对所有针对部署分支的规则集(包括组织级和仓库级规则集)拥有绕过权限。设置说明请参见[配置 automerge](/zh/guides/configure-automerge)。 @@ -82,7 +77,7 @@ import GitlabAutomationSetup from '/snippets/zh/gitlab-automation-setup.mdx'; 对于自定义自动化和其他受支持的预定义自动化,你可以启用[集成](/zh/automations/integrations),让 agent 在运行时从 Notion、Jira 或 Linear 等共享工具获取上下文。 -打开自动化设置,并在 **Tools** 中选择集成。你可以直接从选择器连接尚未连接的共享集成。个人集成仅供其所有者在使用 Slack agent 时使用,不能添加到自动化。 +打开自动化的配置页面,并在 **Tools** 中选择你要使用的集成。你可以直接从选择器连接尚未连接的共享集成。个人集成仅供其所有者在使用 Slack agent 时使用,不能添加到自动化。 如果选择 **集成(Integration)** 作为触发器,触发该自动化的集成会自动添加为工具。有关连接范围、支持的事件和权限,请参见[集成](/zh/automations/integrations)。 @@ -120,7 +115,7 @@ import GitlabAutomationSetup from '/snippets/zh/gitlab-automation-setup.mdx'; - 你必须至少选择一个目标语言才能保存自动化。 - 你无法选择源语言作为目标。 -随时可通过打开自动化设置并编辑 **Translate to** 字段来添加目标语言。 +随时可通过打开自动化的配置页面并编辑 **Translate to** 字段来添加目标语言。 @@ -140,8 +135,8 @@ import GitlabAutomationSetup from '/snippets/zh/gitlab-automation-setup.mdx'; 你可以在控制台中删除自定义自动化。预定义自动化无法从控制台删除。请改为禁用它们,或使用 CLI 来移除。 1. 在控制台中打开 [Automations](https://app.mintlify.com/products/automations) 页面。 -2. 点击你想移除的自定义自动化旁边的 设置按钮。 -3. 点击设置面板底部的 **Delete** 并确认。 +2. 点击自定义自动化卡片上的 设置按钮以打开其配置页面。 +3. 点击页面底部的 **Delete automation** 并确认。 要在终端中删除任意自动化,请使用 [`mint automations`](/zh/cli/commands#mint-automations)。删除操作是永久性的,无法撤销。 @@ -149,12 +144,15 @@ import GitlabAutomationSetup from '/snippets/zh/gitlab-automation-setup.mdx'; ## 手动运行自动化
-你可以按需触发任何已启用的自动化,而无需等待其下一次预定或事件触发的运行。 +你可以按需触发自动化,而无需等待其下一次预定或事件触发的运行。 1. 在控制台中打开 [Automations](https://app.mintlify.com/products/automations) 页面。 -2. 点击你要启动的自动化旁边的 运行按钮。 +2. 点击自动化卡片上的 设置按钮以打开其配置页面。 +3. 点击运行按钮(根据自动化不同,为 **Test run** 或 **Run now**)。 + +手动运行会在开始前保存自动化的当前配置,会计入你的积分使用量,并与按计划运行的记录一起出现在运行历史中。 -手动运行会使用自动化的当前配置,会计入你的积分使用量,并与按计划运行的记录一起出现在运行历史中。 +大多数自动化仅在配置了计划触发器时才能手动运行。如果运行按钮不可用,将鼠标悬停在按钮上即可查看需要更改的内容。**Translate content** 自动化始终可以手动运行。
## 通过 API 触发计划自动化 diff --git a/zh/automations/reference.mdx b/zh/automations/reference.mdx index 3f6723a9ac..3f1f0ec885 100644 --- a/zh/automations/reference.mdx +++ b/zh/automations/reference.mdx @@ -23,7 +23,7 @@ Mintlify 为最常见的文档维护任务提供了预定义自动化。每个 | Fix grammar & typos | 内容更新 | Pull request | 不支持 | 无 | | Enforce your style guide | 内容更新 | Pull request | 不支持 | 无 | -所有默认值都可以在自动化的设置面板中更改。可用选项请参见[配置](/zh/automations/manage#configurations)。 +所有默认值都可以在自动化的配置页面中更改。可用选项请参见[配置](/zh/automations/manage#configurations)。
## 自更新内容自动化 @@ -69,7 +69,7 @@ Mintlify 为最常见的文档维护任务提供了预定义自动化。每个 审查来自 [Intercom](/zh/automations/integrations)、[Plain](/zh/automations/integrations)、[Pylon](/zh/automations/integrations) 或 [Zendesk](/zh/automations/integrations) 的已解决支持会话,以识别你内容中反复出现的缺口,然后打开一个 pull request 来解决它们。agent 关注多次会话中反复出现的主题,而不是一次性问题,因此随着支持量的增长,结果会变得更好。 -在配置该自动化时选择单一支持平台,如果尚未为你的组织连接,则从设置面板进行连接。将源代码仓库作为上下文添加,帮助 agent 将支持主题与其描述的产品领域关联起来。 +在配置该自动化时选择单一支持平台,如果尚未为你的组织连接,则从配置页面进行连接。将源代码仓库作为上下文添加,帮助 agent 将支持主题与其描述的产品领域关联起来。 每次计划运行会将相关发现分组为最多三个主题,并为每个主题分别打开一个 pull request。每次运行都会列出它审查过的已解决支持会话,并链接回源平台,让你可以将每条内容建议追溯到底层的客户反馈。 diff --git a/zh/guides/use-automations.mdx b/zh/guides/use-automations.mdx index 0e8b0f4a60..b110328c71 100644 --- a/zh/guides/use-automations.mdx +++ b/zh/guides/use-automations.mdx @@ -102,8 +102,8 @@ For each broken link, either fix the path or remove the link if no replacement e 决定在更改上线前你希望进行多少审查。 -- **自动(Automatic)**:更改直接合并到你的 Mintlify 项目仓库,无需审查。适用于低风险、高频任务,如翻译、语法检查和链接修复。 -- **要求审查(Require review)**:agent 打开 pull request,由人工审查后再合并。适用于会改变内容含义的任务,如与代码变更同步或更新 API 参考。 +- **Update and merge changes**:更改直接合并到你的 Mintlify 项目仓库,无需审查。适用于低风险、高频任务,如翻译、语法检查和链接修复。 +- **Modify and wait for review**:agent 打开 pull request,由人工审查后再合并。适用于会改变内容含义的任务,如与代码变更同步或更新 API 参考。
## 控制积分使用量 From 694ee6c2ea2bcd9f5c1bf30edcd85eb429b3c259 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 26 Aug 2026 18:43:52 +0000 Subject: [PATCH 2/4] docs: unify select terminology in update mode instructions --- automations/manage.mdx | 2 +- es/automations/manage.mdx | 2 +- fr/automations/manage.mdx | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/automations/manage.mdx b/automations/manage.mdx index 92ab595320..b908c54b2e 100644 --- a/automations/manage.mdx +++ b/automations/manage.mdx @@ -45,7 +45,7 @@ Each automation has a default trigger that controls when it runs. To change the Each automation has a default mode for how it makes updates: either directly merging changes into your content repository, or opening a pull request for review. -Choose the mode in the **After automation runs** section of the automation's configure page. Select **Update and merge changes** to merge changes automatically. Select **Modify and wait for review** to require a review before changes go live. +Select the mode in the **After automation runs** section of the automation's configure page. Select **Update and merge changes** to merge changes automatically. Select **Modify and wait for review** to require a review before changes go live. For GitHub repositories, automatic updates require the Mintlify GitHub App to have bypass permissions on every ruleset targeting your deploy branch, including organization-level and repository-level rulesets. See [Configure automerge](/guides/configure-automerge) for setup instructions. diff --git a/es/automations/manage.mdx b/es/automations/manage.mdx index 6d0f690f4e..3cee2a2c83 100644 --- a/es/automations/manage.mdx +++ b/es/automations/manage.mdx @@ -55,7 +55,7 @@ Cada automatización tiene un activador predeterminado que controla cuándo se e Cada automatización tiene un modo predeterminado para realizar actualizaciones. Puede fusionar los cambios directamente en tu repositorio de contenido o abrir una pull request para revisión. -Elige el modo en la sección **After automation runs** de la página de configuración de la automatización. Selecciona **Update and merge changes** para fusionar los cambios automáticamente. Selecciona **Modify and wait for review** para requerir una revisión antes de que los cambios se publiquen. +Selecciona el modo en la sección **After automation runs** de la página de configuración de la automatización. Selecciona **Update and merge changes** para fusionar los cambios automáticamente. Selecciona **Modify and wait for review** para requerir una revisión antes de que los cambios se publiquen. Para repositorios de GitHub, las actualizaciones automáticas requieren que la aplicación de GitHub de Mintlify tenga permisos de bypass en todos los rulesets que apunten a tu rama de implementación, incluidos los rulesets a nivel de organización y de repositorio. Consulta [Configurar automerge](/es/guides/configure-automerge) para ver las instrucciones de configuración. diff --git a/fr/automations/manage.mdx b/fr/automations/manage.mdx index b6e47be43e..7fc46af75d 100644 --- a/fr/automations/manage.mdx +++ b/fr/automations/manage.mdx @@ -55,7 +55,7 @@ Chaque automatisation possède un déclencheur par défaut qui contrôle son mom Chaque automatisation possède un mode par défaut pour effectuer les mises à jour. Soit fusionner directement les modifications dans votre dépôt de contenu, soit ouvrir une pull request pour relecture. -Choisissez le mode dans la section **After automation runs** de la page de configuration de l'automatisation. Sélectionnez **Update and merge changes** pour fusionner les modifications automatiquement. Sélectionnez **Modify and wait for review** pour exiger une relecture avant que les modifications soient mises en ligne. +Sélectionnez le mode dans la section **After automation runs** de la page de configuration de l'automatisation. Sélectionnez **Update and merge changes** pour fusionner les modifications automatiquement. Sélectionnez **Modify and wait for review** pour exiger une relecture avant que les modifications soient mises en ligne. Pour les dépôts GitHub, les mises à jour automatiques nécessitent que la GitHub App Mintlify dispose d'autorisations de contournement (bypass) sur chaque ensemble de règles ciblant votre branche de déploiement, y compris les ensembles de règles au niveau de l'organisation et du dépôt. Consultez [Configurer l'automerge](/fr/guides/configure-automerge) pour les instructions d'installation. From 1bc23a9881322caaccae9fb0ce0992ecee1f1167 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 27 Aug 2026 23:08:17 +0000 Subject: [PATCH 3/4] docs: note that appending runs appear in run history --- automations/manage.mdx | 2 +- es/automations/manage.mdx | 2 +- fr/automations/manage.mdx | 2 +- zh/automations/manage.mdx | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/automations/manage.mdx b/automations/manage.mdx index b908c54b2e..cd774de32e 100644 --- a/automations/manage.mdx +++ b/automations/manage.mdx @@ -134,7 +134,7 @@ API-triggered runs behave exactly like scheduled runs: they pick up everything t ## View run history -Each automation keeps a log of past runs, including the status and a summary of changes made. +Each automation keeps a log of past runs, including the status and a summary of changes made. Runs that append changes to an open pull request from an earlier run appear as their own entries in the run history. 1. Open the [Automations](https://app.mintlify.com/products/automations?tab=runs) page in your dashboard. 2. Use the dropdown menus to filter by specific automations or status. diff --git a/es/automations/manage.mdx b/es/automations/manage.mdx index 3cee2a2c83..3643d12783 100644 --- a/es/automations/manage.mdx +++ b/es/automations/manage.mdx @@ -166,7 +166,7 @@ Las ejecuciones activadas por API se comportan exactamente igual que las ejecuci ## Ver el historial de ejecuciones
-Cada automatización mantiene un registro de las ejecuciones pasadas, incluido el estado y un resumen de los cambios realizados. +Cada automatización mantiene un registro de las ejecuciones pasadas, incluido el estado y un resumen de los cambios realizados. Las ejecuciones que agregan cambios a una pull request abierta de una ejecución anterior aparecen como entradas propias en el historial de ejecuciones. 1. Abre la página [Automatizaciones](https://app.mintlify.com/products/automations?tab=runs) en tu dashboard. 2. Usa los menús desplegables para filtrar por automatizaciones o estado específicos. diff --git a/fr/automations/manage.mdx b/fr/automations/manage.mdx index 7fc46af75d..935186ddc2 100644 --- a/fr/automations/manage.mdx +++ b/fr/automations/manage.mdx @@ -166,7 +166,7 @@ Les exécutions déclenchées par API se comportent exactement comme les exécut ## Consulter l'historique des exécutions
-Chaque automatisation conserve un journal des exécutions passées, incluant le statut et un résumé des modifications effectuées. +Chaque automatisation conserve un journal des exécutions passées, incluant le statut et un résumé des modifications effectuées. Les exécutions qui ajoutent des modifications à une pull request ouverte par une exécution précédente apparaissent comme leurs propres entrées dans l'historique des exécutions. 1. Ouvrez la page [Automations](https://app.mintlify.com/products/automations?tab=runs) dans votre dashboard. 2. Utilisez les menus déroulants pour filtrer par automatisations spécifiques ou par statut. diff --git a/zh/automations/manage.mdx b/zh/automations/manage.mdx index cf24d8c48d..eb3985c2f1 100644 --- a/zh/automations/manage.mdx +++ b/zh/automations/manage.mdx @@ -166,7 +166,7 @@ import GitlabAutomationSetup from '/snippets/zh/gitlab-automation-setup.mdx'; ## 查看运行历史
-每个自动化都会保存历史运行日志,包括状态和所做更改的摘要。 +每个自动化都会保存历史运行日志,包括状态和所做更改的摘要。将更改追加到先前运行打开的 pull request 的运行,会在运行历史中显示为独立条目。 1. 进入控制台中的 [Automations](https://app.mintlify.com/products/automations?tab=runs) 页面。 2. 使用下拉菜单按特定自动化或状态进行过滤。 From d7ee45f849090a1cbcf847cd7ea9cefed6da020e Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 28 Aug 2026 00:00:40 +0000 Subject: [PATCH 4/4] docs: document grouped runs feed, Modified status, and run actions --- automations/manage.mdx | 7 +++++-- es/automations/manage.mdx | 7 +++++-- fr/automations/manage.mdx | 7 +++++-- zh/automations/manage.mdx | 7 +++++-- 4 files changed, 20 insertions(+), 8 deletions(-) diff --git a/automations/manage.mdx b/automations/manage.mdx index cd774de32e..852ca91bb8 100644 --- a/automations/manage.mdx +++ b/automations/manage.mdx @@ -145,17 +145,20 @@ Each run shows one of the following statuses: - **Running**: The agent is actively working on the automation job. - **Accepted**: The agent finished the run and the changes merged into your repository. - **Closed**: The agent finished the run, but someone rejected the changes. +- **Modified**: The run appended its changes to a pull request opened by an earlier run. - **Failed**: The agent could not complete the run. Failed runs do not count toward your daily run limit. - **No action needed**: The agent finished the run but did not find anything to update. -Click an individual run to see its prompt, the files it read or changed, and any pull request it opened. +You can act on runs directly from the list. For runs awaiting review, click **Accept** to merge the changes. For failed runs, click **Re-trigger** to start the run again. + +To see a run's prompt, the files it read or changed, and any pull request it opened, open the run's actions menu and select **View run details**. ## Continue a run in the editor After an automation completes and creates changes on a branch, you can open those changes directly in the editor to review, refine, or publish them. 1. Open the [Automations](https://app.mintlify.com/products/automations) page in your dashboard. -2. Click **View changes** beside the workflow run you want to continue working on in the editor. +2. On the **Runs** tab, click **Preview** on the run you want to continue working on in the editor. The editor opens to the automation's branch with the agent panel already open. The agent panel shows each page the automation changed. Click any page to view changes made by the automation. diff --git a/es/automations/manage.mdx b/es/automations/manage.mdx index 3643d12783..98b1e7d401 100644 --- a/es/automations/manage.mdx +++ b/es/automations/manage.mdx @@ -177,10 +177,13 @@ Cada ejecución muestra uno de los siguientes estados: - **Running**: El agente está trabajando activamente en la tarea de la automatización. - **Accepted**: El agente finalizó la ejecución y los cambios se fusionaron en tu repositorio. - **Closed**: El agente finalizó la ejecución, pero alguien rechazó los cambios. +- **Modified**: La ejecución agregó sus cambios a una pull request abierta por una ejecución anterior. - **Failed**: El agente no pudo completar la ejecución. Las ejecuciones fallidas no cuentan para tu límite diario de ejecuciones. - **No action needed**: El agente finalizó la ejecución pero no encontró nada que actualizar. -Haz clic en una ejecución individual para ver su prompt, los archivos que leyó o modificó y cualquier pull request que haya abierto. +Puedes actuar sobre las ejecuciones directamente desde la lista. Para las ejecuciones pendientes de revisión, haz clic en **Accept** para fusionar los cambios. Para las ejecuciones fallidas, haz clic en **Re-trigger** para iniciar la ejecución de nuevo. + +Para ver el prompt de una ejecución, los archivos que leyó o modificó y cualquier pull request que haya abierto, abre el menú de acciones de la ejecución y selecciona **View run details**.
## Continuar una ejecución en el editor @@ -189,7 +192,7 @@ Haz clic en una ejecución individual para ver su prompt, los archivos que leyó Después de que una automatización se complete y cree cambios en una rama, puedes abrir esos cambios directamente en el editor para revisarlos, refinarlos o publicarlos. 1. Abre la página [Automatizaciones](https://app.mintlify.com/products/automations) en tu dashboard. -2. Haz clic en **Ver cambios** junto a la ejecución del workflow con la que quieres seguir trabajando en el editor. +2. En la pestaña **Runs**, haz clic en **Preview** en la ejecución con la que quieres seguir trabajando en el editor. El editor se abre en la rama de la automatización con el panel del agente ya desplegado. El panel del agente muestra cada página que la automatización modificó. Haz clic en cualquier página para ver los cambios realizados por la automatización. diff --git a/fr/automations/manage.mdx b/fr/automations/manage.mdx index 935186ddc2..a17b8feda5 100644 --- a/fr/automations/manage.mdx +++ b/fr/automations/manage.mdx @@ -177,10 +177,13 @@ Chaque exécution affiche l'un des statuts suivants : - **Running** : l'agent travaille activement sur la tâche d'automatisation. - **Accepted** : l'agent a terminé l'exécution et les modifications ont été fusionnées dans votre dépôt. - **Closed** : l'agent a terminé l'exécution, mais quelqu'un a rejeté les modifications. +- **Modified** : l'exécution a ajouté ses modifications à une pull request ouverte par une exécution précédente. - **Failed** : l'agent n'a pas pu terminer l'exécution. Les exécutions en échec ne comptent pas dans votre limite quotidienne d'exécutions. - **No action needed** : l'agent a terminé l'exécution mais n'a rien trouvé à mettre à jour. -Cliquez sur une exécution individuelle pour voir son prompt, les fichiers qu'elle a lus ou modifiés, et toute pull request qu'elle a ouverte. +Vous pouvez agir sur les exécutions directement depuis la liste. Pour les exécutions en attente de relecture, cliquez sur **Accept** pour fusionner les modifications. Pour les exécutions en échec, cliquez sur **Re-trigger** pour relancer l'exécution. + +Pour voir le prompt d'une exécution, les fichiers qu'elle a lus ou modifiés, et toute pull request qu'elle a ouverte, ouvrez le menu d'actions de l'exécution et sélectionnez **View run details**.
## Poursuivre une exécution dans l'éditeur @@ -189,7 +192,7 @@ Cliquez sur une exécution individuelle pour voir son prompt, les fichiers qu'el Lorsqu'une automatisation se termine et crée des modifications sur une branche, vous pouvez ouvrir ces modifications directement dans l'éditeur pour les examiner, les affiner ou les publier. 1. Ouvrez la page [Automations](https://app.mintlify.com/products/automations) dans votre dashboard. -2. Cliquez sur **View changes** à côté de l'exécution du workflow sur laquelle vous souhaitez continuer à travailler dans l'éditeur. +2. Dans l'onglet **Runs**, cliquez sur **Preview** sur l'exécution sur laquelle vous souhaitez continuer à travailler dans l'éditeur. L'éditeur s'ouvre sur la branche de l'automatisation avec le panneau de l'agent déjà ouvert. Le panneau de l'agent affiche chaque page modifiée par l'automatisation. Cliquez sur une page pour voir les modifications effectuées par l'automatisation. diff --git a/zh/automations/manage.mdx b/zh/automations/manage.mdx index eb3985c2f1..140d276f92 100644 --- a/zh/automations/manage.mdx +++ b/zh/automations/manage.mdx @@ -177,10 +177,13 @@ import GitlabAutomationSetup from '/snippets/zh/gitlab-automation-setup.mdx'; - **Running**:agent 正在执行该自动化任务。 - **Accepted**:agent 已完成运行,更改已合并到你的仓库。 - **Closed**:agent 已完成运行,但有人拒绝了这些更改。 +- **Modified**:该运行将其更改追加到了先前运行打开的 pull request 中。 - **Failed**:agent 无法完成运行。失败的运行不会计入每日运行限制。 - **No action needed**:agent 完成了运行,但未发现需要更新的内容。 -点击单次运行即可查看其提示词、读取或更改的文件,以及它打开的任何 pull request。 +你可以直接在列表中对运行执行操作。对于等待审查的运行,点击 **Accept** 合并更改。对于失败的运行,点击 **Re-trigger** 重新开始运行。 + +要查看某次运行的提示词、读取或更改的文件,以及它打开的任何 pull request,请打开该运行的操作菜单并选择 **View run details**。
## 在编辑器中继续运行 @@ -189,7 +192,7 @@ import GitlabAutomationSetup from '/snippets/zh/gitlab-automation-setup.mdx'; 当自动化完成并在分支上创建更改后,你可以直接在编辑器中打开这些更改,进行查看、调整或发布。 1. 在控制台中打开 [Automations](https://app.mintlify.com/products/automations) 页面。 -2. 点击你想在编辑器中继续处理的工作流运行旁边的 **View changes**。 +2. 在 **Runs** 标签页中,点击你想在编辑器中继续处理的运行上的 **Preview**。 编辑器会打开到该自动化的分支,并自动展开 agent 面板。agent 面板会列出该自动化更改的每个页面。点击任意页面即可查看自动化所做的更改。