From 14c3bc41f08b6a784e6eee3ee19f2e41ae066c47 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 29 May 2026 19:16:18 +0000 Subject: [PATCH] docs: translate workflows updates to es and fr --- es.json | 1 + es/agent/use-cases.mdx | 2 +- es/changelog.mdx | 4 +- es/guides/index.mdx | 1 + es/guides/use-workflows.mdx | 126 ++++++++++++++++++++++++++++++++++++ es/workflows/create.mdx | 56 ++++++++++++++++ es/workflows/enable.mdx | 117 --------------------------------- es/workflows/index.mdx | 56 ++++++++++++++++ es/workflows/manage.mdx | 110 ++++++++++++++++++++++++++----- es/workflows/reference.mdx | 85 ++++++++++++++++++++++++ fr.json | 1 + fr/agent/use-cases.mdx | 2 +- fr/changelog.mdx | 4 +- fr/guides/index.mdx | 1 + fr/guides/use-workflows.mdx | 126 ++++++++++++++++++++++++++++++++++++ fr/workflows/create.mdx | 56 ++++++++++++++++ fr/workflows/enable.mdx | 117 --------------------------------- fr/workflows/index.mdx | 56 ++++++++++++++++ fr/workflows/manage.mdx | 110 ++++++++++++++++++++++++++----- fr/workflows/reference.mdx | 85 ++++++++++++++++++++++++ 20 files changed, 842 insertions(+), 274 deletions(-) create mode 100644 es/guides/use-workflows.mdx create mode 100644 es/workflows/create.mdx delete mode 100644 es/workflows/enable.mdx create mode 100644 es/workflows/index.mdx create mode 100644 es/workflows/reference.mdx create mode 100644 fr/guides/use-workflows.mdx create mode 100644 fr/workflows/create.mdx delete mode 100644 fr/workflows/enable.mdx create mode 100644 fr/workflows/index.mdx create mode 100644 fr/workflows/reference.mdx diff --git a/es.json b/es.json index 5f0a2ffdb1..798764f843 100644 --- a/es.json +++ b/es.json @@ -272,6 +272,7 @@ "pages": [ "es/guides/assistant-embed", "es/guides/configure-automerge", + "es/guides/use-workflows", "es/guides/claude-code", "es/guides/cursor", "es/guides/geo", diff --git a/es/agent/use-cases.mdx b/es/agent/use-cases.mdx index 39f8af2667..469e7a8fd8 100644 --- a/es/agent/use-cases.mdx +++ b/es/agent/use-cases.mdx @@ -84,7 +84,7 @@ Por ejemplo: `@mintlify Users are getting confused by step 3 in the setup guide. Crea flujos de trabajo para automatizar tareas recurrentes y tareas de mantenimiento reactivo, como redactar cambios o actualizar contenido cuando agregas nuevas funcionalidades a tu producto. -Consulta [Workflows](/workflows/index) para obtener más información. +Consulta [Resumen de workflows](/es/workflows/index) para obtener más información.
## Automatiza con la API diff --git a/es/changelog.mdx b/es/changelog.mdx index 6711e0ca7b..2ceab6b9a1 100644 --- a/es/changelog.mdx +++ b/es/changelog.mdx @@ -34,7 +34,7 @@ noindex: true ## Workflows
- - **Mejora la documentación a partir del feedback** ahora es un workflow dedicado que revisa los [comentarios recientes de las páginas](/es/optimize/feedback) y abre actualizaciones específicas de documentación a partir de lo que reportan los usuarios. Consulta [Workflows](/es/workflows/enable#improve-docs-from-feedback). + - **Mejora la documentación a partir del feedback** ahora es un workflow dedicado que revisa los [comentarios recientes de las páginas](/es/optimize/feedback) y abre actualizaciones específicas de documentación a partir de lo que reportan los usuarios. Consulta [Workflows](/es/workflows/reference#draft-improvements-from-user-feedback). - El workflow **Sync content with code** ha sido renombrado a **Self-updating site** para reflejar mejor lo que hace. - Se actualizaron los títulos y los textos de los workflows en el panel para mayor claridad. @@ -93,7 +93,7 @@ noindex: true ## Workflows - - Nuevo workflow **Improve content from assistant conversations** revisa tendencias en las preguntas de los usuarios y sugiere actualizaciones de documentación para abordar lagunas. Consulta [Workflows](https://www.mintlify.com/docs/workflows/enable#improve-docs-from-assistant-chats). + - Nuevo workflow **Draft improvements from assistant conversations** revisa tendencias en las preguntas de los usuarios y sugiere actualizaciones de documentación para abordar lagunas. Consulta [Workflows](/es/workflows/reference#draft-improvements-from-assistant-conversations). - Los **repositorios de contexto** ahora se pueden configurar directamente para algunos workflows, para que puedas añadir los repos que un workflow debe consultar mientras se ejecuta. - La configuración de workflows ahora se abre en un **panel lateral** en lugar de un modal, lo que facilita ajustar la configuración mientras revisas Workflow Runs. diff --git a/es/guides/index.mdx b/es/guides/index.mdx index 55441bcee3..a871477706 100644 --- a/es/guides/index.mdx +++ b/es/guides/index.mdx @@ -20,6 +20,7 @@ Utiliza herramientas impulsadas por IA para acelerar tu flujo de trabajo de docu * [Crear un assistant dentro de tu aplicación](/es/guides/assistant-embed): Tutorial que enseña cómo agregar un chat bot de IA en una app de React para ayudar a los usuarios a encontrar respuestas en tu documentación. * [Configurar automerge](/es/guides/configure-automerge): Agrega la aplicación GitHub de Mintlify a la lista de bypass de un ruleset para habilitar la fusión automática de flujos de trabajo. +* [Usar workflows](/es/guides/use-workflows): Elige el trigger de workflow adecuado, escribe instrucciones efectivas y obtén resultados consistentes del mantenimiento automatizado de contenido. * [Claude Code](/es/guides/claude-code), [Cursor](/es/guides/cursor), [Windsurf](/es/guides/windsurf): Guías para usar asistentes de programación con IA para mantener la documentación. * [GEO](/es/guides/geo): Mejores prácticas para optimizar tu documentación para motores de búsqueda y respuesta basados en IA. diff --git a/es/guides/use-workflows.mdx b/es/guides/use-workflows.mdx new file mode 100644 index 0000000000..2fda627240 --- /dev/null +++ b/es/guides/use-workflows.mdx @@ -0,0 +1,126 @@ +--- +title: "Usar workflows" +description: "Aprende a usar los workflows de Mintlify para automatizar tareas recurrentes de mantenimiento de contenido, elige el tipo de trigger adecuado, escribe instrucciones efectivas y obtén resultados consistentes." +keywords: ["workflows", "automatización", "automatizar", "guía de workflows", "instrucciones de workflow", "automatización del agente", "autoactualizable"] +--- + +Los workflows ejecutan el agente automáticamente para que tu contenido se mantenga preciso sin esfuerzo manual. Esta guía cubre cómo elegir el workflow adecuado, configurarlo de forma efectiva y escribir instrucciones que produzcan resultados consistentes. + +
+ ## Cuándo usar workflows +
+ +Los workflows son ideales para tareas que son: + +- **Repetitivas** — La misma tarea se ejecuta con regularidad según una programación predecible o cada vez que ocurre un evento específico. +- **Lentas** — Tareas que llevan tiempo realizar manualmente pero siguen un patrón consistente. +- **Reactivas** — Tareas que deben ocurrir automáticamente en respuesta a cambios de código o contenido, como actualizar la documentación tras el lanzamiento de una funcionalidad. + +Para tareas puntuales o exploratorias, usa el agente directamente en el [panel](https://app.mintlify.com) o desde Slack. + +
+ ## Elegir un trigger +
+ +Cada workflow se ejecuta con uno de tres tipos de trigger. Elige el que coincida con cuándo necesitas que se realice el trabajo. + +| Trigger | Cuándo usarlo | +|---|---| +| Actualización de contenido | La tarea debe ejecutarse cada vez que cambie el contenido de tu proyecto: traducir páginas nuevas, reparar enlaces rotos o auditar metadatos de SEO. | +| Cambio de código | La tarea debe ejecutarse cuando cambia el código fuente: actualizar especificaciones de API o documentación tras el merge de una PR. | +| Programación personalizada | La tarea debe ejecutarse con una cadencia fija sin importar lo demás: publicar changelogs semanales o ejecutar verificaciones gramaticales periódicas. | + +
+ ## Workflows predefinidos +
+ +Mintlify incluye workflows predefinidos para las tareas más comunes de mantenimiento de contenido. Activa cualquiera de ellos desde la página [Workflows](https://app.mintlify.com/products/workflows?tab=workflows) de tu panel. + +Consulta [Workflows predefinidos](/es/workflows/reference) para más detalles. + +
+ ## Workflows personalizados +
+ +Crea un workflow personalizado para tareas que no están cubiertas por las opciones predefinidas. Los workflows personalizados te dan control total sobre el trigger, las instrucciones y los repositorios de contexto. + +Consulta [Crear un workflow personalizado](/es/workflows/create) para los pasos de configuración. + +
+ ### Escribir instrucciones efectivas +
+ +Las instrucciones de un workflow personalizado son prompts que el agente sigue en cada ejecución. La calidad de tus instrucciones afecta directamente a la consistencia de los resultados. + +**Describe el resultado, no solo la tarea.** Indica al agente cómo debe verse el resultado final. + + +```text Menos efectivo +Revisa las páginas de referencia de la API. +``` + +```text Más efectivo +Revisa cada página del directorio /api-reference. Para cada endpoint, confirma que los parámetros de la solicitud, los campos de respuesta y los payloads de ejemplo coincidan con la especificación OpenAPI en el archivo api/openapi.yaml. Abre una pull request con correcciones para cualquier discrepancia que encuentres. +``` + + +**Escribe un procedimiento.** Los agentes siguen instrucciones paso a paso de forma más fiable que prompts abiertos. + +```text Ejemplo de procedimiento +1. Lee el diff de la pull request mergeada del repositorio de origen. +2. Identifica los endpoints, parámetros o formas de respuesta de la API que cambiaron. +3. Busca en la documentación las páginas que hacen referencia a esos endpoints. +4. Actualiza las páginas afectadas para que coincidan con los cambios de la pull request. +5. Abre una pull request con un resumen de las páginas que cambiaste y por qué. +``` + +**Mantén el alcance acotado.** Un workflow que hace una cosa bien es más fiable que uno que intenta hacer muchas. Divide las tareas complejas en varios workflows. + +**Especifica archivos y directorios.** Cuanto más preciso seas sobre dónde debe mirar el agente, menos tiempo dedicará a buscar. + +```text Ejemplo con rutas específicas +Revisa cada archivo MDX en el directorio /content para detectar enlaces internos rotos (enlaces que comienzan con /). +Para cada enlace roto, corrige la ruta o elimina el enlace si no existe sustitución. +``` + +
+ ### Usar repositorios de contexto +
+ +Para workflows personalizados y algunos workflows predefinidos, puedes añadir repositorios de contexto que el agente lee cuando se ejecuta el workflow. + +Añade repositorios de contexto cuando: +- Tu contenido haga referencia a código, APIs o configuración que vive en un repositorio separado. +- Quieras que el agente compare tu contenido con el código fuente al decidir qué actualizar. +- El prompt del workflow se refiera a archivos fuera del repositorio de tu proyecto de Mintlify. + +Puedes añadir hasta 10 repositorios de contexto por workflow. + +
+ ### Modo de actualización +
+ +Decide cuánta revisión quieres antes de que los cambios se publiquen. + +- **Automático**: Los cambios se mergean directamente en el repositorio de tu proyecto de Mintlify sin revisión. Mejor para tareas de bajo riesgo y alta frecuencia como traducción, verificaciones gramaticales y reparación de enlaces. +- **Requiere revisión**: El agente abre una pull request y una persona la revisa antes de mergearla. Mejor para tareas que cambian el significado del contenido, como sincronizaciones con cambios de código o actualizaciones de referencias de API. + +
+ ## Controlar el uso de créditos +
+ +Cada ejecución de workflow consume créditos. Por ejemplo, la mayoría de las ejecuciones del workflow **actualizar desde cambios de código** cuestan entre 40 y 180 créditos. Las ejecuciones complejas que actualizan muchas páginas cuestan más. + +Programar trabajos cron para que se ejecuten en momentos concretos te permite controlar con mayor precisión el uso de créditos. Por ejemplo, puedes ejecutar un workflow una vez al día o una vez a la semana para saber exactamente cuántas pull requests crea un workflow al mes, en lugar de que dependa de cambios de contenido o de código que varían de un mes a otro. + +
+ ## Revisar y mejorar los resultados de los workflows +
+ +Los workflows se ejecutan automáticamente, pero se benefician de una revisión periódica. + +1. Abre la pestaña **Runs** en la página [Workflows](https://app.mintlify.com/products/workflows) para ver el historial de ejecuciones recientes y su estado. +2. Haz clic en una ejecución para leer el resumen del agente y revisar las pull requests que abrió. +3. Si los resultados son inconsistentes, refina tus instrucciones: añade procedimientos más específicos, reduce el alcance de los archivos o divide el workflow en tareas más pequeñas. + +Unos cuantos ciclos de revisión tras activar un nuevo workflow suelen ser suficientes para ajustar las instrucciones. diff --git a/es/workflows/create.mdx b/es/workflows/create.mdx new file mode 100644 index 0000000000..2dab1b5cda --- /dev/null +++ b/es/workflows/create.mdx @@ -0,0 +1,56 @@ +--- +title: "Crear un workflow personalizado" +description: "Crea un workflow personalizado de Mintlify con un trigger programado o de push, repositorios de contexto y un prompt para el agente para automatizar tareas de documentación recurrentes." +keywords: ["automatización", "automatizar", "cron", "agente", "workflow personalizado"] +--- + +import GitlabWorkflowSetup from '/snippets/es/gitlab-workflow-setup.mdx'; + +
+ ## Requisitos previos +
+ +- Un proyecto de Mintlify conectado a un repositorio de GitHub o GitLab +- Para GitHub: la [Mintlify GitHub App](/es/deploy/github) instalada en cada repositorio que planees usar en el workflow +- Para GitLab: una cuenta de GitLab conectada (consulta [Configuración de GitLab](#gitlab-setup) a continuación) + +
+ ## Crear un workflow personalizado +
+ + + El agente se ejecuta en un sandbox aislado con acceso restringido a internet. No puede instalar paquetes o herramientas adicionales en tiempo de ejecución. Los prompts que hacen referencia a herramientas no disponibles pueden producir resultados inesperados o fallar. + + +1. Abre la página [Workflows](https://app.mintlify.com/products/workflows?tab=workflows) en tu panel. +2. Haz clic en **Create a custom workflow**. +3. Configura el nombre del workflow, el trigger, las instrucciones, los repositorios de contexto y el modo de actualización. +4. Haz clic en **Create workflow**. + +
+ ## Escribir instrucciones efectivas +
+ +Las instrucciones efectivas para workflows se centran en una sola tarea y definen un resultado claro y verificable. Los workflows presentan cierta variabilidad porque los agentes son no deterministas, pero las instrucciones bien formateadas producen resultados más consistentes. + +- **Describe el resultado.** Indica al agente cómo debe verse el resultado de una ejecución exitosa. +- **Escribe un procedimiento.** Dale al agente una guía paso a paso a seguir. +- **Mantén el alcance acotado.** Divide las tareas complejas en varios workflows en lugar de combinarlas en un solo prompt. + +Para más ejemplos y patrones, consulta [Usar workflows](/es/guides/use-workflows). + + + Revisa la salida de tus workflows personalizados para confirmar que funcionan como se espera. Actualiza tus instrucciones para mejorar los resultados. + + + + +
+ ## Eliminar un workflow personalizado +
+ +Eliminar un workflow es permanente y borra su configuración e historial de ejecuciones. + +1. Ve a la página [Workflows](https://app.mintlify.com/products/workflows?tab=workflows) en tu panel. +2. Haz clic en el botón de configuración junto a un workflow. +3. Haz clic en **Delete**. diff --git a/es/workflows/enable.mdx b/es/workflows/enable.mdx deleted file mode 100644 index 401aeedace..0000000000 --- a/es/workflows/enable.mdx +++ /dev/null @@ -1,117 +0,0 @@ ---- -title: "Activar workflows" -description: "Activa workflows en tu proyecto de Mintlify. Configura activadores de GitHub o GitLab, añade repositorios de contexto, establece horarios y activa el merge automático para el agente." -keywords: ["cron", "activador push", "merge automático"] ---- - -import GitlabWorkflowSetup from '/snippets/es/gitlab-workflow-setup.mdx'; - -
- ## Requisitos previos -
- -- Un proyecto de Mintlify conectado a un repositorio de GitHub o GitLab -- Para GitHub: la [aplicación de GitHub de Mintlify](/es/deploy/github) instalada en cada repositorio que planees usar en el workflow -- Para GitLab: una cuenta de GitLab conectada (consulta [Configuración de GitLab](#gitlab-setup) a continuación) - -
- ## Activar workflows -
- -1. Abre la página [Workflows](https://app.mintlify.com/products/workflows?tab=workflows) en tu panel. -2. Haz clic en el interruptor junto a un workflow para activarlo. - - El panel de workflows. - El panel de workflows. - - - Si el workflow puede ejecutarse con la configuración predeterminada, se activa de inmediato. De lo contrario, se abre la ventana de configuración para que puedas elegir las opciones necesarias. - - Las opciones de configuración del workflow de actualizaciones del código. - Las opciones de configuración del workflow de actualizaciones del código. - -3. Si se abre la ventana, completa los campos requeridos y haz clic en **Turn on workflow**. - - Para cambiar la configuración de un workflow activo, haz clic en el botón de configuración junto a él. Usa el interruptor en el encabezado de la ventana para activar o desactivar el workflow sin salir de la vista de configuración. - -
- ## Configuraciones -
- -
- ### Repositorios activadores -
- -Para los workflows que se ejecutan en eventos push, especifica los repositorios que se deben monitorear. Puedes especificar hasta 10 repositorios por workflow. - -Para los repositorios de GitHub, debes instalar la aplicación de GitHub de Mintlify en cada repositorio. Añade repositorios en la página de configuración de la [aplicación de GitHub](https://app.mintlify.com/settings/organization/github-app). - -
- ### Modo de actualización -
- -Cada workflow tiene un modo predeterminado para realizar las actualizaciones, ya sea actualizando directamente tu repositorio de contenido o abriendo una pull request. - -Si quieres requerir revisiones antes de que un workflow actualice tu contenido, haz clic en **Require review**. - - - Para los repositorios de GitHub, las actualizaciones automáticas requieren que la aplicación de GitHub de Mintlify tenga permisos de omisión en cada conjunto de reglas que apunte a tu rama de despliegue, incluidos los conjuntos de reglas a nivel de organización y repositorio. Consulta [Configurar el merge automático](/es/guides/configure-automerge) para obtener instrucciones de configuración. - - Para los repositorios de GitLab, el merge automático usa la conexión OAuth de GitLab y requiere al menos el rol de Maintainer en cada proyecto. - - -
- ### Activador -
- -Cada workflow tiene un valor predeterminado para cuándo se ejecuta, ya sea en respuesta a cambios en tu repositorio de contenido, en respuesta a cambios en un repositorio activador o según un horario. - -Si quieres cambiar el valor predeterminado, selecciona un activador diferente. - -
- ### Instrucciones -
- -Añade instrucciones opcionales que se añaden al prompt base del workflow. Usa estas instrucciones para ajustar el estilo, el tono u otros aspectos propios de tu proyecto. - -
- ### Idiomas de destino -
- -Cuando actives el workflow **Translate content**, selecciona uno o más idiomas que quieras mantener sincronizados con tu contenido fuente. - -- Mintlify lee los [idiomas](/es/organize/navigation#languages) definidos en tu `docs.json` para identificar tu idioma predeterminado y preselecciona cualquier idioma de destino que ya esté configurado. -- Debes seleccionar al menos un idioma de destino para guardar el workflow. -- No puedes seleccionar el idioma fuente como destino. - -Puedes cambiar los idiomas de destino en cualquier momento abriendo la configuración del workflow y editando el campo **Translate to**. - -
- #### Ejecutar una traducción de inmediato -
- -Después de guardar el workflow, haz clic en **Translate now** para ejecutarlo bajo demanda usando los idiomas de destino guardados actualmente. El workflow debe estar activado para activar una ejecución manual. Las ejecuciones manuales no afectan el activador regular del workflow. - -
- ## Mejorar la documentación a partir de conversaciones con el asistente -
- -El workflow **Improve docs from assistant chats** revisa las tendencias recientes en las preguntas al [asistente](/es/assistant/index) y abre actualizaciones específicas de la documentación que abordan las lagunas con las que se encuentran tus usuarios. - -Usa este workflow cuando quieras que el agente clasifique la actividad del asistente por ti y proponga cambios que respondan a las preguntas que los usuarios realmente hacen. - -Este workflow se ejecuta según un horario. No requiere repositorios activadores ni configuración de contexto adicional. Actívalo desde la página [Workflows](https://app.mintlify.com/products/workflows?tab=workflows) y elige si las actualizaciones se mergean automáticamente o abren una pull request para su revisión. - -
- ## Mejorar la documentación a partir de los comentarios -
- -El workflow **Improve docs from feedback** revisa los [comentarios de página](/es/optimize/feedback) recientes y abre actualizaciones específicas de la documentación basadas en los problemas que reportan los usuarios. - -Usa este workflow cuando recopiles valoraciones con pulgares o comentarios contextuales y quieras que el agente convierta esa señal en cambios concretos en la documentación. - -Cuando se completa una ejecución, los detalles de la ejecución en tu panel incluyen las citas específicas de comentarios que utilizó el agente. Cada cita enlaza al comentario en tu [panel de analítica](https://app.mintlify.com/products/analytics/v2/feedback) para que puedas verificar el contexto que impulsó la actualización. - -Este workflow se ejecuta según un horario y requiere que la recopilación de comentarios esté activada en la página [Add-ons](https://app.mintlify.com/products/addons). No requiere repositorios activadores ni configuración de contexto adicional. - - diff --git a/es/workflows/index.mdx b/es/workflows/index.mdx new file mode 100644 index 0000000000..cb1b7050d2 --- /dev/null +++ b/es/workflows/index.mdx @@ -0,0 +1,56 @@ +--- +title: "Resumen de workflows" +sidebarTitle: "Resumen" +description: "Automatiza el mantenimiento de contenido con los workflows de Mintlify. Ejecuta el agente según una programación o en respuesta a pushes en repositorios de GitHub y GitLab." +keywords: ["automatización", "automatizar", "cron", "agente", "workflows"] +boost: 5 +--- + +Los workflows ejecutan el agente automáticamente según una programación o en respuesta a cambios en un repositorio. Cada workflow define un prompt para el agente y un trigger que indica cuándo ejecutarlo. Los workflows admiten tanto repositorios de GitHub como de GitLab. + +Cuando se ejecuta un workflow, el agente lee el contenido de tu proyecto y los repositorios conectados, y luego sigue el prompt para realizar las actualizaciones. + + +Usa workflows que se ejecutan según una programación para tareas recurrentes, como publicar changelogs o auditar metadatos de SEO. + +Usa workflows que se activan por cambios de contenido o de código para tareas de mantenimiento reactivas, como traducciones o actualizaciones de contenido cuando cambia el código fuente. + + +
+ ## Tipos de trigger +
+ +Los workflows admiten tres tipos de trigger. + +- **Actualización de contenido** — Se ejecuta cuando se hace push de cambios de contenido a tu repositorio de proyecto de Mintlify, incluidos los merges de pull requests y los pushes directos. +- **Cambio de código** — Se ejecuta cuando se mergea una pull request en un repositorio de código fuente conectado. +- **Programación personalizada** — Se ejecuta según una programación recurrente. Los workflows se ponen en cola en un plazo de 10 minutos a partir de la hora programada. + +Cada workflow tiene exactamente un trigger. No puedes combinar tipos de trigger en un solo workflow. + +
+ ## Límites de uso +
+ +Las ejecuciones de workflows cuentan para tu uso de créditos. Consulta tu uso de créditos, configura excedentes y gestiona tu paquete de créditos en la página [Uso](https://app.mintlify.com/settings/organization/usage) de tu panel. + +Cada workflow puede ejecutarse hasta 500 veces al día. Las ejecuciones fallidas no cuentan para este límite. + +
+ ## Próximos pasos +
+ + + + Referencia de todos los workflows predefinidos: triggers, modos de actualización y configuración requerida. + + + Activa workflows predefinidos y configura triggers, modo de actualización y contexto. + + + Crea un workflow con tu propio trigger, instrucciones y repositorios de contexto. + + + Elige el trigger adecuado, escribe instrucciones efectivas y revisa los resultados. + + diff --git a/es/workflows/manage.mdx b/es/workflows/manage.mdx index 8654ea44cc..bdd582021a 100644 --- a/es/workflows/manage.mdx +++ b/es/workflows/manage.mdx @@ -1,27 +1,104 @@ --- title: "Gestionar workflows" -description: "Activa, desactiva, reactiva y elimina workflows de Mintlify desde tu panel, y aprende cómo se recalculan los horarios después de pausar y reanudar un workflow." -keywords: ["gestionar workflows", "activar workflow", "desactivar workflow", "habilitar workflow"] +description: "Activa, desactiva, ejecuta y elimina workflows desde tu panel. Configura triggers de GitHub o GitLab, añade repositorios de contexto, define programaciones y activa automerge." +keywords: ["cron", "push", "automerge", "contexto", "instrucciones de workflow", "trigger", "desactivar workflow", "activar workflow"] --- -
- ## Desactivar un workflow +import GitlabWorkflowSetup from '/snippets/es/gitlab-workflow-setup.mdx'; + +
+ ## Requisitos previos
-1. Ve a la página [Workflows](https://app.mintlify.com/products/workflows?tab=workflows) en tu panel. -2. Haz clic en el interruptor junto a un workflow para desactivarlo. +- Un proyecto de Mintlify conectado a un repositorio de GitHub o GitLab +- Para GitHub: la [Mintlify GitHub App](/es/deploy/github) instalada en cada repositorio que planees usar en el workflow +- Para GitLab: una cuenta de GitLab conectada (consulta [Configuración de GitLab](#gitlab-setup) a continuación) -Cuando reactivas un workflow programado, Mintlify recalcula la próxima hora de ejecución a partir de la hora actual. +
+ ## Activar un workflow +
+ +1. Abre la página [Workflows](https://app.mintlify.com/products/workflows?tab=workflows) en tu panel. +2. Haz clic en el interruptor junto a un workflow para activarlo. + + El panel de workflows. + El panel de workflows. + + + Si el workflow puede ejecutarse con la configuración predeterminada, se activa de inmediato. De lo contrario, se abre el panel de configuración para que completes cualquier configuración requerida. + + Las opciones de configuración de un workflow. + Las opciones de configuración de un workflow. + +3. Si se abre el panel de configuración, completa los campos requeridos. +4. Haz clic en **Turn on workflow**. + +Para cambiar la configuración de un workflow activo, haz clic en el botón de configuración junto a él. Usa el interruptor en el encabezado del modal para activar o desactivar el workflow sin salir de la vista de configuración. -
- ## Eliminar un workflow personalizado +
+ ## Configuraciones
-Eliminar un workflow es permanente y borra su configuración e historial de ejecuciones. +
+ ### Trigger +
+ +Cada workflow tiene un trigger por defecto que controla cuándo se ejecuta. Para cambiar el trigger, selecciona una opción diferente en el panel de configuración. + +- **Actualización de contenido** — Se ejecuta cuando se hace push de contenido a tu repositorio de proyecto, incluidos los merges de pull requests y los pushes directos. +- **Cambio de código** — Se ejecuta cuando se mergea una pull request en un repositorio de código fuente conectado. Debes especificar al menos un repositorio de origen. +- **Programación personalizada** — Se ejecuta según una programación recurrente que definas. Los workflows se ponen en cola en un plazo de 10 minutos a partir de la hora programada. + +
+ ### Modo de actualización +
+ +Cada workflow tiene un modo predeterminado para cómo realiza las actualizaciones. Ya sea mergeando los cambios directamente en tu repositorio de contenido o abriendo una pull request para su revisión. + +Para requerir una revisión antes de que el workflow actualice tu contenido, selecciona **Require review** en el panel de configuración. + + + Para repositorios de GitHub, las actualizaciones automáticas requieren que la Mintlify GitHub App tenga permisos de bypass en cada ruleset que apunte a tu rama de despliegue, incluidos los rulesets a nivel de organización y a nivel de repositorio. Consulta [Configurar automerge](/es/guides/configure-automerge) para las instrucciones de configuración. + + Para repositorios de GitLab, automerge utiliza la conexión OAuth de GitLab y requiere al menos el rol de Maintainer en cada proyecto. + + +
+ ### Repositorios de contexto +
+ +Para workflows personalizados y algunos workflows predefinidos, puedes añadir repositorios de contexto: repositorios de código fuente adicionales que el agente lee cuando se ejecuta el workflow. Esto es útil cuando el prompt de tu workflow hace referencia a código, APIs u otro contenido que vive fuera del repositorio de tu proyecto. + +Puedes añadir hasta 10 repositorios de contexto por workflow. Para cada repositorio de GitHub, la Mintlify GitHub App debe estar instalada. Añade repositorios en la página [Configuración de GitHub App](https://app.mintlify.com/settings/organization/github-app). + +
+ ### Instrucciones +
+ +Añade instrucciones opcionales que se adjuntan al prompt base del workflow en cada ejecución. Úsalas para ajustar el estilo, el tono u otros comportamientos específicos del proyecto sin cambiar la lógica principal del workflow. + +
+ ### Idiomas de destino +
+ +Cuando activas el workflow **traducir contenido**, selecciona uno o más idiomas para mantenerlos sincronizados con tu contenido fuente. + +- Mintlify lee los [idiomas](/es/organize/navigation#languages) definidos en tu `docs.json` para identificar tu idioma predeterminado y preselecciona los idiomas de destino ya configurados. +- Debes seleccionar al menos un idioma de destino para guardar el workflow. +- No puedes seleccionar el idioma fuente como destino. + +Puedes añadir idiomas de destino en cualquier momento abriendo la configuración del workflow y editando el campo **Translate to**. + + + +
+ ## Desactivar un workflow +
1. Ve a la página [Workflows](https://app.mintlify.com/products/workflows?tab=workflows) en tu panel. -2. Haz clic en el botón de configuración junto a un workflow. -3. Haz clic en **Delete**. +2. Haz clic en el interruptor junto a un workflow para desactivarlo. + +Cuando reactivas un workflow programado, Mintlify recalcula la próxima hora de ejecución a partir de la hora actual.
## Ver el historial de ejecuciones @@ -29,10 +106,9 @@ Eliminar un workflow es permanente y borra su configuración e historial de ejec Cada workflow mantiene un registro de ejecuciones pasadas, incluido el estado y un resumen de los cambios realizados. -1. Ve a la página [Workflows](https://app.mintlify.com/products/workflows) en tu panel. -2. Haz clic en un workflow. -3. Usa los menús desplegables para filtrar por workflows específicos o por estado. +1. Ve a la página [Workflow Runs](https://app.mintlify.com/products/workflows) en tu panel. +2. Usa los menús desplegables para filtrar por workflows específicos o por estado. - Ejecuciones de workflows con el menú de filtro de estado abierto. - Ejecuciones de workflows con el menú de filtro de estado abierto. + Página de ejecuciones de workflows mostrando los filtros de workflow y estado. + Página de ejecuciones de workflows mostrando los filtros de workflow y estado. diff --git a/es/workflows/reference.mdx b/es/workflows/reference.mdx new file mode 100644 index 0000000000..824b212dd3 --- /dev/null +++ b/es/workflows/reference.mdx @@ -0,0 +1,85 @@ +--- +title: "Workflows predefinidos" +description: "Referencia de todos los workflows predefinidos de Mintlify, incluidos el trigger por defecto, el modo de actualización, el soporte de repositorios de contexto y las configuraciones requeridas." +keywords: ["predefinido", "automatización", "por defecto"] +--- + +Mintlify incluye workflows predefinidos para las tareas de mantenimiento de documentación más comunes. Cada workflow tiene un prompt base y una configuración por defecto. Puedes personalizar el trigger, el modo de actualización y las instrucciones desde la página [Workflows](https://app.mintlify.com/products/workflows?tab=workflows) en tu panel. + +
+ ## Workflows de contenido autoactualizable +
+ +Los workflows de contenido autoactualizable realizan actualizaciones basadas en el contexto que defines, de modo que tu contenido se mantenga preciso y al día. + +
+ ### Actualizar desde cambios de código +
+ +Monitorea tus repositorios de código fuente y abre pull requests para actualizar el contenido cuando se produzcan cambios que afecten a los usuarios. Puedes ejecutar este workflow según una programación, lo que generalmente consume menos créditos, o en cada pull request de código fuente. Por defecto, el workflow se ejecuta con una programación semanal. + +Cuando ejecutas el workflow según una programación, el agente lee todas las pull requests de código fuente mergeadas desde la última vez que se ejecutó el workflow. Agrupa los cambios relacionados que requieren actualizaciones de contenido en una pull request en tu repositorio de proyecto de Mintlify. Si hay pull requests sin mergear de ejecuciones anteriores, el agente añade los cambios relevantes a las pull requests existentes. El agente cita la procedencia de los cambios en tus repositorios de código fuente. + +Cuando ejecutas el workflow en cada pull request de código fuente, el agente crea una pull request de actualización de contenido cada vez que mergeas una pull request de código fuente que requiere actualizaciones de contenido. Usa la variante basada en push cuando quieras que las actualizaciones de contenido aparezcan tan pronto como se publique el código, en lugar de agruparlas según una programación. + +
+ ### Borrador de changelog +
+ +Crea una entrada de changelog según una programación recurrente. Añade repositorios de código fuente como contexto para que el agente tenga más detalles sobre cómo cambió tu producto. Sin repositorios de contexto, el agente trabaja a partir de tus actualizaciones de contenido para escribir una entrada de changelog. + +
+ ### Borrador de mejoras a partir de conversaciones del asistente +
+ +Revisa las tendencias de preguntas de tu [asistente](/es/assistant/index) para identificar lagunas en tu contenido, y luego abre una pull request para abordarlas. Cuantas más conversaciones del asistente tengan tus usuarios, más señal tendrá el agente para trabajar. Ejecuta este workflow según una programación recurrente para mantener el contenido alineado con lo que los usuarios quieren saber sobre tu producto. + +
+ ### Borrador de mejoras a partir de comentarios de usuarios +
+ +Revisa los [comentarios](/es/optimize/feedback) de las páginas — valoraciones con pulgar arriba/abajo y comentarios escritos — y actualiza el contenido en las páginas donde los usuarios han reportado problemas. El agente se centra en las páginas con señales negativas recurrentes en lugar de en comentarios aislados, por lo que los resultados mejoran a medida que se acumulan los comentarios. + +Debes habilitar la recopilación de comentarios en la página [Complementos](https://app.mintlify.com/products/addons) antes de poder usar este workflow. + +
+ ## Workflows de mantenimiento +
+ +Los workflows de mantenimiento automatizan tareas rutinarias para mejorar la calidad y la consistencia de tu contenido. Puedes ejecutarlos con un trigger de actualización de contenido o según una programación recurrente. + +Ejecutarlos con un trigger de actualización de contenido mantiene tu contenido con un retraso mínimo. Ejecutarlos según una programación suele ser más eficiente en créditos, ya que el agente agrupa el trabajo de varios cambios en una sola ejecución, pero hay un retraso entre el momento en que cambia el contenido y el momento en que el workflow de mantenimiento actúa sobre él. + +Cualquier workflow de mantenimiento habilitado se ejecuta en las pull requests creadas por workflows de contenido autoactualizable. Si se requieren cambios para el workflow de mantenimiento, el agente combina el trabajo en una sola pull request. Por ejemplo, si habilitas el workflow **traducir contenido**, el agente añade traducciones a las pull requests abiertas por el workflow **actualizar desde cambios de código**. + +
+ ### Traducir contenido +
+ +Traduce el contenido actualizado a los idiomas de destino que selecciones cada vez que se hagan push de cambios a tu repositorio de proyecto. Debes especificar al menos un idioma de destino. Mintlify lee los [idiomas](/es/organize/navigation#languages) definidos en tu `docs.json` y preselecciona los idiomas de destino ya configurados. + +Para deshabilitar las traducciones de un idioma, elimina todos los archivos en el directorio de ese idioma. No puedes deshabilitar las traducciones de un idioma que todavía tiene contenido publicado. + + + +Encuentra y repara enlaces internos y externos rotos cada vez que se hagan push de cambios de contenido a tu repositorio de proyecto. Es útil ejecutarlo después de reorganizaciones importantes de contenido o cuando los servicios externos a los que haces referencia cambian sus URLs. + +
+ ### Auditar metadatos de SEO +
+ +Audita y actualiza los títulos, las meta descripciones, los encabezados y las etiquetas canónicas cada vez que cambie el contenido. Añade instrucciones para alinear las sugerencias del agente con tu estrategia de SEO o con palabras clave objetivo. + +
+ ### Corregir gramática y erratas +
+ +Encuentra y corrige erratas, errores ortográficos y errores gramaticales cada vez que cambie el contenido. Añade instrucciones para especificar excepciones para términos técnicos, nombres de productos o decisiones estilísticas intencionales que el agente no deba cambiar. + +
+ ### Aplicar guía de estilo +
+ +Aplica reglas de voz, tono y escritura al contenido cada vez que cambia. Añade instrucciones para definir las reglas específicas que quieres que se apliquen o enlaza tu guía de estilo. Cuanto más precisas sean tus instrucciones, más consistentes serán los resultados. diff --git a/fr.json b/fr.json index fcd2a971ea..f79bd9f4d0 100644 --- a/fr.json +++ b/fr.json @@ -272,6 +272,7 @@ "pages": [ "fr/guides/assistant-embed", "fr/guides/configure-automerge", + "fr/guides/use-workflows", "fr/guides/claude-code", "fr/guides/cursor", "fr/guides/geo", diff --git a/fr/agent/use-cases.mdx b/fr/agent/use-cases.mdx index f84c1eb209..9ef3d73bc0 100644 --- a/fr/agent/use-cases.mdx +++ b/fr/agent/use-cases.mdx @@ -84,7 +84,7 @@ Par exemple : `@mintlify Users are getting confused by step 3 in the setup guid Créez des workflows pour automatiser les tâches récurrentes et les tâches de maintenance réactive, comme la rédaction de journaux des modifications ou la mise à jour du contenu lorsque vous ajoutez de nouvelles fonctionnalités à votre produit. -Consultez [Workflows](/workflows/index) pour plus d’informations. +Consultez [Vue d'ensemble des workflows](/fr/workflows/index) pour plus d'informations.
## Automatiser avec l'API diff --git a/fr/changelog.mdx b/fr/changelog.mdx index 8b21152fc8..a0189d8e4b 100644 --- a/fr/changelog.mdx +++ b/fr/changelog.mdx @@ -34,7 +34,7 @@ noindex: true ## Workflows
- - **Améliorer la documentation à partir des retours** est désormais un workflow dédié qui examine les [retours récents sur les pages](/fr/optimize/feedback) et ouvre des mises à jour ciblées de la documentation à partir de ce que rapportent les utilisateurs. Voir [Workflows](/fr/workflows/enable#improve-docs-from-feedback). + - **Améliorer la documentation à partir des retours** est désormais un workflow dédié qui examine les [retours récents sur les pages](/fr/optimize/feedback) et ouvre des mises à jour ciblées de la documentation à partir de ce que rapportent les utilisateurs. Voir [Workflows](/fr/workflows/reference#draft-improvements-from-user-feedback). - Le workflow **Sync content with code** a été renommé en **Self-updating site** pour mieux refléter sa fonction. - Les titres et le contenu des workflows dans le tableau de bord ont été retravaillés pour plus de clarté. @@ -93,7 +93,7 @@ noindex: true ## Workflows
- - Le nouveau workflow **Improve content from assistant conversations** analyse les tendances des questions des utilisateurs et suggère des mises à jour de documentation pour combler les lacunes. Consultez [Workflows](https://www.mintlify.com/docs/workflows/enable#improve-docs-from-assistant-chats). + - Le nouveau workflow **Draft improvements from assistant conversations** analyse les tendances des questions des utilisateurs et suggère des mises à jour de documentation pour combler les lacunes. Consultez [Workflows](/fr/workflows/reference#draft-improvements-from-assistant-conversations). - Les **dépôts de contexte** peuvent désormais être configurés directement pour certains workflows, afin d'ajouter les dépôts qu'un workflow doit consulter pendant son exécution. - Les paramètres des workflows s'ouvrent désormais dans un **panneau latéral** plutôt que dans une fenêtre modale, ce qui facilite les ajustements pendant l'examen des Workflow Runs. diff --git a/fr/guides/index.mdx b/fr/guides/index.mdx index d4d6e2e4fa..04da74ae96 100644 --- a/fr/guides/index.mdx +++ b/fr/guides/index.mdx @@ -20,6 +20,7 @@ Utilisez des outils d'IA pour accélérer votre flux de travail de documenta * [Build an in-app assistant](/fr/guides/assistant-embed) : tutoriel qui explique comment ajouter un chatbot IA dans une application React pour aider les utilisateurs à trouver des réponses dans votre documentation. * [Configurer l'automerge](/fr/guides/configure-automerge) : ajoutez l'application GitHub Mintlify à la liste de contournement d'un ensemble de règles pour activer la fusion automatique des workflows. +* [Utiliser les workflows](/fr/guides/use-workflows) : choisissez le bon trigger de workflow, rédigez des instructions efficaces et obtenez des résultats cohérents grâce à la maintenance de contenu automatisée. * [Claude Code](/fr/guides/claude-code), [Cursor](/fr/guides/cursor), [Windsurf](/fr/guides/windsurf) : guides pour utiliser des assistants de programmation IA afin de maintenir la documentation. * [GEO](/fr/guides/geo) : bonnes pratiques pour optimiser votre documentation pour les moteurs de recherche et de réponse basés sur l'IA. diff --git a/fr/guides/use-workflows.mdx b/fr/guides/use-workflows.mdx new file mode 100644 index 0000000000..d1e1faa731 --- /dev/null +++ b/fr/guides/use-workflows.mdx @@ -0,0 +1,126 @@ +--- +title: "Utiliser les workflows" +description: "Apprenez à utiliser les workflows Mintlify pour automatiser les tâches récurrentes de maintenance de contenu, choisir le type de trigger adapté, rédiger des instructions efficaces et obtenir des résultats cohérents." +keywords: ["workflows", "automatisation", "automatiser", "guide des workflows", "instructions de workflow", "automatisation de l'agent", "auto-mise à jour"] +--- + +Les workflows exécutent l'agent automatiquement afin que votre contenu reste exact sans effort manuel. Ce guide explique comment choisir le bon workflow, le configurer efficacement et rédiger des instructions qui produisent des résultats cohérents. + +
+ ## Quand utiliser les workflows +
+ +Les workflows conviennent particulièrement aux tâches qui sont : + +- **Répétitives** — La même tâche s'exécute régulièrement selon une planification prévisible ou chaque fois qu'un événement spécifique se produit. +- **Chronophages** — Des tâches longues à effectuer manuellement mais qui suivent un schéma cohérent. +- **Réactives** — Des tâches qui doivent se déclencher automatiquement en réponse à des changements de code ou de contenu, comme la mise à jour de la documentation après la livraison d'une fonctionnalité. + +Pour des tâches ponctuelles ou exploratoires, utilisez l'agent directement dans le [tableau de bord](https://app.mintlify.com) ou depuis Slack. + +
+ ## Choisir un trigger +
+ +Chaque workflow s'exécute avec l'un des trois types de trigger. Choisissez celui qui correspond au moment où vous avez besoin que le travail soit effectué. + +| Trigger | À utiliser quand | +|---|---| +| Mise à jour de contenu | La tâche doit s'exécuter chaque fois que le contenu de votre projet change — traduire de nouvelles pages, corriger des liens rompus ou auditer les métadonnées SEO. | +| Changement de code | La tâche doit s'exécuter lorsque le code source change — mettre à jour les spécifications d'API ou la documentation après la fusion d'une PR. | +| Planification personnalisée | La tâche doit s'exécuter à une cadence fixe quoi qu'il arrive — publier des changelogs hebdomadaires ou exécuter des vérifications grammaticales périodiques. | + +
+ ## Workflows prédéfinis +
+ +Mintlify inclut des workflows prédéfinis pour les tâches de maintenance de contenu les plus courantes. Activez l'un d'entre eux depuis la page [Workflows](https://app.mintlify.com/products/workflows?tab=workflows) de votre tableau de bord. + +Consultez [Workflows prédéfinis](/fr/workflows/reference) pour plus de détails. + +
+ ## Workflows personnalisés +
+ +Créez un workflow personnalisé pour les tâches qui ne sont pas couvertes par les options prédéfinies. Les workflows personnalisés vous donnent un contrôle total sur le trigger, les instructions et les dépôts de contexte. + +Consultez [Créer un workflow personnalisé](/fr/workflows/create) pour les étapes de configuration. + +
+ ### Rédiger des instructions efficaces +
+ +Les instructions d'un workflow personnalisé sont des prompts que l'agent suit à chaque exécution. La qualité de vos instructions affecte directement la cohérence des résultats. + +**Décrivez le résultat, pas seulement la tâche.** Indiquez à l'agent à quoi ressemble un travail terminé. + + +```text Moins efficace +Examinez les pages de référence de l'API. +``` + +```text Plus efficace +Examinez chaque page du répertoire /api-reference. Pour chaque endpoint, confirmez que les paramètres de la requête, les champs de réponse et les exemples de payloads correspondent à la spécification OpenAPI dans le fichier api/openapi.yaml. Ouvrez une pull request avec des corrections pour toutes les divergences que vous trouvez. +``` + + +**Rédigez une procédure.** Les agents suivent des instructions étape par étape de manière plus fiable que des prompts ouverts. + +```text Exemple de procédure +1. Lisez le diff de la pull request fusionnée du dépôt déclencheur. +2. Identifiez les endpoints, paramètres ou formes de réponse de l'API qui ont changé. +3. Recherchez dans la documentation les pages qui font référence à ces endpoints. +4. Mettez à jour les pages concernées pour qu'elles correspondent aux changements de la pull request. +5. Ouvrez une pull request avec un résumé des pages que vous avez modifiées et pourquoi. +``` + +**Limitez le périmètre.** Un workflow qui fait une chose bien est plus fiable qu'un workflow qui essaie d'en faire plusieurs. Répartissez les tâches complexes entre plusieurs workflows. + +**Spécifiez les fichiers et les répertoires.** Plus vous êtes précis sur l'endroit où l'agent doit chercher, moins il passe de temps à explorer. + +```text Exemple avec des chemins spécifiques +Vérifiez chaque fichier MDX du répertoire /content pour repérer les liens internes rompus (liens commençant par /). +Pour chaque lien rompu, corrigez le chemin ou supprimez le lien s'il n'existe pas de remplacement. +``` + +
+ ### Utiliser des dépôts de contexte +
+ +Pour les workflows personnalisés et certains workflows prédéfinis, vous pouvez ajouter des dépôts de contexte que l'agent lit lors de l'exécution du workflow. + +Ajoutez des dépôts de contexte lorsque : +- Votre contenu fait référence à du code, à des APIs ou à de la configuration qui se trouvent dans un dépôt distinct. +- Vous souhaitez que l'agent compare votre contenu au code source lorsqu'il décide de ce qu'il doit mettre à jour. +- Le prompt du workflow fait référence à des fichiers en dehors du dépôt de votre projet Mintlify. + +Vous pouvez ajouter jusqu'à 10 dépôts de contexte par workflow. + +
+ ### Mode de mise à jour +
+ +Décidez du niveau de revue que vous souhaitez avant la publication des changements. + +- **Automatique** : Les changements sont fusionnés directement dans le dépôt de votre projet Mintlify sans revue. Idéal pour des tâches à faible risque et haute fréquence comme la traduction, les vérifications grammaticales et la correction de liens. +- **Exiger une revue** : L'agent ouvre une pull request et une personne la relit avant la fusion. Idéal pour les tâches qui modifient le sens du contenu, comme la synchronisation avec les changements de code ou la mise à jour des références d'API. + +
+ ## Contrôler l'utilisation des crédits +
+ +Chaque exécution de workflow consomme des crédits. Par exemple, la plupart des exécutions du workflow **mettre à jour à partir des changements de code** coûtent entre 40 et 180 crédits. Les exécutions complexes qui mettent à jour de nombreuses pages coûtent davantage. + +Planifier des tâches cron pour qu'elles s'exécutent à des moments précis vous permet de contrôler plus finement l'utilisation des crédits. Par exemple, vous pouvez exécuter un workflow une fois par jour ou une fois par semaine pour savoir exactement combien de pull requests un workflow crée par mois, plutôt que d'avoir une variation mensuelle en fonction des changements de contenu ou de code. + +
+ ## Examiner et améliorer les résultats des workflows +
+ +Les workflows s'exécutent automatiquement, mais ils gagnent à être examinés périodiquement. + +1. Ouvrez l'onglet **Runs** de la page [Workflows](https://app.mintlify.com/products/workflows) pour voir l'historique récent des exécutions et leur statut. +2. Cliquez sur une exécution pour lire le résumé de l'agent et examiner les pull requests qu'il a ouvertes. +3. Si les résultats sont incohérents, affinez vos instructions : ajoutez des procédures plus précises, réduisez la portée des fichiers ou répartissez le workflow en tâches plus petites. + +Quelques cycles de revue après l'activation d'un nouveau workflow suffisent généralement à affiner les instructions. diff --git a/fr/workflows/create.mdx b/fr/workflows/create.mdx new file mode 100644 index 0000000000..5146dbd910 --- /dev/null +++ b/fr/workflows/create.mdx @@ -0,0 +1,56 @@ +--- +title: "Créer un workflow personnalisé" +description: "Créez un workflow Mintlify personnalisé avec un trigger planifié ou de type push, des dépôts de contexte et un prompt pour l'agent afin d'automatiser les tâches récurrentes de documentation." +keywords: ["automatisation", "automatiser", "cron", "agent", "workflow personnalisé"] +--- + +import GitlabWorkflowSetup from '/snippets/fr/gitlab-workflow-setup.mdx'; + +
+ ## Prérequis +
+ +- Un projet Mintlify connecté à un dépôt GitHub ou GitLab +- Pour GitHub : l'[application GitHub Mintlify](/fr/deploy/github) installée sur chaque dépôt que vous prévoyez d'utiliser dans le workflow +- Pour GitLab : un compte GitLab connecté (voir [Configuration GitLab](#gitlab-setup) ci-dessous) + +
+ ## Créer un workflow personnalisé +
+ + + L'agent s'exécute dans un sandbox isolé avec un accès restreint à Internet. Il ne peut pas installer de packages ou d'outils supplémentaires au moment de l'exécution. Les prompts qui font référence à des outils indisponibles peuvent produire des résultats inattendus ou échouer. + + +1. Ouvrez la page [Workflows](https://app.mintlify.com/products/workflows?tab=workflows) dans votre tableau de bord. +2. Cliquez sur **Create a custom workflow**. +3. Configurez le nom du workflow, le trigger, les instructions, les dépôts de contexte et le mode de mise à jour. +4. Cliquez sur **Create workflow**. + +
+ ## Rédiger des instructions efficaces +
+ +Des instructions de workflow efficaces se concentrent sur une seule tâche et définissent un résultat clair et vérifiable. Les workflows présentent une certaine variabilité car les agents ne sont pas déterministes, mais des instructions bien formatées produisent des résultats plus cohérents. + +- **Décrivez le résultat.** Indiquez à l'agent à quoi doit ressembler le résultat d'une exécution réussie. +- **Rédigez une procédure.** Donnez à l'agent un guide étape par étape à suivre. +- **Limitez le périmètre.** Répartissez les tâches complexes entre plusieurs workflows plutôt que de les combiner dans un seul prompt. + +Pour plus d'exemples et de modèles, consultez [Utiliser les workflows](/fr/guides/use-workflows). + + + Examinez la sortie de vos workflows personnalisés pour confirmer qu'ils fonctionnent comme prévu. Mettez à jour vos instructions pour améliorer les résultats. + + + + +
+ ## Supprimer un workflow personnalisé +
+ +La suppression d'un workflow est définitive et supprime sa configuration ainsi que son historique d'exécution. + +1. Accédez à la page [Workflows](https://app.mintlify.com/products/workflows?tab=workflows) dans votre tableau de bord. +2. Cliquez sur le bouton de paramètres à côté d'un workflow. +3. Cliquez sur **Delete**. diff --git a/fr/workflows/enable.mdx b/fr/workflows/enable.mdx deleted file mode 100644 index 6d6dbb3308..0000000000 --- a/fr/workflows/enable.mdx +++ /dev/null @@ -1,117 +0,0 @@ ---- -title: "Activer les workflows" -description: "Activez les workflows sur votre projet Mintlify. Configurez les déclencheurs GitHub ou GitLab, ajoutez des dépôts de contexte, définissez des planifications et activez la fusion automatique pour l'agent." -keywords: ["cron", "déclencheur push", "fusion automatique"] ---- - -import GitlabWorkflowSetup from '/snippets/fr/gitlab-workflow-setup.mdx'; - -
- ## Prérequis -
- -- Un projet Mintlify connecté à un dépôt GitHub ou GitLab -- Pour GitHub : l'[application GitHub Mintlify](/fr/deploy/github) installée sur chaque dépôt que vous prévoyez d'utiliser dans le workflow -- Pour GitLab : un compte GitLab connecté (voir [Configuration GitLab](#gitlab-setup) ci-dessous) - -
- ## Activer les workflows -
- -1. Ouvrez la page [Workflows](https://app.mintlify.com/products/workflows?tab=workflows) dans votre tableau de bord. -2. Cliquez sur l'interrupteur à côté d'un workflow pour l'activer. - - Le tableau de bord des workflows. - Le tableau de bord des workflows. - - - Si le workflow peut s'exécuter avec les paramètres par défaut, il s'active immédiatement. Sinon, la fenêtre de paramètres s'ouvre pour vous permettre de choisir les configurations requises. - - Les options de configuration du workflow de mises à jour de la base de code. - Les options de configuration du workflow de mises à jour de la base de code. - -3. Si la fenêtre s'ouvre, remplissez les champs requis et cliquez sur **Turn on workflow**. - - Pour modifier les paramètres d'un workflow actif, cliquez sur le bouton de paramètres à côté de celui-ci. Utilisez l'interrupteur dans l'en-tête de la fenêtre pour activer ou désactiver le workflow sans quitter la vue des paramètres. - -
- ## Configurations -
- -
- ### Dépôts de déclenchement -
- -Pour les workflows qui s'exécutent sur des événements push, spécifiez les dépôts à surveiller. Vous pouvez spécifier jusqu'à 10 dépôts par workflow. - -Pour les dépôts GitHub, vous devez installer l'application GitHub Mintlify sur chaque dépôt. Ajoutez des dépôts sur la page de paramètres de l'[application GitHub](https://app.mintlify.com/settings/organization/github-app). - -
- ### Mode de mise à jour -
- -Chaque workflow possède un mode par défaut pour effectuer les mises à jour, soit en mettant à jour directement votre dépôt de contenu, soit en ouvrant une pull request. - -Si vous souhaitez exiger une révision avant qu'un workflow ne mette à jour votre contenu, cliquez sur **Require review**. - - - Pour les dépôts GitHub, les mises à jour automatiques nécessitent que l'application GitHub Mintlify dispose de permissions de contournement 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 la fusion automatique](/fr/guides/configure-automerge) pour les instructions de configuration. - - Pour les dépôts GitLab, la fusion automatique utilise la connexion OAuth de GitLab et nécessite au moins le rôle Mainteneur sur chaque projet. - - -
- ### Déclencheur -
- -Chaque workflow a une valeur par défaut quant au moment de son exécution, soit en réponse à des changements dans votre dépôt de contenu, soit en réponse à des changements dans un dépôt de déclenchement, soit selon une planification. - -Si vous souhaitez modifier la valeur par défaut, sélectionnez un autre déclencheur. - -
- ### Instructions -
- -Ajoutez des instructions facultatives qui seront ajoutées au prompt de base du workflow. Utilisez ces instructions pour ajuster le style, le ton ou d'autres aspects propres à votre projet. - -
- ### Langues cibles -
- -Lorsque vous activez le workflow **Translate content**, sélectionnez une ou plusieurs langues que vous souhaitez maintenir synchronisées avec votre contenu source. - -- Mintlify lit les [langues](/fr/organize/navigation#languages) définies dans votre `docs.json` pour identifier votre langue par défaut et présélectionne toutes les langues cibles déjà configurées. -- Vous devez sélectionner au moins une langue cible pour enregistrer le workflow. -- Vous ne pouvez pas sélectionner la langue source comme langue cible. - -Vous pouvez modifier les langues cibles à tout moment en ouvrant les paramètres du workflow et en modifiant le champ **Translate to**. - -
- #### Exécuter une traduction immédiatement -
- -Après avoir enregistré le workflow, cliquez sur **Translate now** pour l'exécuter à la demande en utilisant les langues cibles actuellement enregistrées. Le workflow doit être activé pour déclencher une exécution manuelle. Les exécutions manuelles n'affectent pas le déclencheur régulier du workflow. - -
- ## Améliorer la documentation à partir des conversations avec l'assistant -
- -Le workflow **Improve docs from assistant chats** examine les tendances récentes dans les questions posées à l'[assistant](/fr/assistant/index) et ouvre des mises à jour ciblées de la documentation qui comblent les lacunes rencontrées par vos utilisateurs. - -Utilisez ce workflow lorsque vous souhaitez que l'agent trie l'activité de l'assistant à votre place et propose des modifications qui répondent aux questions que les utilisateurs posent réellement. - -Ce workflow s'exécute selon une planification. Il ne nécessite pas de dépôts de déclenchement ni de configuration de contexte supplémentaire. Activez-le depuis la page [Workflows](https://app.mintlify.com/products/workflows?tab=workflows) et choisissez si les mises à jour doivent être fusionnées automatiquement ou ouvrir une pull request pour révision. - -
- ## Améliorer la documentation à partir des retours -
- -Le workflow **Improve docs from feedback** examine les [retours sur les pages](/fr/optimize/feedback) récents et ouvre des mises à jour ciblées de la documentation basées sur les problèmes signalés par les utilisateurs. - -Utilisez ce workflow lorsque vous collectez des évaluations par pouces ou des retours contextuels et que vous souhaitez que l'agent convertisse ce signal en modifications concrètes de la documentation. - -Lorsqu'une exécution se termine, les détails de l'exécution dans votre tableau de bord incluent les citations spécifiques des retours utilisées par l'agent. Chaque citation renvoie au retour dans votre [tableau de bord d'analyse](https://app.mintlify.com/products/analytics/v2/feedback) pour que vous puissiez vérifier le contexte qui a motivé la mise à jour. - -Ce workflow s'exécute selon une planification et nécessite que la collecte des retours soit activée sur la page [Add-ons](https://app.mintlify.com/products/addons). Il ne nécessite pas de dépôts de déclenchement ni de configuration de contexte supplémentaire. - - diff --git a/fr/workflows/index.mdx b/fr/workflows/index.mdx new file mode 100644 index 0000000000..7ea627032b --- /dev/null +++ b/fr/workflows/index.mdx @@ -0,0 +1,56 @@ +--- +title: "Vue d'ensemble des workflows" +sidebarTitle: "Vue d'ensemble" +description: "Automatisez la maintenance du contenu avec les workflows Mintlify. Exécutez l'agent selon une planification ou en réponse à des pushes dans des dépôts GitHub et GitLab." +keywords: ["automatisation", "automatiser", "cron", "agent", "workflows"] +boost: 5 +--- + +Les workflows exécutent l'agent automatiquement selon une planification ou en réponse à des changements dans un dépôt. Chaque workflow définit un prompt pour l'agent et un trigger qui indique quand l'exécuter. Les workflows prennent en charge à la fois les dépôts GitHub et GitLab. + +Lorsqu'un workflow s'exécute, l'agent lit le contenu de votre projet et les dépôts connectés, puis suit le prompt pour effectuer les mises à jour. + + +Utilisez des workflows qui s'exécutent selon une planification pour les tâches récurrentes, comme la publication de changelogs ou l'audit des métadonnées SEO. + +Utilisez des workflows qui se déclenchent sur des changements de contenu ou de code pour la maintenance réactive, comme les traductions ou la mise à jour du contenu lorsque le code source change. + + +
+ ## Types de trigger +
+ +Les workflows prennent en charge trois types de trigger. + +- **Mise à jour de contenu** — S'exécute lorsque des changements de contenu sont poussés vers votre dépôt de projet Mintlify, y compris les fusions de pull requests et les pushes directs. +- **Changement de code** — S'exécute lorsqu'une pull request est fusionnée dans un dépôt de code source connecté. +- **Planification personnalisée** — S'exécute selon une planification récurrente. Les workflows sont mis en file d'attente dans les 10 minutes suivant l'heure planifiée. + +Chaque workflow a exactement un trigger. Vous ne pouvez pas combiner des types de trigger dans un seul workflow. + +
+ ## Limites d'utilisation +
+ +Les exécutions de workflows comptent dans votre utilisation de crédits. Consultez votre utilisation de crédits, configurez les dépassements et gérez votre forfait de crédits sur la page [Utilisation](https://app.mintlify.com/settings/organization/usage) de votre tableau de bord. + +Chaque workflow peut s'exécuter jusqu'à 500 fois par jour. Les exécutions en échec ne comptent pas dans cette limite. + +
+ ## Étapes suivantes +
+ + + + Référence pour tous les workflows prédéfinis : triggers, modes de mise à jour et configuration requise. + + + Activez les workflows prédéfinis et configurez les triggers, le mode de mise à jour et le contexte. + + + Créez un workflow avec votre propre trigger, vos instructions et vos dépôts de contexte. + + + Choisissez le bon trigger, rédigez des instructions efficaces et examinez les résultats. + + diff --git a/fr/workflows/manage.mdx b/fr/workflows/manage.mdx index 28e64d1110..16154fad85 100644 --- a/fr/workflows/manage.mdx +++ b/fr/workflows/manage.mdx @@ -1,27 +1,104 @@ --- title: "Gérer les workflows" -description: "Déclenchez, désactivez, réactivez et supprimez des workflows Mintlify depuis votre tableau de bord, et découvrez comment les planifications sont recalculées après avoir mis en pause et repris un workflow." -keywords: ["gérer les workflows", "déclencher un workflow", "désactiver un workflow", "activer un workflow"] +description: "Activez, désactivez, déclenchez et supprimez des workflows depuis votre tableau de bord. Configurez des triggers GitHub ou GitLab, ajoutez des dépôts de contexte, définissez des planifications et activez l'automerge." +keywords: ["cron", "push", "automerge", "contexte", "instructions de workflow", "trigger", "désactiver un workflow", "activer un workflow"] --- -
- ## Désactiver un workflow +import GitlabWorkflowSetup from '/snippets/fr/gitlab-workflow-setup.mdx'; + +
+ ## Prérequis
-1. Accédez à la page [Workflows](https://app.mintlify.com/products/workflows?tab=workflows) dans votre tableau de bord. -2. Cliquez sur l'interrupteur à côté d'un workflow pour le désactiver. +- Un projet Mintlify connecté à un dépôt GitHub ou GitLab +- Pour GitHub : l'[application GitHub Mintlify](/fr/deploy/github) installée sur chaque dépôt que vous prévoyez d'utiliser dans le workflow +- Pour GitLab : un compte GitLab connecté (voir [Configuration GitLab](#gitlab-setup) ci-dessous) -Lorsque vous réactivez un workflow planifié, Mintlify recalcule la prochaine heure d'exécution à partir de l'heure actuelle. +
+ ## Activer un workflow +
+ +1. Ouvrez la page [Workflows](https://app.mintlify.com/products/workflows?tab=workflows) dans votre tableau de bord. +2. Cliquez sur l'interrupteur à côté d'un workflow pour l'activer. + + Le tableau de bord des workflows. + Le tableau de bord des workflows. + + + Si le workflow peut s'exécuter avec les paramètres par défaut, il s'active immédiatement. Sinon, le panneau de paramètres s'ouvre pour vous permettre de renseigner les configurations requises. + + Les options de configuration d'un workflow. + Les options de configuration d'un workflow. + +3. Si le panneau de paramètres s'ouvre, renseignez les champs requis. +4. Cliquez sur **Turn on workflow**. + +Pour modifier les paramètres d'un workflow actif, cliquez sur le bouton de paramètres à côté de celui-ci. Utilisez l'interrupteur dans l'en-tête du modal pour activer ou désactiver le workflow sans quitter la vue des paramètres. -
- ## Supprimer un workflow personnalisé +
+ ## Configurations
-La suppression d'un workflow est définitive et supprime sa configuration ainsi que son historique d'exécution. +
+ ### Trigger +
+ +Chaque workflow possède un trigger par défaut qui contrôle quand il s'exécute. Pour changer le trigger, sélectionnez une autre option dans le panneau de paramètres. + +- **Mise à jour de contenu** — S'exécute lorsque du contenu est poussé vers votre dépôt de projet, y compris les fusions de pull requests et les pushes directs. +- **Changement 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. +- **Planification personnalisée** — S'exécute selon une planification récurrente que vous définissez. Les workflows sont mis en file d'attente dans les 10 minutes suivant l'heure planifiée. + +
+ ### Mode de mise à jour +
+ +Chaque workflow possède un mode par défaut pour la façon dont il effectue les mises à jour. Soit en fusionnant directement les changements dans votre dépôt de contenu, soit en ouvrant une pull request pour examen. + +Pour exiger une revue avant que le workflow mette à jour votre contenu, sélectionnez **Require review** dans le panneau de paramètres. + + + Pour les dépôts GitHub, les mises à jour automatiques nécessitent que l'application GitHub Mintlify dispose des autorisations de bypass sur chaque ruleset ciblant votre branche de déploiement, y compris les rulesets au niveau de l'organisation et au niveau du dépôt. Voir [Configurer l'automerge](/fr/guides/configure-automerge) pour les instructions de configuration. + + Pour les dépôts GitLab, l'automerge utilise la connexion OAuth GitLab et nécessite au moins le rôle Mainteneur sur chaque projet. + + +
+ ### Dépôts de contexte +
+ +Pour les workflows personnalisés et certains workflows prédéfinis, vous pouvez ajouter des dépôts de contexte — des dépôts de code source supplémentaires que l'agent lit lors de l'exécution du workflow. Cela est utile lorsque le prompt de votre workflow fait référence à du code, à des APIs ou à d'autres contenus qui se trouvent en dehors du dépôt de votre projet. + +Vous pouvez ajouter jusqu'à 10 dépôts de contexte par workflow. Pour chaque dépôt GitHub, l'application GitHub Mintlify doit être installée. Ajoutez des dépôts sur la page [Paramètres de l'application GitHub](https://app.mintlify.com/settings/organization/github-app). + +
+ ### Instructions +
+ +Ajoutez des instructions optionnelles qui s'ajoutent au prompt de base du workflow à chaque exécution. Utilisez-les pour ajuster le style, le ton ou d'autres comportements propres au projet sans modifier la logique principale du workflow. + +
+ ### Langues cibles +
+ +Lorsque vous activez le workflow **traduire le contenu**, sélectionnez une ou plusieurs langues à maintenir synchronisées avec votre contenu source. + +- Mintlify lit les [langues](/fr/organize/navigation#languages) définies dans votre `docs.json` pour identifier votre langue par défaut et présélectionne les langues cibles déjà configurées. +- Vous devez sélectionner au moins une langue cible pour enregistrer le workflow. +- Vous ne pouvez pas sélectionner la langue source comme cible. + +Vous pouvez ajouter des langues cibles à tout moment en ouvrant les paramètres du workflow et en modifiant le champ **Translate to**. + + + +
+ ## Désactiver un workflow +
1. Accédez à la page [Workflows](https://app.mintlify.com/products/workflows?tab=workflows) dans votre tableau de bord. -2. Cliquez sur le bouton de paramètres à côté d'un workflow. -3. Cliquez sur **Delete**. +2. Cliquez sur l'interrupteur à côté d'un workflow pour le désactiver. + +Lorsque vous réactivez un workflow planifié, Mintlify recalcule la prochaine heure d'exécution à partir de l'heure actuelle.
## Consulter l'historique des exécutions @@ -29,10 +106,9 @@ La suppression d'un workflow est définitive et supprime sa configuration ainsi Chaque workflow conserve un journal des exécutions passées, comprenant le statut et un résumé des modifications apportées. -1. Accédez à la page [Workflows](https://app.mintlify.com/products/workflows) dans votre tableau de bord. -2. Cliquez sur un workflow. -3. Utilisez les menus déroulants pour filtrer par workflows spécifiques ou par statut. +1. Accédez à la page [Workflow Runs](https://app.mintlify.com/products/workflows) dans votre tableau de bord. +2. Utilisez les menus déroulants pour filtrer par workflows spécifiques ou par statut. - Exécutions de workflows avec le menu de filtre de statut ouvert. - Exécutions de workflows avec le menu de filtre de statut ouvert. + Page des exécutions de workflows montrant les filtres par workflow et par statut. + Page des exécutions de workflows montrant les filtres par workflow et par statut. diff --git a/fr/workflows/reference.mdx b/fr/workflows/reference.mdx new file mode 100644 index 0000000000..b84ecc0ae1 --- /dev/null +++ b/fr/workflows/reference.mdx @@ -0,0 +1,85 @@ +--- +title: "Workflows prédéfinis" +description: "Référence pour tous les workflows Mintlify prédéfinis, incluant le trigger par défaut, le mode de mise à jour, la prise en charge des dépôts de contexte et les configurations requises." +keywords: ["prédéfini", "automatisation", "par défaut"] +--- + +Mintlify inclut des workflows prédéfinis pour les tâches de maintenance de documentation les plus courantes. Chaque workflow possède un prompt de base et une configuration par défaut. Vous pouvez personnaliser le trigger, le mode de mise à jour et les instructions depuis la page [Workflows](https://app.mintlify.com/products/workflows?tab=workflows) de votre tableau de bord. + +
+ ## Workflows de contenu auto-mis à jour +
+ +Les workflows de contenu auto-mis à jour effectuent des mises à jour en fonction du contexte que vous définissez afin que votre contenu reste exact et à jour. + +
+ ### Mettre à jour à partir des changements de code +
+ +Surveille vos dépôts de code source et ouvre des pull requests pour mettre à jour le contenu lors de changements qui affectent les utilisateurs. Vous pouvez exécuter ce workflow selon une planification, ce qui consomme généralement moins de crédits, ou à chaque pull request de code source. Par défaut, le workflow s'exécute selon une planification hebdomadaire. + +Lorsque vous exécutez le workflow selon une planification, l'agent lit toutes les pull requests de code source fusionnées depuis la dernière exécution du workflow. Il regroupe les changements connexes qui nécessitent des mises à jour de contenu dans une pull request dans votre dépôt de projet Mintlify. S'il existe des pull requests non fusionnées issues d'exécutions précédentes, l'agent ajoute les changements pertinents aux pull requests existantes. L'agent cite l'origine des changements dans vos dépôts de code source. + +Lorsque vous exécutez le workflow à chaque pull request de code source, l'agent crée une pull request de mise à jour de contenu chaque fois que vous fusionnez une pull request de code source qui nécessite des mises à jour de contenu. Utilisez la variante basée sur les pushes lorsque vous souhaitez que les mises à jour de contenu apparaissent dès que le code est livré, plutôt que regroupées selon une planification. + +
+ ### Rédiger un changelog +
+ +Crée une entrée de changelog selon une planification récurrente. Ajoutez des dépôts de code source comme contexte pour que l'agent dispose de plus de détails sur l'évolution de votre produit. Sans dépôts de contexte, l'agent travaille à partir de vos mises à jour de contenu pour rédiger une entrée de changelog. + +
+ ### Rédiger des améliorations à partir des conversations de l'assistant +
+ +Analyse les tendances des questions de votre [assistant](/fr/assistant/index) pour identifier les lacunes dans votre contenu, puis ouvre une pull request pour les combler. Plus vos utilisateurs ont de conversations avec l'assistant, plus l'agent dispose de signal pour travailler. Exécutez ce workflow selon une planification récurrente pour maintenir le contenu aligné sur ce que les utilisateurs veulent savoir sur votre produit. + +
+ ### Rédiger des améliorations à partir des retours des utilisateurs +
+ +Analyse les [retours](/fr/optimize/feedback) sur les pages — évaluations pouce haut/bas et commentaires écrits — et met à jour le contenu là où les utilisateurs ont signalé des problèmes. L'agent se concentre sur les pages présentant des signaux négatifs récurrents plutôt que sur des retours isolés, de sorte que les résultats s'améliorent à mesure que les retours s'accumulent. + +Vous devez activer la collecte de retours sur la page [Modules complémentaires](https://app.mintlify.com/products/addons) avant de pouvoir utiliser ce workflow. + +
+ ## Workflows de maintenance +
+ +Les workflows de maintenance automatisent les tâches routinières pour améliorer la qualité et la cohérence de votre contenu. Vous pouvez les exécuter avec un trigger de mise à jour de contenu ou selon une planification récurrente. + +L'exécution avec un trigger de mise à jour de contenu maintient votre contenu avec un délai minimal. L'exécution selon une planification est généralement plus économe en crédits, car l'agent regroupe le travail à travers plusieurs changements dans une seule exécution, mais il y a un délai entre le moment où le contenu change et le moment où le workflow de maintenance agit dessus. + +Tous les workflows de maintenance activés s'exécutent sur les pull requests créées par les workflows de contenu auto-mis à jour. Si des changements sont nécessaires pour le workflow de maintenance, l'agent combine le travail dans une seule pull request. Par exemple, si vous activez le workflow **traduire le contenu**, l'agent ajoute des traductions aux pull requests ouvertes par le workflow **mettre à jour à partir des changements de code**. + +
+ ### Traduire le contenu +
+ +Traduit le contenu mis à jour dans les langues cibles que vous sélectionnez chaque fois que des changements sont poussés vers votre dépôt de projet. Vous devez spécifier au moins une langue cible. Mintlify lit les [langues](/fr/organize/navigation#languages) définies dans votre `docs.json` et présélectionne les langues cibles déjà configurées. + +Pour désactiver les traductions pour une langue, supprimez tous les fichiers du répertoire de cette langue. Vous ne pouvez pas désactiver les traductions pour une langue qui contient encore du contenu publié. + + + +Trouve et corrige les liens internes et externes rompus chaque fois que des changements de contenu sont poussés vers votre dépôt de projet. Utile à exécuter après des réorganisations majeures de contenu ou lorsque les services externes auxquels vous faites référence changent leurs URLs. + +
+ ### Auditer les métadonnées SEO +
+ +Audite et met à jour les titres, méta-descriptions, en-têtes et balises canoniques chaque fois que le contenu change. Ajoutez des instructions pour aligner les suggestions de l'agent avec votre stratégie SEO ou vos mots-clés cibles. + +
+ ### Corriger la grammaire et les fautes de frappe +
+ +Trouve et corrige les fautes de frappe, les fautes d'orthographe et les erreurs grammaticales chaque fois que le contenu change. Ajoutez des instructions pour spécifier des exceptions concernant les termes techniques, les noms de produits ou les choix stylistiques intentionnels que l'agent ne doit pas modifier. + +
+ ### Appliquer la charte de style +
+ +Applique les règles de voix, de ton et d'écriture au contenu chaque fois qu'il change. Ajoutez des instructions pour définir les règles spécifiques que vous souhaitez faire respecter ou liez votre charte de style. Plus vos instructions sont précises, plus les résultats sont cohérents.