diff --git a/agent/index.mdx b/agent/index.mdx index 58e005626..272d97eb1 100644 --- a/agent/index.mdx +++ b/agent/index.mdx @@ -10,25 +10,25 @@ import SkillMcpPrompt from "/snippets/skill-mcp-prompt.mdx"; The agent is available on [Pro and Enterprise plans](https://mintlify.com/pricing?ref=agent). -The agent is an AI tool that creates pull requests with proposed changes to your documentation based on your prompts. When you send a request, the agent: +The agent is an AI tool that creates pull requests (or merge requests, for GitLab) with proposed changes to your documentation based on your prompts. When you send a request, the agent: - **Researches**: Searches and reads your existing documentation, any connected repositories, relevant context, and the web. - **Plans**: Creates a structured task list for complex documentation work. - **Writes**: Generates or updates content following writing standards and best practices. - **Validates**: Runs Mintlify CLI checks to ensure documentation builds correctly. -- **Creates a PR**: Opens a pull request with proposed changes for review. +- **Creates a PR**: Opens a pull request or merge request with proposed changes for review. -All changes go through pull requests. The agent never commits directly to your main branch. +All changes go through pull requests or merge requests. The agent never commits directly to your deploy branch. ## What you can do with the agent Use the agent to: -- Write new content based on your prompts, pull requests, Slack threads, or file attachments. +- Write new content based on your prompts, pull requests, merge requests, Slack threads, or file attachments. - Update existing documentation for new features or API changes. - Process and include images, diagrams, and other files from Slack attachments. - Search and revise code examples and API references across your docs. -- Reference source code from any repository that has the Mintlify GitHub App installed. +- Reference source code from any GitHub repository that has the Mintlify GitHub App installed. - Automate documentation maintenance with workflows. - Answer questions about your docs and technical writing topics. - Address code review feedback to maintain documentation quality. @@ -41,7 +41,12 @@ By default, the agent opens pull requests attributed to the Mintlify bot. To att ## Connect repositories as context -The agent can only access repositories that you connect through the Mintlify GitHub App. Configure which repositories the agent can access in the agent panel **Settings** or in the [GitHub App settings](https://github.com/apps/mintlify/installations/new). +The agent uses your existing deployment connection to read and write to your docs repository: + +- **GitHub**: The agent uses the [Mintlify GitHub App](/deploy/github). Configure which repositories the agent can access in the agent panel **Settings** or in the [GitHub App settings](https://github.com/apps/mintlify/installations/new). +- **GitLab**: The agent uses the [GitLab integration](/deploy/gitlab) that you set up for deployments. The agent opens merge requests against your deploy branch using the project access token you connected. + +Additional source repositories that the agent references for context must be GitHub repositories with the Mintlify GitHub App installed. ## Use AI tools alongside the agent diff --git a/agent/slack.mdx b/agent/slack.mdx index 5bf7c569b..988c71cff 100644 --- a/agent/slack.mdx +++ b/agent/slack.mdx @@ -84,7 +84,7 @@ Once connected, you can: - Mention `@mintlify` in a channel to use it publicly and collaboratively. - Attach files and images directly to your messages for the agent to process and include in your docs. - Continue conversations in threads to iterate on changes or ask follow-up questions. The agent reuses files and images shared earlier in the thread as context for follow-up requests, so you don't have to reupload them. -- Share pull request links with the agent to update related documentation. +- Share pull request or merge request links with the agent to update related documentation. ## Ask questions about your docs @@ -106,11 +106,20 @@ Use the agent to update your documentation with a new request or in an existing - **Existing thread**: Reply in the thread and mention `@mintlify` with instructions on what to update. - **With attachments**: Upload images, diagrams, code files, or other documents with your message. The agent automatically processes and includes them in your documentation. In a thread, the agent has access to images and files shared in earlier messages, so you can reference them in follow-up requests without reuploading. -The agent reads the context of the request or thread and creates a pull request in your connected repository with the updates. +The agent reads the context of the request or thread and creates a pull request (or a merge request, for GitLab-connected deployments) in your connected repository with the updates. + +### GitHub and GitLab support + +The Slack agent works with both GitHub and GitLab deployments: + +- **GitHub-connected deployments**: The agent opens pull requests through the [Mintlify GitHub App](/deploy/github). The completion message links to the pull request on GitHub. +- **GitLab-connected deployments**: The agent opens merge requests through your [GitLab integration](/deploy/gitlab), using the project access token you configured for the deployment. The completion message links to the merge request on GitLab (or your self-hosted GitLab instance). + +No additional setup is required—the agent automatically detects which Git provider your deployment uses and creates the appropriate change request. ## Reference other repositories -The agent can read source code from any repository that has the Mintlify GitHub App installed, even if it isn't your documentation repository. This lets the agent build deeper context to guide documentation updates. +The agent can read source code from any GitHub repository that has the Mintlify GitHub App installed, even if it isn't your documentation repository. This lets the agent build deeper context to guide documentation updates. When you mention another repository in your request, the agent clones it on demand and inspects the relevant files before drafting changes. @@ -120,7 +129,7 @@ Example prompts: - "Document the new endpoints added in `acme/backend#1234`." - "What repositories do you have access to?" -The agent treats cloned repositories as read-only. It uses them for context, but always opens pull requests against your documentation repository. +The agent treats cloned repositories as read-only. It uses them for context, but always opens pull requests or merge requests against your documentation repository. ## Track progress in real time @@ -131,13 +140,13 @@ When the agent is making changes to your documentation, it provides live feedbac - **Questions**: If the agent needs more information, it presents options for you to select from or reply in the thread with a custom answer. - **Permission requests**: Before the agent runs a third-party action that writes data, such as sending an email or creating a ticket, it asks you to approve or deny the action. The permission request is only visible to the person who triggered the request. Click **Approve** to let the agent proceed or **Deny** to cancel the action. - **Interruptions**: If you send a follow-up message while the agent is still working, it stops the current task and starts on the new one. -- **Completion**: When the agent finishes, it posts a summary with a link to the pull request and a link to open the changes in the web editor. +- **Completion**: When the agent finishes, it posts a summary with a link to the pull request or merge request and a link to open the changes in the web editor. ## Roles and permissions The agent's capabilities in Slack match users' [roles](/dashboard/roles). -- **Admins and editors**: Can ask questions and make documentation changes. The agent has access to file editing and pull request tools. +- **Admins and editors**: Can ask questions and make documentation changes. The agent has access to file editing and pull request or merge request tools. - **Viewers**: Can ask questions only. The agent runs in read-only mode for Mintlify tools and third-party integrations. To change a teammate's permissions, update their role on the [Members](https://dashboard.mintlify.com/settings/organization/members) page of your dashboard. @@ -146,4 +155,4 @@ To change a teammate's permissions, update their role on the [Members](https://d - **Be specific**: Tell the agent exactly what you want to know or what you want changed and where. - **Add context**: If a thread doesn't contain all the necessary information, include additional details in your message to the agent. -- **Review carefully**: You should always review pull requests that the agent creates before merging them. +- **Review carefully**: You should always review pull requests or merge requests that the agent creates before merging them. diff --git a/es/agent/index.mdx b/es/agent/index.mdx index e2d7e928d..0138afae5 100644 --- a/es/agent/index.mdx +++ b/es/agent/index.mdx @@ -8,15 +8,15 @@ keywords: ["automation", "automate", "AI", "autoupdate", "maintenance"] El agente está disponible en los [planes Pro y Enterprise](https://mintlify.com/pricing?ref=agent). -El agente es una herramienta de IA que crea solicitudes de extracción (pull requests) con cambios propuestos para tu documentación a partir de tus indicaciones. Cuando envías una solicitud, el agente: +El agente es una herramienta de IA que crea pull requests (o merge requests, en GitLab) con cambios propuestos para tu documentación a partir de tus indicaciones. Cuando envías una solicitud, el agente: * **Investiga**: Busca y lee tu documentación existente, los repositorios conectados, el contexto relevante y la web. * **Planifica**: Crea una lista de tareas estructurada para trabajos de documentación complejos. * **Escribe**: Genera o actualiza contenido siguiendo los estándares y las mejores prácticas de redacción. * **Valida**: Ejecuta comprobaciones con Mintlify CLI para asegurarse de que la documentación se compile correctamente. -* **Crea una PR**: Abre una solicitud de extracción con cambios propuestos para revisión. +* **Crea una PR**: Abre un pull request o merge request con los cambios propuestos para su revisión. -Todos los cambios pasan por solicitudes de extracción (pull requests). El agente nunca realiza confirmaciones directamente en tu branch principal. +Todos los cambios pasan por pull requests o merge requests. El agente nunca realiza confirmaciones directamente en tu branch de despliegue.
## Qué puedes hacer con el agente @@ -24,11 +24,11 @@ Todos los cambios pasan por solicitudes de extracción (pull requests). El agent Usa el agente para: -* Escribir contenido nuevo basado en tus prompts, solicitudes de extracción, hilos de Slack o archivos adjuntos. +* Escribir contenido nuevo basado en tus prompts, pull requests, merge requests, hilos de Slack o archivos adjuntos. * Actualizar documentación existente con nuevas funcionalidades o cambios en la API. * Procesar e incluir imágenes, diagramas y otros archivos a partir de archivos adjuntos de Slack. * Buscar y revisar ejemplos de código y referencias de API en toda tu documentación. -* Hacer referencia al código fuente de cualquier repositorio que tenga instalada la aplicación de GitHub de Mintlify. +* Hacer referencia al código fuente de cualquier repositorio de GitHub que tenga instalada la aplicación de GitHub de Mintlify. * Automatizar el mantenimiento de la documentación mediante flujos de trabajo. * Responder preguntas sobre tu documentación y temas de redacción técnica. * Atender comentarios de revisión de código para mantener la calidad de la documentación. @@ -45,7 +45,12 @@ De forma predeterminada, el agente abre solicitudes de extracción a nombre del ## Conecta repositorios como contexto
-El agente solo puede acceder a los repositorios que conectes mediante la Aplicación de GitHub de Mintlify. Configura a qué repositorios puede acceder el agente en la sección **Settings** del panel del agente o en la [configuración de la Aplicación de GitHub](https://github.com/apps/mintlify/installations/new). +El agente usa tu conexión de despliegue existente para leer y escribir en tu repositorio de documentación: + +* **GitHub**: El agente utiliza la [Aplicación de GitHub de Mintlify](/es/deploy/github). Configura a qué repositorios puede acceder el agente en la sección **Settings** del panel del agente o en la [configuración de la Aplicación de GitHub](https://github.com/apps/mintlify/installations/new). +* **GitLab**: El agente utiliza la [integración de GitLab](/es/deploy/gitlab) que configuraste para los despliegues. El agente abre merge requests contra tu branch de despliegue usando el token de acceso del proyecto que conectaste. + +Los repositorios fuente adicionales a los que el agente hace referencia como contexto deben ser repositorios de GitHub con la Aplicación de GitHub de Mintlify instalada.
## Usa herramientas de IA junto con el agente diff --git a/es/agent/slack.mdx b/es/agent/slack.mdx index 80b6f9803..808d35be9 100644 --- a/es/agent/slack.mdx +++ b/es/agent/slack.mdx @@ -70,7 +70,7 @@ Una vez conectado, puedes: - Mencionar `@mintlify` en un canal para usarlo de forma pública y colaborativa. - Adjuntar archivos e imágenes directamente a tus mensajes para que el agente los procese y los incluya en tu documentación. - Continuar las conversaciones en hilos para iterar sobre los cambios. -- Compartir enlaces a solicitudes de extracción con el agente para actualizar la documentación relacionada. +- Compartir enlaces a pull requests o merge requests con el agente para actualizar la documentación relacionada.
## Actualizar la documentación @@ -82,13 +82,24 @@ Utiliza el agente para actualizar tu documentación mediante una nueva solicitud - **Hilo existente**: Responde en el hilo y menciona `@mintlify` con instrucciones sobre qué actualizar. - **Con archivos adjuntos**: Sube imágenes, diagramas, archivos de código u otros documentos junto con tu mensaje. El agente los procesa automáticamente y los incluye en tu documentación. -El agente lee el contexto de la solicitud o del hilo y crea una solicitud de extracción en tu repositorio conectado con las actualizaciones. +El agente lee el contexto de la solicitud o del hilo y crea un pull request (o un merge request, para los despliegues conectados a GitLab) en tu repositorio conectado con las actualizaciones. + +
+ ### Compatibilidad con GitHub y GitLab +
+ +El agente de Slack funciona tanto con despliegues de GitHub como de GitLab: + +- **Despliegues conectados a GitHub**: El agente abre pull requests a través de la [Aplicación de GitHub de Mintlify](/es/deploy/github). El mensaje de finalización enlaza con el pull request en GitHub. +- **Despliegues conectados a GitLab**: El agente abre merge requests a través de tu [integración con GitLab](/es/deploy/gitlab), utilizando el token de acceso del proyecto que configuraste para el despliegue. El mensaje de finalización enlaza con el merge request en GitLab (o en tu instancia autoalojada de GitLab). + +No se requiere configuración adicional: el agente detecta automáticamente qué proveedor de Git utiliza tu despliegue y crea el tipo de solicitud de cambio correspondiente.
## Hacer referencia a otros repositorios
-El agente puede leer el código fuente de cualquier repositorio que tenga instalada la aplicación de GitHub de Mintlify, incluso si no es tu repositorio de documentación. Esto le permite construir un contexto más profundo para guiar las actualizaciones de la documentación. +El agente puede leer el código fuente de cualquier repositorio de GitHub que tenga instalada la aplicación de GitHub de Mintlify, incluso si no es tu repositorio de documentación. Esto le permite construir un contexto más profundo para guiar las actualizaciones de la documentación. Cuando mencionas otro repositorio en tu solicitud, el agente lo clona bajo demanda e inspecciona los archivos relevantes antes de redactar los cambios. @@ -98,7 +109,7 @@ Ejemplos de prompts: - "Documenta los nuevos endpoints añadidos en `acme/backend#1234`." - "¿A qué repositorios tienes acceso?" -Los repositorios clonados son de solo lectura. El agente los utiliza como contexto, pero siempre abre solicitudes de extracción contra tu repositorio de documentación. +Los repositorios clonados son de solo lectura. El agente los utiliza como contexto, pero siempre abre pull requests o merge requests contra tu repositorio de documentación.
## Sigue el progreso en tiempo real @@ -111,7 +122,7 @@ Mientras el agente trabaja en tu solicitud, proporciona retroalimentación en vi - **Preguntas**: Si el agente necesita más información, presenta opciones para que selecciones o respondas en el hilo con una respuesta personalizada. - **Solicitudes de permiso**: Antes de que el agente ejecute una acción de terceros que escribe datos, como enviar un correo o crear un ticket, te pide que apruebes o rechaces la acción. La tarjeta de aprobación se envía como un mensaje efímero visible solo para ti, la persona que activó la solicitud, para no interrumpir a otros participantes del hilo. Haz clic en **Approve** para que el agente continúe o en **Deny** para cancelar la acción. - **Interrupciones**: Si envías un mensaje de seguimiento mientras el agente aún está trabajando, detiene la tarea actual y comienza con la nueva. -- **Finalización**: Cuando el agente termina, publica un resumen con un enlace a la solicitud de extracción y un enlace para abrir los cambios en el editor web. +- **Finalización**: Cuando el agente termina, publica un resumen con un enlace al pull request o merge request y un enlace para abrir los cambios en el editor web.
## Roles y permisos @@ -119,7 +130,7 @@ Mientras el agente trabaja en tu solicitud, proporciona retroalimentación en vi Las capacidades del agente en Slack coinciden con el [rol](/es/dashboard/roles) de la cuenta de Mintlify vinculada: -- **Administradores y editores**: Pueden hacer preguntas y aplicar cambios en la documentación. El agente tiene acceso a las herramientas de edición de archivos y de pull requests. +- **Administradores y editores**: Pueden hacer preguntas y aplicar cambios en la documentación. El agente tiene acceso a las herramientas de edición de archivos y de pull requests o merge requests. - **Lectores**: Solo pueden hacer preguntas. El agente se ejecuta en modo de solo lectura, por lo que las herramientas de edición de archivos, de commit y de pull request no están disponibles. Las integraciones de terceros se filtran a acciones de solo lectura. Si un lector le pide al agente que haga un cambio, el agente explica la limitación y sugiere contactar a un compañero editor o administrador. Para cambiar los permisos de un compañero, actualiza su rol desde la página [Members](https://dashboard.mintlify.com/settings/organization/members) de tu dashboard. @@ -130,4 +141,4 @@ Para cambiar los permisos de un compañero, actualiza su rol desde la página [M - **Sé específico**: Indícale al agente exactamente qué quieres documentar y dónde debe ir. - **Añade contexto**: Si un hilo no contiene toda la información necesaria, incluye detalles adicionales en tu mensaje al agente. -- **Revisa cuidadosamente**: Siempre debes revisar las solicitudes de extracción que genere el agente antes de fusionarlas. \ No newline at end of file +- **Revisa cuidadosamente**: Siempre debes revisar los pull requests o merge requests que genere el agente antes de fusionarlos. \ No newline at end of file diff --git a/fr/agent/index.mdx b/fr/agent/index.mdx index 1a3c0f660..9de560b8d 100644 --- a/fr/agent/index.mdx +++ b/fr/agent/index.mdx @@ -8,15 +8,15 @@ keywords: ["automation", "automate", "AI", "autoupdate", "maintenance"] L'agent est disponible sur les [plans Pro et Enterprise](https://mintlify.com/pricing?ref=agent). -L'agent est un outil d'IA qui crée des pull requests (demandes de fusion) avec des modifications proposées pour votre documentation, en fonction de vos instructions. Lorsque vous envoyez une requête, l'agent : +L'agent est un outil d'IA qui crée des pull requests (ou des merge requests, pour GitLab) avec des modifications proposées pour votre documentation, en fonction de vos instructions. Lorsque vous envoyez une requête, l'agent : * **Recherche** : recherche et analyse votre documentation existante, les dépôts connectés, le contexte pertinent et le web. -* **Planifie** : crée une liste de tâches structurée pour les travaux de documentation complexes. -* **Rédige** : génère ou met à jour du contenu en suivant les standards de rédaction et les bonnes pratiques. +* **Planifie** : crée une liste de tâches structurée pour les travaux de documentation complexes. +* **Rédige** : génère ou met à jour du contenu en suivant les standards de rédaction et les bonnes pratiques. * **Valide** : exécute les vérifications de l'Interface en ligne de commande (CLI) Mintlify pour s'assurer que la documentation se génère correctement. -* **Crée une PR** : ouvre une pull request (demande de fusion) avec les modifications proposées pour relecture. +* **Crée une PR** : ouvre une pull request ou une merge request avec les modifications proposées pour relecture. -Tous les changements passent par des pull requests (demandes de fusion). L'agent ne fait jamais de commit directement sur votre branche principale. +Tous les changements passent par des pull requests ou des merge requests. L'agent ne fait jamais de commit directement sur votre branche de déploiement.
## Ce que vous pouvez faire avec l’agent @@ -24,11 +24,11 @@ Tous les changements passent par des pull requests (demandes de fusion). L'agent Utilisez l’agent pour : -* Rédiger de nouveaux contenus à partir de vos prompts, pull requests (demandes de fusion), fils Slack ou pièces jointes. +* Rédiger de nouveaux contenus à partir de vos prompts, pull requests, merge requests, fils Slack ou pièces jointes. * Mettre à jour la documentation existante pour de nouvelles fonctionnalités ou des évolutions d’API. * Traiter et intégrer des images, des schémas et d’autres fichiers à partir des pièces jointes Slack. * Rechercher et réviser des exemples de code et des références d’API dans l’ensemble de votre documentation. -* Référencer le code source de n’importe quel dépôt sur lequel la GitHub App Mintlify est installée. +* Référencer le code source de n’importe quel dépôt GitHub sur lequel la GitHub App Mintlify est installée. * Automatiser la maintenance de la documentation avec des workflows. * Répondre aux questions sur votre documentation et sur des sujets de rédaction technique. * Traiter les retours de revue de code pour maintenir la qualité de la documentation. @@ -45,7 +45,12 @@ Par défaut, l'agent ouvre des pull requests (demandes de fusion) attribuées au ## Connecter des dépôts en tant que contexte
-L’agent ne peut accéder qu’aux dépôts que vous connectez via la GitHub App de Mintlify. Configurez les dépôts auxquels l’agent peut accéder dans le panneau **Settings** de l’agent ou dans les [paramètres de la GitHub App](https://github.com/apps/mintlify/installations/new). +L'agent utilise votre connexion de déploiement existante pour lire et écrire dans votre dépôt de documentation : + +* **GitHub** : l'agent utilise la [GitHub App Mintlify](/fr/deploy/github). Configurez les dépôts auxquels l'agent peut accéder dans le panneau **Settings** de l'agent ou dans les [paramètres de la GitHub App](https://github.com/apps/mintlify/installations/new). +* **GitLab** : l'agent utilise l'[intégration GitLab](/fr/deploy/gitlab) que vous avez configurée pour les déploiements. L'agent ouvre des merge requests sur votre branche de déploiement en utilisant le jeton d'accès au projet que vous avez connecté. + +Les dépôts sources supplémentaires auxquels l'agent fait référence comme contexte doivent être des dépôts GitHub sur lesquels la GitHub App Mintlify est installée.
## Utiliser des outils d'IA en complément de l'agent diff --git a/fr/agent/slack.mdx b/fr/agent/slack.mdx index 7119fbbb4..3f345b410 100644 --- a/fr/agent/slack.mdx +++ b/fr/agent/slack.mdx @@ -71,7 +71,7 @@ Une fois connecté, vous pouvez : - Mentionner `@mintlify` dans un canal pour l'utiliser publiquement et de manière collaborative. - Joindre des fichiers et des images directement à vos messages pour que l'agent les analyse et les intègre à votre documentation. - Poursuivre les conversations dans des fils pour affiner les modifications. -- Partager des liens de pull request (demandes de fusion) avec l'agent pour mettre à jour la documentation associée. +- Partager des liens de pull request ou de merge request avec l'agent pour mettre à jour la documentation associée.
## Mettre à jour la documentation @@ -83,13 +83,24 @@ Utilisez l'agent pour mettre à jour votre documentation au moyen d'une nouvelle - **Fil existant** : Répondez dans le fil et mentionnez `@mintlify` avec des instructions sur ce qu'il faut mettre à jour. - **Avec des pièces jointes** : Téléversez des images, des diagrammes, des fichiers de code ou d'autres documents avec votre message. L'agent les traite automatiquement et les inclut dans votre documentation. -L'agent lit le contexte de la demande ou du fil et crée une pull request (demande de fusion) dans votre référentiel connecté avec les mises à jour. +L'agent lit le contexte de la demande ou du fil et crée une pull request (ou une merge request, pour les déploiements connectés à GitLab) dans votre référentiel connecté avec les mises à jour. + +
+ ### Prise en charge de GitHub et GitLab +
+ +L'agent Slack fonctionne avec les déploiements GitHub comme avec ceux GitLab : + +- **Déploiements connectés à GitHub** : l'agent ouvre des pull requests via la [GitHub App Mintlify](/fr/deploy/github). Le message de fin renvoie vers la pull request sur GitHub. +- **Déploiements connectés à GitLab** : l'agent ouvre des merge requests via votre [intégration GitLab](/fr/deploy/gitlab), en utilisant le jeton d'accès au projet que vous avez configuré pour le déploiement. Le message de fin renvoie vers la merge request sur GitLab (ou sur votre instance GitLab autohébergée). + +Aucune configuration supplémentaire n'est requise : l'agent détecte automatiquement le fournisseur Git utilisé par votre déploiement et crée la demande de modification correspondante.
## Référencer d'autres dépôts
-L'agent peut lire le code source de n'importe quel dépôt sur lequel la GitHub App Mintlify est installée, même s'il ne s'agit pas de votre dépôt de documentation. Cela lui permet de construire un contexte plus approfondi pour guider les mises à jour de la documentation. +L'agent peut lire le code source de n'importe quel dépôt GitHub sur lequel la GitHub App Mintlify est installée, même s'il ne s'agit pas de votre dépôt de documentation. Cela lui permet de construire un contexte plus approfondi pour guider les mises à jour de la documentation. Lorsque vous mentionnez un autre dépôt dans votre demande, l'agent le clone à la demande et examine les fichiers pertinents avant de rédiger les modifications. @@ -99,7 +110,7 @@ Exemples de prompts : - « Documentez les nouveaux endpoints ajoutés dans `acme/backend#1234`. » - « À quels dépôts avez-vous accès ? » -Les dépôts clonés sont en lecture seule. L'agent les utilise comme contexte, mais ouvre toujours des pull requests (demandes de fusion) sur votre dépôt de documentation. +Les dépôts clonés sont en lecture seule. L'agent les utilise comme contexte, mais ouvre toujours des pull requests ou des merge requests sur votre dépôt de documentation.
## Suivez la progression en temps réel @@ -112,7 +123,7 @@ Pendant que l'agent travaille sur votre demande, il fournit un retour en direct - **Questions** : Si l'agent a besoin de plus d'informations, il présente des options parmi lesquelles vous pouvez choisir ou vous pouvez répondre dans le fil avec une réponse personnalisée. - **Demandes d'autorisation** : Avant que l'agent n'exécute une action tierce qui écrit des données, comme envoyer un e-mail ou créer un ticket, il vous demande d'approuver ou de refuser l'action. La carte d'approbation est envoyée sous forme de message éphémère visible uniquement par vous, la personne qui a déclenché la demande, afin de ne pas interrompre les autres participants du fil. Cliquez sur **Approve** pour laisser l'agent continuer ou sur **Deny** pour annuler l'action. - **Interruptions** : Si vous envoyez un message de suivi pendant que l'agent travaille encore, il arrête la tâche en cours et commence la nouvelle. -- **Achèvement** : Lorsque l'agent a terminé, il publie un résumé avec un lien vers la pull request (demande de fusion) et un lien pour ouvrir les modifications dans l'éditeur web. +- **Achèvement** : Lorsque l'agent a terminé, il publie un résumé avec un lien vers la pull request ou la merge request et un lien pour ouvrir les modifications dans l'éditeur web.
## Rôles et autorisations @@ -120,7 +131,7 @@ Pendant que l'agent travaille sur votre demande, il fournit un retour en direct Les capacités de l'agent dans Slack correspondent au [rôle](/fr/dashboard/roles) du compte Mintlify associé : -- **Administrateurs et éditeurs** : Peuvent poser des questions et apporter des modifications à la documentation. L'agent a accès aux outils d'édition de fichiers et de pull requests. +- **Administrateurs et éditeurs** : Peuvent poser des questions et apporter des modifications à la documentation. L'agent a accès aux outils d'édition de fichiers et de pull requests ou de merge requests. - **Lecteurs** : Peuvent uniquement poser des questions. L'agent fonctionne en mode lecture seule, donc les outils d'édition de fichiers, de commit et de pull request ne sont pas disponibles. Les intégrations tierces sont filtrées sur les actions en lecture seule. Si un lecteur demande à l'agent d'apporter une modification, celui-ci explique la limitation et suggère de demander à un coéquipier éditeur ou administrateur. Pour modifier les autorisations d'un coéquipier, mettez à jour son rôle depuis la page [Members](https://dashboard.mintlify.com/settings/organization/members) de votre Dashboard. @@ -131,4 +142,4 @@ Pour modifier les autorisations d'un coéquipier, mettez à jour son rôle depui - **Soyez précis** : Indiquez exactement à l’agent ce que vous souhaitez documenter et où cela doit être ajouté. - **Ajoutez du contexte** : Si un fil de discussion ne contient pas toutes les informations nécessaires, ajoutez des détails supplémentaires dans votre message à l’agent. -- **Relisez attentivement** : Vous devez toujours relire les pull requests (demandes de fusion) créées par l’agent avant de les fusionner. \ No newline at end of file +- **Relisez attentivement** : Vous devez toujours relire les pull requests ou les merge requests créées par l’agent avant de les fusionner. \ No newline at end of file