diff --git a/assistant/index.mdx b/assistant/index.mdx index 3c867c720..1d793e514 100644 --- a/assistant/index.mdx +++ b/assistant/index.mdx @@ -40,6 +40,10 @@ Use assistant insights to understand how users interact with your documentation The [assistant page](https://dashboard.mintlify.com/products/assistant) shows usage trends for the month to date. View more detailed insights on the [analytics](/optimize/analytics#assistant) page. + + Enable the [Improve docs from assistant chats](/workflows/enable#improve-docs-from-assistant-chats) workflow to have the agent review question trends on a schedule and open targeted documentation updates. + + ## Make content AI ingestible Structure your documentation to help the assistant provide accurate, relevant answers. Clear organization and comprehensive context benefit both human readers and AI understanding. diff --git a/es/agent/workflows.mdx b/es/agent/workflows.mdx index bb3818d3e..78d8102db 100644 --- a/es/agent/workflows.mdx +++ b/es/agent/workflows.mdx @@ -125,6 +125,35 @@ Al crear o editar un flujo de trabajo en el dashboard, habilita las notificacion 3. Busca y selecciona los canales a los que deseas notificar. 4. Guarda tu flujo de trabajo. +
+## Mejorar la documentación a partir de los chats del assistant +
+ +El flujo de trabajo **Improve docs from assistant chats** revisa las conversaciones recientes del [assistant](/es/assistant/index) según una programación periódica, identifica tendencias en las preguntas de los usuarios y abre solicitudes de extracción específicas para cubrir vacíos o aclarar el contenido sobre el que los usuarios preguntan con frecuencia. + +Usa este flujo de trabajo para: + +- Detectar vacíos en la documentación a partir de preguntas reales de los usuarios en lugar de adivinar qué mejorar. +- Mantener claros y fáciles de encontrar los temas más consultados a medida que tu producto evoluciona. +- Reducir las preguntas repetidas abordando la causa de la confusión en tu documentación. + +
+### Configurar el flujo de trabajo +
+ +Este flujo de trabajo se ejecuta según una programación y no utiliza repositorios de disparador ni de contexto. El agente lee de tu documentación publicada y del historial reciente de chats del assistant. + +1. Abre la página [Workflows](https://dashboard.mintlify.com/products/workflows?tab=workflows) en tu dashboard. +2. Haz clic en el interruptor junto a **Improve docs from assistant chats**. +3. En el modal de configuración, define una programación acorde con la frecuencia con la que quieres que el agente revise los chats. Una cadencia semanal funciona bien para la mayoría de los proyectos. +4. Opcionalmente, agrega instrucciones para enfocar al agente en un área de producto, audiencia o estilo específicos. +5. Elige si el flujo de trabajo abre una solicitud de extracción para revisión o actualiza el contenido automáticamente. Se recomienda mantener la revisión. +6. Haz clic en **Turn on workflow**. + + + La calidad de las actualizaciones sugeridas depende del volumen de tráfico del assistant. Habilita este flujo de trabajo después de que el assistant haya estado activo el tiempo suficiente para recopilar una muestra representativa de preguntas. + +
## Gestionar flujos de trabajo
diff --git a/es/assistant/index.mdx b/es/assistant/index.mdx index c4719a4b7..dd7f86827 100644 --- a/es/assistant/index.mdx +++ b/es/assistant/index.mdx @@ -48,6 +48,10 @@ Usa la información del assistant para entender cómo los usuarios interactúan La [página del assistant](https://dashboard.mintlify.com/products/assistant) muestra las tendencias de uso del mes actual. Consulta información más detallada en la página de [analíticas](/es/optimize/analytics#assistant). + + Habilita el flujo de trabajo [Mejorar la documentación a partir de los chats del assistant](/es/agent/workflows#improve-docs-from-assistant-chats) para que el agente revise las tendencias de preguntas según una programación y abra actualizaciones específicas en la documentación. + +
## Haz que el contenido sea procesable por IA
diff --git a/fr/agent/workflows.mdx b/fr/agent/workflows.mdx index 930699c58..b0f8a8a1f 100644 --- a/fr/agent/workflows.mdx +++ b/fr/agent/workflows.mdx @@ -125,6 +125,35 @@ Lors de la création ou de la modification d'un workflow dans le dashboard, acti 3. Recherchez et sélectionnez les canaux que vous souhaitez notifier. 4. Enregistrez votre workflow. +
+## Améliorer la documentation à partir des chats de l'assistant +
+ +Le workflow **Improve docs from assistant chats** examine les conversations récentes de l'[assistant](/fr/assistant/index) selon une planification récurrente, identifie les tendances dans les questions des utilisateurs et ouvre des pull requests ciblées pour combler les lacunes ou clarifier le contenu sur lequel les utilisateurs posent fréquemment des questions. + +Utilisez ce workflow pour : + +- Faire ressortir les lacunes de la documentation à partir des questions réelles des utilisateurs au lieu de deviner ce qu'il faut améliorer. +- Garder clairs et faciles à trouver les sujets les plus consultés à mesure que votre produit évolue. +- Réduire les questions répétitives en traitant la source de la confusion dans votre documentation. + +
+### Configurer le workflow +
+ +Ce workflow s'exécute selon une planification et n'utilise pas de référentiels de déclencheur ni de contexte. L'agent lit votre documentation publiée ainsi que l'historique récent des chats de l'assistant. + +1. Ouvrez la page [Workflows](https://dashboard.mintlify.com/products/workflows?tab=workflows) dans votre dashboard. +2. Cliquez sur le commutateur à côté de **Improve docs from assistant chats**. +3. Dans la fenêtre des paramètres, définissez une planification correspondant à la fréquence à laquelle vous souhaitez que l'agent examine les chats. Une cadence hebdomadaire convient à la plupart des projets. +4. Ajoutez éventuellement des instructions pour orienter l'agent vers un domaine produit, un public ou un style spécifiques. +5. Choisissez si le workflow ouvre une pull request pour révision ou met à jour le contenu automatiquement. La révision est recommandée. +6. Cliquez sur **Turn on workflow**. + + + La qualité des mises à jour suggérées dépend du volume de trafic de l'assistant. Activez ce workflow lorsque l'assistant a été en service suffisamment longtemps pour recueillir un échantillon représentatif de questions. + +
## Gérer les workflows
diff --git a/fr/assistant/index.mdx b/fr/assistant/index.mdx index ec045daa0..f63666e6b 100644 --- a/fr/assistant/index.mdx +++ b/fr/assistant/index.mdx @@ -48,6 +48,10 @@ Utilisez les statistiques de l'assistant pour comprendre comment les utilisateur La [page de l'assistant](https://dashboard.mintlify.com/products/assistant) affiche les tendances d'utilisation du mois en cours. Consultez des statistiques plus détaillées sur la page [analytiques](/fr/optimize/analytics#assistant). + + Activez le workflow [Améliorer la documentation à partir des chats de l'assistant](/fr/agent/workflows#improve-docs-from-assistant-chats) pour que l'agent examine les tendances des questions selon une planification et ouvre des mises à jour ciblées de la documentation. + +
## Rendre le contenu exploitable par l'IA
diff --git a/workflows/enable.mdx b/workflows/enable.mdx index 3fe0eb7f5..7129e1000 100644 --- a/workflows/enable.mdx +++ b/workflows/enable.mdx @@ -74,4 +74,29 @@ You can change the target languages at any time by opening the workflow's settin After saving the workflow, click **Translate now** to run it on demand using the currently saved target languages. The workflow must be enabled to trigger a manual run. Manual runs do not affect the workflow's regular trigger. +## Improve docs from assistant chats + +The **Improve docs from assistant chats** workflow reviews recent [assistant](/assistant/index) conversations on a recurring schedule, identifies trends in user questions, and opens targeted pull requests to fill gaps or clarify content that users frequently ask about. + +Use this workflow to: + +- Surface documentation gaps from real user questions instead of guessing what to improve. +- Keep frequently asked topics clear and discoverable as your product changes. +- Reduce repeat questions by addressing the source of confusion in your docs. + +### Configure the workflow + +This workflow runs on a schedule and does not use trigger or context repositories. The agent reads from your published documentation and recent assistant chat history. + +1. Open the [Workflows](https://dashboard.mintlify.com/products/workflows?tab=workflows) page in your dashboard. +2. Click the toggle beside **Improve docs from assistant chats**. +3. In the settings modal, set a schedule that matches how often you want the agent to review chats. A weekly cadence works well for most projects. +4. Optionally add instructions to focus the agent on a specific product area, audience, or style. +5. Choose whether the workflow opens a pull request for review or updates content automatically. Reviews are recommended. +6. Click **Turn on workflow**. + + + The quality of suggested updates depends on the volume of assistant traffic. Enable this workflow after the assistant has been live long enough to collect a representative sample of questions. + + diff --git a/workflows/index.mdx b/workflows/index.mdx index 12bf7c1d1..72447af24 100644 --- a/workflows/index.mdx +++ b/workflows/index.mdx @@ -11,7 +11,7 @@ Workflows run the agent automatically on a schedule or in response to pushes to When a workflow runs, the agent clones any specified repositories as context and follows the prompt. -Use workflows that run on a schedule to automate recurring tasks, like publishing changelogs or checking for grammar and style issues. +Use workflows that run on a schedule to automate recurring tasks, like publishing changelogs, checking for grammar and style issues, or [improving docs from assistant chat trends](/workflows/enable#improve-docs-from-assistant-chats). Use workflows that run on push events to automate reactive maintenance tasks, like updating API reference documentation or identifying documentation updates needed for new features.