diff --git a/es/agent/index.mdx b/es/agent/index.mdx index 477bfbf18..77a324635 100644 --- a/es/agent/index.mdx +++ b/es/agent/index.mdx @@ -47,14 +47,22 @@ Usa el agente para: * **Slack**: Añade el agente a tu espacio de trabajo de Slack y menciona `@mintlify` en cualquier canal. Puedes adjuntar archivos e imágenes directamente a tus mensajes para que el agente los procese. * **API**: Integra el agente en aplicaciones personalizadas usando los [endpoints del agente](/es/api/agent/create-agent-job). +
+ ## Conecta tu cuenta de GitHub +
+ +De forma predeterminada, el agente abre solicitudes de extracción atribuidas al bot de Mintlify. Para que las solicitudes de extracción se atribuyan a ti, conecta tu cuenta de GitHub en la página [Mi perfil](https://dashboard.mintlify.com/settings/account) del dashboard. + +
+ ## Conecta repositorios como contexto +
+ +El agente solo puede acceder a los repositorios que conectes a través de la Mintlify GitHub App. Configura a qué repositorios puede acceder el agente en **Settings** del panel del agente o en la [configuración de la GitHub App](https://github.com/apps/mintlify/installations/new). +
## Próximos pasos
- - Comienza a usar el agente en tu dashboard. - - Añade el agente a tu espacio de trabajo de Slack. diff --git a/es/agent/quickstart.mdx b/es/agent/quickstart.mdx deleted file mode 100644 index 773946b6b..000000000 --- a/es/agent/quickstart.mdx +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: "Inicio rápido" -description: "Comienza a usar el agente en tu dashboard para crear actualizaciones en la documentación." -keywords: ["configuración del agente"] ---- - -
- ## Abrir el panel del agente -
- -En computadoras de escritorio, puedes ajustar el tamaño del panel del agente. En dispositivos móviles, el agente se abre en pantalla completa. - -Para abrir el panel del agente: - -- Desde cualquier página de tu dashboard, usa la combinación de teclas +I (macOS) o Ctrl+I (Windows/Linux). -- En la página [Overview](https://dashboard.mintlify.com/), haz clic en **Ask agent**. - -
- ### Vistas del panel del agente -
- - - Vistas en el panel del agente: nuevo chat, sugerencias, historial y configuración. - Vistas en el panel del agente: nuevo chat, sugerencias, historial y configuración. - - -- **Chat**: Haz clic en el icono de más, , para iniciar un nuevo chat. En la vista de chat, envía instrucciones al agente para actualizar o hacer preguntas sobre tu documentación. El agente crea solicitudes de extracción según tus instrucciones y muestra enlaces para ver las solicitudes de extracción o abrir los cambios en el editor web. -- **Sugerencias**: Si está habilitado, el panel de sugerencias muestra actualizaciones sugeridas para tu documentación basadas en los cambios de las solicitudes de extracción y en las conversaciones de los usuarios con el assistant. -- **Historial**: Haz clic en el icono de historial, , para explorar conversaciones anteriores y seguir trabajando en solicitudes anteriores. Haz clic en cualquier conversación para cargarla en la vista de chat. -- **Configuración**: Haz clic en el icono de configuración, , para configurar las integraciones y el acceso al repositorio del agente. - - - Inicia una nueva conversación con el agente para cada tarea. Esto mantiene centrado el contexto del agente y te ayuda a asociar conversaciones con proyectos específicos. - - -
- ## Conecta tu cuenta de GitHub -
- -De forma predeterminada, el agente abre solicitudes de extracción atribuidas al bot de Mintlify. Para que las solicitudes de extracción se atribuyan a tu cuenta, conecta tu cuenta de GitHub en la página [My profile](https://dashboard.mintlify.com/settings/account) del dashboard. - -
- ## Conectar repositorios como contexto -
- -El agente solo puede acceder a los repositorios que conectes a través de la Aplicación de GitHub de Mintlify. Configura los repositorios a los que el agente puede acceder 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). \ No newline at end of file diff --git a/es/agent/suggestions.mdx b/es/agent/suggestions.mdx deleted file mode 100644 index 9bf76f82b..000000000 --- a/es/agent/suggestions.mdx +++ /dev/null @@ -1,105 +0,0 @@ ---- -title: "Sugerencias del agente" -description: "Supervisa repositorios de Git para detectar cambios y recibe sugerencias de actualizaciones de la documentación." -keywords: ["automatización", "lagunas de documentación", "autoactualización", "auto-actualización", "automatizar actualizaciones", "piloto automático"] ---- - - - Las sugerencias del agente están disponibles en los [Enterprise plans](https://mintlify.com/pricing?ref=autopilot). Para habilitar las sugerencias para tu organización, [contacta a nuestro equipo de ventas](mailto:gtm@mintlify.com). - - -Puedes permitir que el agente sugiera actualizaciones de la documentación a partir de dos fuentes: - -* **Cambios en solicitudes de extracción (pull requests)**: Supervisa repositorios de Git seleccionados para detectar cambios de código que requieran actualizaciones en la documentación. -* **Conversaciones con el assistant**: Analiza las preguntas que los usuarios hacen al assistant en tu sitio de documentación para identificar lagunas de contenido. - -Cuando el agente identifica posibles actualizaciones de la documentación, crea una sugerencia en tu dashboard con el contexto necesario para crear una solicitud de extracción. - -Usa las sugerencias para mantener tu documentación actualizada de forma proactiva cuando se lancen nuevas funciones o para abordar preguntas frecuentes de los usuarios. - -
- ## Requisitos previos -
- -Antes de usar las sugerencias, debes instalar la [Aplicación de GitHub de Mintlify](/es/deploy/github) en tu organización. La aplicación debe tener acceso a tu repositorio de documentación y al menos a otro repositorio donde los cambios en el código requieran actualizaciones en la documentación. - -
- ## Configurar sugerencias -
- -Configura qué repositorios supervisa el agente y cómo quieres recibir las notificaciones en la configuración del agente. La página de configuración muestra todas las organizaciones y repositorios de GitHub que el agente supervisa. - -Para acceder a la configuración del agente: - -1. Haz clic en el botón **Ask agent** en tu dashboard para abrir el panel del agente. -2. Haz clic en el botón **Settings**. - - El botón de configuración en modo claro. - - El botón de configuración en modo oscuro. - - -
- ### Supervisar repositorios -
- -El agente supervisa todas las solicitudes de extracción fusionadas para cada repositorio que habilites, sin importar en qué branch se fusionen. Se ejecuta una verificación de GitHub llamada **Mintlify Autopilot** en las solicitudes de extracción de los repositorios supervisados para analizarlas en busca de posibles actualizaciones de documentación. Cuando fusionas una solicitud de extracción que requiere actualizaciones de documentación, el agente crea una sugerencia en tu dashboard. - - - Cuando habilitas por primera vez la supervisión de un repositorio, el agente crea sugerencias para las solicitudes de extracción fusionadas en los últimos siete días. Este proceso retroactivo solo ocurre si aún no existen sugerencias para ese repositorio. Es posible que veas aparecer varias sugerencias inmediatamente después de habilitar la supervisión. - - -Si desactivas la supervisión, el agente deja de supervisar el repositorio de inmediato. Cualquier sugerencia existente para ese repositorio permanece en tu dashboard hasta que las descartes. - -
- ### Información sobre las conversaciones -
- -Si tienes acceso al agente y al assistant, el agente genera sugerencias a partir de las conversaciones que tus usuarios tienen con el assistant. - -El agente analiza periódicamente las conversaciones del assistant y crea sugerencias cuando identifica patrones de preguntas que indican que falta documentación o que esta no es clara. - -
- ### Notificaciones -
- -Las sugerencias del agente siempre aparecen en tu dashboard. Puedes configurar las notificaciones para recibir correos electrónicos o mensajes directos de Slack cuando el agente cree nuevas sugerencias. - - - Si no recibes notificaciones por correo electrónico para las sugerencias, revisa tu carpeta de correo no deseado y agrega la dirección de correo `notifications@mintlify.com` a tu lista de remitentes seguros. - - -
- ## Revisión de sugerencias -
- -El agente crea sugerencias en tu dashboard. Cada sugerencia muestra la solicitud de extracción o el tema de conversación del assistant que generó la sugerencia, la fecha de creación y las actualizaciones de documentación propuestas. - -El botón **Ask agent** en tu dashboard muestra el número de sugerencias que están esperando tu revisión. - - - El botón Ask agent que muestra cuatro sugerencias en modo claro. - - El botón Ask agent que muestra cuatro sugerencias en modo oscuro. - - -
- ### Crear solicitudes de extracción -
- -Añade sugerencias como contexto para que el agente cree solicitudes de extracción. - -1. Haz clic en el botón **Ask agent** en tu dashboard para abrir el panel del agente. -2. Haz clic en **Add to chat**. -3. Envía el mensaje al agente para abrir una solicitud de extracción. - -
- ### Descartar sugerencias -
- -Si una sugerencia no requiere actualizaciones en la documentación o ya has aplicado los cambios, descártala para eliminarla de tu dashboard. - -1. Haz clic en el botón **Ask agent** en tu dashboard para abrir el panel del agente. -2. Haz clic en el botón **Dismiss** junto a cualquier sugerencia que desees descartar. - -La sugerencia se elimina inmediatamente de tu dashboard. No puedes recuperar las sugerencias descartadas. \ No newline at end of file diff --git a/es/ai-native.mdx b/es/ai-native.mdx index 2ef10ec6f..a2dcd04a0 100644 --- a/es/ai-native.mdx +++ b/es/ai-native.mdx @@ -23,7 +23,7 @@ Además de leer páginas individuales, los usuarios pueden chatear con el [assis El [agente](/es/agent) te ayuda a redactar y mantener la documentación. Crea solicitudes de extracción con cambios propuestos basados en tus indicaciones, solicitudes de extracción y hilos de Slack. Añade el agente a tu espacio de trabajo de Slack para que cualquiera de tu equipo pueda ayudar a mantener la documentación conversando con él. O integra el agente en aplicaciones personalizadas a través de la [API](/es/api/agent/create-agent-job). -Puedes configurar el agente para que supervise los repositorios conectados y [sugiera](/es/agent/suggestions) de forma proactiva actualizaciones de la documentación cuando detecte cambios visibles para el usuario. +Crea [workflows](/es/agent/workflows) para ejecutar el agente de forma programada o ante un push en un repositorio. Cada workflow define un prompt para el agente y un disparador que determina cuándo ejecutarlo. Configura herramientas populares como [Cursor](/es/guides/cursor), [Claude Code](/es/guides/claude-code) y [Windsurf](/es/guides/windsurf) para que tomen como referencia el esquema de Mintlify, tu guía de estilo y las mejores prácticas. @@ -45,19 +45,13 @@ La búsqueda de texto completo y la comprensión semántica ayudan a los usuario Selecciona cualquiera de las siguientes tarjetas para obtener más información. - + Configura el assistant para buscar en sitios externos o derivar a las personas a tu equipo de soporte si no puede responder sus preguntas. - - - Utiliza el agente en tu dashboard para crear actualizaciones de la documentación. - - - - Supervisa repositorios de Git en busca de cambios y recibe sugerencias de actualizaciones de la documentación. + + Obtén actualizaciones de documentación de forma automática según una programación o cuando ocurra un evento push. - Agrega un menú a las páginas que permita a los usuarios consultar herramientas de IA, conectarse a tu servidor MCP y copiar páginas como contexto con un clic. diff --git a/es/changelog.mdx b/es/changelog.mdx index 2fa49ee6e..2dc85bafb 100644 --- a/es/changelog.mdx +++ b/es/changelog.mdx @@ -228,7 +228,7 @@ noindex: true ## Sugerencias del assistant para todos los usuarios - [Conversation insights](/es/agent/suggestions#conversation-insights) ahora están disponibles para todos los sitios de documentación que tengan tanto el agente como el assistant activados. El agente analiza patrones en las conversaciones con el assistant para identificar carencias en la documentación y sugerir mejoras, ayudándote a abordar de forma proactiva las preguntas más frecuentes de los usuarios. + Conversation insights ahora están disponibles para todos los sitios de documentación que tengan tanto el agente como el assistant activados. El agente analiza patrones en las conversaciones con el assistant para identificar carencias en la documentación y sugerir mejoras, ayudándote a abordar de forma proactiva las preguntas más frecuentes de los usuarios. ## Sincronización de Tabs y grupos de código @@ -254,7 +254,7 @@ noindex: true ## Sugerencias del agente a partir de conversaciones con el assistant - El [agente](/es/agent) ahora puede sugerir actualizaciones de la documentación basándose en [conversaciones con el assistant](/es/agent/suggestions#conversation-insights). Cuando está activado, el agente analiza las preguntas que los usuarios hacen al assistant para identificar patrones que indiquen documentación faltante o poco clara. + El [agente](/es/agent) ahora puede sugerir actualizaciones de la documentación basándose en conversaciones con el assistant. Cuando está activado, el agente analiza las preguntas que los usuarios hacen al assistant para identificar patrones que indiquen documentación faltante o poco clara. Esto añade una segunda fuente de sugerencias del agente junto con la monitorización del repositorio, lo que te ayuda a abordar de forma proactiva las preguntas más frecuentes de los usuarios. @@ -283,7 +283,7 @@ noindex: true ## Mejoras del agente * Se añadió compatibilidad para leer [instrucciones personalizadas](/es/agent/customize) desde un archivo `AGENTS.md`. - * Ahora el agente abre solicitudes de extracción (PR) en tu cuenta de GitHub si [conectas tu cuenta](/es/agent/quickstart#connect-your-github-account) en el dashboard. + * Ahora el agente abre solicitudes de extracción (PR) en tu cuenta de GitHub si conectas tu cuenta en el dashboard. ## Mejoras del assistant diff --git a/es/dashboard/audit-logs.mdx b/es/dashboard/audit-logs.mdx index 3357b2766..78bb0e2a3 100644 --- a/es/dashboard/audit-logs.mdx +++ b/es/dashboard/audit-logs.mdx @@ -55,7 +55,7 @@ Filtra los registros de auditoría para encontrar actividades específicas. | Facturación | Actualizaciones de suscripciones, compras de complementos y visualización de facturas. | | Cuota | Cambios en la política de excedentes y en la configuración de alertas. | | Usuario | Configuración de notificaciones de usuarios individuales. | -| Sugerencias | Configuraciones de sugerencias y gestión de repositorios. | +| Workflows | Configuraciones de workflows y gestión de repositorios. | | Registro de auditoría | Visualización y exportaciones del registro de auditoría. | | Auth | Intentos de inicio de sesión, cierres de sesión y creación de sesiones. | diff --git a/es/guides/knowledge-base.mdx b/es/guides/knowledge-base.mdx index 01a242d9c..290b29708 100644 --- a/es/guides/knowledge-base.mdx +++ b/es/guides/knowledge-base.mdx @@ -11,7 +11,7 @@ Mintlify proporciona la infraestructura para bases de conocimientos a las que to * **Búsqueda con IA**: El [assistant](/es/ai/assistant) responde preguntas utilizando el contenido de tu base de conocimientos, para que las personas encuentren respuestas sin saber exactamente dónde buscar. * **Integraciones con Slack**: Añade el assistant a [Slack](/es/ai/slack-bot) para que tu equipo pueda hacer preguntas y usa el [agent](/es/agent/slack) para capturar conocimiento a partir de las conversaciones. -* **Contribuciones con baja barrera de entrada**: El [web editor](/es/editor) y el [agent](/es/agent/quickstart) permiten que cualquier miembro de tu equipo actualice el contenido sin aprender Git o Markdown. +* **Contribuciones con baja barrera de entrada**: El [web editor](/es/editor) y el [agent](/es/agent/index) permiten que cualquier miembro de tu equipo actualice el contenido sin aprender Git o Markdown. * **Autenticación integrada**: Controla el acceso con [SSO u OAuth](/es/deploy/authentication-setup) y usa [groups](/es/deploy/authentication-setup#control-access-with-groups) para mostrar contenido diferente a distintos equipos.
@@ -227,7 +227,7 @@ Es ideal para expertos en la materia que conocen el contenido pero no se sienten ### Agente
-El [agent](/es/agent/quickstart) en tu dashboard crea actualizaciones de la documentación a partir de instrucciones en lenguaje natural. Describe lo que quieres cambiar y el agente creará una solicitud de extracción con las actualizaciones. +El [agent](/es/agent/index) en tu dashboard crea actualizaciones de la documentación a partir de instrucciones en lenguaje natural. Describe lo que quieres cambiar y el agente creará una solicitud de extracción con las actualizaciones. Por ejemplo, un miembro del equipo podría indicar: "agrega una sección a la página de la política de gastos que explique cómo enviar recibos de comidas de más de $50" y copiar la página de la política de gastos existente en el prompt. El agente redactaría el contenido y abriría una solicitud de extracción para revisión. diff --git a/fr/agent/index.mdx b/fr/agent/index.mdx index 94c0d0e1f..a1362482a 100644 --- a/fr/agent/index.mdx +++ b/fr/agent/index.mdx @@ -1,66 +1,74 @@ --- -title: "Qu'est-ce que l'agent ?" +title: "Qu'est-ce que l'agent ?" description: "Automatisez les mises à jour de la documentation avec l'agent. Créez des mises à jour à partir de messages Slack, de pull requests ou d'appels d'API." keywords: ["automation", "automate", "AI", "autoupdate", "maintenance"] --- - L'agent est disponible sur les [plans Enterprise](https://mintlify.com/pricing?ref=agent) pour toute personne ayant accès à votre Dashboard. + L'agent est disponible sur les [plans Enterprise](https://mintlify.com/pricing?ref=agent) pour toute personne ayant accès à votre Dashboard. -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 (demandes de fusion) avec des modifications proposées pour votre documentation, en fonction de vos instructions. Lorsque vous envoyez une requête, l'agent : -* **Recherche** : analyse votre documentation existante, les dépôts connectés et le contexte pertinent. -* **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. +* **Recherche** : analyse votre documentation existante, les dépôts connectés et le contexte pertinent. +* **Planifie** : crée une liste de tâches structurée pour les travaux de documentation complexes. +* **Rédige** : génère ou met à jour du contenu en suivant les standards de rédaction et les bonnes pratiques. +* **Valide** : exécute les vérifications de l'Interface en ligne de commande (CLI) Mintlify pour s'assurer que la documentation se génère correctement. +* **Crée une PR** : ouvre une pull request (demande de fusion) avec les modifications proposées pour relecture. -Tous les changements passent par des pull requests (demandes de fusion). L'agent ne fait jamais de commit directement sur votre branche principale. +Tous les changements passent par des pull requests (demandes de fusion). L'agent ne fait jamais de commit directement sur votre branche principale.
- ## Ce que vous pouvez faire avec l’agent + ## Ce que vous pouvez faire avec l'agent
-Utilisez l’agent pour : +Utilisez l'agent pour : * Rédiger de nouveaux contenus à partir de vos prompts, pull requests (demandes de fusion), 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. +* 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. * 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. -* Capitaliser les connaissances issues des conversations Slack et des pull requests (demandes de fusion) avant qu’elles ne soient perdues. +* Capitaliser les connaissances issues des conversations Slack et des pull requests (demandes de fusion) avant qu'elles ne soient perdues. * Naviguer et coordonner efficacement les modifications dans plusieurs fichiers et répertoires.
- ## Où vous pouvez utiliser l’agent + ## Où vous pouvez utiliser l'agent
-* **Dashboard** : Depuis n’importe quelle page de votre Dashboard, utilisez le raccourci clavier +I (macOS) ou Ctrl+I (Windows/Linux) pour ouvrir le panneau de l’agent. Vous pouvez aussi cliquer sur **Ask agent** sur la page [Overview](https://dashboard.mintlify.com/). +* **Dashboard** : Depuis n'importe quelle page de votre Dashboard, utilisez le raccourci clavier +I (macOS) ou Ctrl+I (Windows/Linux) pour ouvrir le panneau de l'agent. Vous pouvez aussi cliquer sur **Ask agent** sur la page [Overview](https://dashboard.mintlify.com/). - Le panneau de l’agent ouvert dans le Dashboard. + Le panneau de l'agent ouvert dans le Dashboard. - Le panneau de l’agent ouvert dans le Dashboard. + Le panneau de l'agent ouvert dans le Dashboard. -* **Slack** : Ajoutez l’agent à votre espace de travail Slack et mentionnez `@mintlify` dans n’importe quel canal. Vous pouvez joindre des fichiers et des images directement à vos messages pour que l’agent les traite. -* **API** : Intégrez l’agent dans des applications personnalisées à l’aide des [points de terminaison de l’agent](/fr/api/agent/create-agent-job). +* **Slack** : Ajoutez l'agent à votre espace de travail Slack et mentionnez `@mintlify` dans n'importe quel canal. Vous pouvez joindre des fichiers et des images directement à vos messages pour que l'agent les traite. +* **API** : Intégrez l'agent dans des applications personnalisées à l'aide des [points de terminaison de l'agent](/fr/api/agent/create-agent-job). + +
+ ## Connectez votre compte GitHub +
+ +Par défaut, l'agent ouvre des pull requests (demandes de fusion) attribuées au bot Mintlify. Pour que les pull requests (demandes de fusion) vous soient attribuées, connectez votre compte GitHub sur la page [Mon profil](https://dashboard.mintlify.com/settings/account) du Dashboard. + +
+ ## Connectez des référentiels comme contexte +
+ +L'agent ne peut accéder qu'aux référentiels que vous connectez via la Mintlify GitHub App. Configurez les référentiels auxquels l'agent peut accéder dans les **Settings** du panneau de l'agent ou dans les [paramètres de la GitHub App](https://github.com/apps/mintlify/installations/new).
## Prochaines étapes
- - Commencez à utiliser l'agent dans votre Dashboard. - - - Ajoutez l'agent à votre espace de travail Slack. + Ajoutez l'agent à votre espace de travail Slack. - Configurez l'agent avec un fichier `AGENTS.md`. + Configurez l'agent avec un fichier `AGENTS.md`. @@ -68,5 +76,5 @@ Utilisez l’agent pour : - Automatisez les tâches récurrentes et la maintenance de la documentation à l'aide de workflows. - \ No newline at end of file + Automatisez les tâches récurrentes et la maintenance de la documentation à l'aide de workflows. +
diff --git a/fr/agent/quickstart.mdx b/fr/agent/quickstart.mdx deleted file mode 100644 index b3a7507d6..000000000 --- a/fr/agent/quickstart.mdx +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: "Démarrage rapide" -description: "Commencez à utiliser l'agent dans votre Dashboard pour mettre à jour votre documentation." -keywords: ["prise en main de l'agent"] ---- - -
- ## Ouvrir le panneau de l’agent -
- -Sur ordinateur, le panneau de l’agent peut être redimensionné. Sur mobile, l’agent s’ouvre en plein écran. - -Pour ouvrir le panneau de l’agent : - -- Depuis n’importe quelle page de votre Dashboard, utilisez le raccourci clavier +I (macOS) ou Ctrl+I (Windows/Linux). -- Sur la page [Overview](https://dashboard.mintlify.com/), cliquez sur **Ask agent**. - -
- ### Vues du panneau de l'agent -
- - - Vues dans le panneau de l'agent : nouvelle conversation, suggestions, historique et paramètres. - Vues dans le panneau de l'agent : nouvelle conversation, suggestions, historique et paramètres. - - -- **Chat** : Cliquez sur l’icône plus, , pour démarrer une nouvelle conversation. Dans la vue de chat, envoyez des prompts à l’agent pour mettre à jour votre documentation ou poser des questions à son sujet. L’agent crée des pull requests (demandes de fusion) en fonction de vos instructions et affiche des liens pour consulter les pull requests ou ouvrir les modifications dans l’éditeur web. -- **Suggestions** : Si cette option est activée, le panneau des suggestions affiche des mises à jour proposées pour votre documentation, basées sur les modifications des pull requests et les conversations des utilisateurs avec l’Assistant. -- **Historique** : Cliquez sur l’icône d’historique, , pour parcourir les conversations précédentes et continuer à travailler sur des demandes antérieures. Cliquez sur n’importe quelle conversation pour la charger dans la vue de chat. -- **Paramètres** : Cliquez sur l’icône de paramètres, , pour configurer les intégrations de l’agent et l’accès au référentiel. - - - Démarrez une nouvelle conversation avec l’agent pour chaque tâche. Cela permet de garder le contexte de l’agent ciblé et vous aide à associer les conversations à des projets spécifiques. - - -
- ## Connectez votre compte GitHub -
- -Par défaut, l'agent ouvre des pull requests (demandes de fusion) attribuées au bot Mintlify. Pour que les pull requests vous soient attribuées, connectez votre compte GitHub sur la page [Mon profil](https://dashboard.mintlify.com/settings/account) du Dashboard. - -
- ## 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 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). \ No newline at end of file diff --git a/fr/agent/suggestions.mdx b/fr/agent/suggestions.mdx deleted file mode 100644 index 4d0227ea7..000000000 --- a/fr/agent/suggestions.mdx +++ /dev/null @@ -1,105 +0,0 @@ ---- -title: "Suggestions de l’agent" -description: "Surveillez les dépôts Git pour détecter les changements et recevez des suggestions de mises à jour de la documentation." -keywords: ["automation", "documentation gaps", "self updating", "self-updating", "automate updates", "autopilot"] ---- - - - Les suggestions de l’agent sont disponibles avec les [offres Enterprise](https://mintlify.com/pricing?ref=autopilot). Pour activer les suggestions pour votre organisation, [contactez notre équipe commerciale](mailto:gtm@mintlify.com). - - -Vous pouvez autoriser l’agent à suggérer des mises à jour de la documentation à partir de deux sources. - -* **Modifications des pull requests (demandes de fusion)** : Surveillez des dépôts Git sélectionnés pour détecter les changements de code nécessitant des mises à jour de la documentation. -* **Conversations avec l’Assistant** : Analysez les questions que les utilisateurs posent à l’Assistant sur votre site de documentation afin d’identifier les lacunes dans la documentation. - -Lorsque l’agent identifie des mises à jour potentielles de la documentation, il crée une suggestion dans votre Dashboard avec le contexte nécessaire pour créer une pull request (demande de fusion). - -Utilisez les suggestions pour garder votre documentation à jour de manière proactive lorsque de nouvelles fonctionnalités sont déployées ou pour répondre aux questions fréquentes des utilisateurs. - -
- ## Prérequis -
- -Avant de pouvoir utiliser les suggestions, vous devez installer la [Mintlify GitHub App](/fr/deploy/github) dans votre organisation. L'application doit avoir accès à votre référentiel de documentation et à au moins un autre référentiel où les modifications de code nécessitent des mises à jour de la documentation. - -
- ## Configurer les suggestions -
- -Dans les paramètres de l'agent, configurez les dépôts que l'agent surveille et la manière dont vous recevez les notifications. La page des paramètres affiche toutes les organisations et tous les dépôts GitHub surveillés par l'agent. - -Pour accéder aux paramètres de l'agent : - -1. Cliquez sur le bouton **Ask agent** dans votre dashboard pour ouvrir le panneau de l'agent. -2. Cliquez sur le bouton **Settings**. - - Le bouton des paramètres en mode clair. - - Le bouton des paramètres en mode sombre. - - -
- ### Surveiller les référentiels -
- -L'agent surveille toutes les pull requests (demandes de fusion) fusionnées pour chaque référentiel que vous activez, quelle que soit la branche dans laquelle elles sont fusionnées. Une vérification GitHub nommée **Mintlify Autopilot** s'exécute sur les pull requests dans les référentiels surveillés afin de les analyser et de détecter d'éventuelles mises à jour de la documentation. Lorsque vous fusionnez une pull request qui nécessite des mises à jour de la documentation, l'agent crée une suggestion dans votre Dashboard. - - - Lorsque vous activez pour la première fois la surveillance d'un référentiel, l'agent crée des suggestions pour les pull requests fusionnées au cours des sept derniers jours. Ce traitement rétroactif n'a lieu que si aucune suggestion n'existe déjà pour ce référentiel. Il se peut que plusieurs suggestions apparaissent immédiatement après l'activation de la surveillance. - - -Si vous désactivez la surveillance, l'agent arrête immédiatement de surveiller le référentiel. Toutes les suggestions existantes pour ce référentiel restent dans votre Dashboard jusqu'à ce que vous les ignoriez. - -
- ### Analyses des conversations -
- -Si vous avez accès à l'agent et à l'Assistant, l'agent génère des suggestions à partir des conversations que vos utilisateurs ont avec l'Assistant. - -L'agent analyse régulièrement les conversations de l'Assistant et crée des suggestions lorsqu'il identifie des tendances dans les questions indiquant des lacunes ou un manque de clarté dans la documentation. - -
- ### Notifications -
- -Les suggestions de l’agent apparaissent toujours dans votre Dashboard. Vous pouvez configurer des notifications pour recevoir des e-mails ou des messages directs Slack lorsque l’agent génère de nouvelles suggestions. - - - Si vous ne recevez pas les notifications par e-mail pour les suggestions, vérifiez votre dossier de courrier indésirable et ajoutez l’adresse e-mail `notifications@mintlify.com` à votre liste d’expéditeurs approuvés. - - -
- ## Examiner les suggestions -
- -L’agent crée des suggestions dans votre Dashboard. Chaque suggestion indique la pull request (demande de fusion) ou la conversation avec l’Assistant qui l’a déclenchée, sa date de création et les mises à jour de documentation proposées. - -Le bouton **Ask agent** dans votre Dashboard affiche le nombre de suggestions en attente de votre examen. - - - Le bouton Ask agent affichant quatre suggestions en mode clair. - - Le bouton Ask agent affichant quatre suggestions en mode sombre. - - -
- ### Créer des pull requests (demandes de fusion) -
- -Ajoutez des suggestions comme context pour permettre à l’agent de créer des pull requests (demandes de fusion). - -1. Cliquez sur le bouton **Ask agent** dans votre Dashboard pour ouvrir le panneau de l’agent. -2. Cliquez sur **Add to chat**. -3. Envoyez la demande à l’agent pour ouvrir une pull request (demande de fusion). - -
- ### Ignorer une suggestion -
- -Si une suggestion ne nécessite pas de mise à jour de la documentation ou si vous avez déjà appliqué les modifications, ignorez-la pour la retirer de votre Dashboard. - -1. Cliquez sur le bouton **Ask agent** dans votre Dashboard pour ouvrir le panneau de l’agent. -2. Cliquez sur le bouton **Dismiss** à côté de toute suggestion que vous souhaitez ignorer. - -La suggestion est immédiatement supprimée de votre Dashboard. Vous ne pouvez pas récupérer les suggestions ignorées. \ No newline at end of file diff --git a/fr/ai-native.mdx b/fr/ai-native.mdx index 36e0d148a..f4d80064c 100644 --- a/fr/ai-native.mdx +++ b/fr/ai-native.mdx @@ -1,64 +1,58 @@ --- -title: "Documentation native à l’IA" +title: "Documentation native à l'IA" sidebarTitle: "IA native" -description: "Découvrez comment l’IA améliore la lecture, la rédaction et la découverte de votre documentation" +description: "Découvrez comment l'IA améliore la lecture, la rédaction et la découverte de votre documentation" keywords: ["AI","assistant","agent","llms.txt","MCP","llms-full.txt"] --- -Lorsque vous hébergez votre documentation sur Mintlify, des fonctionnalités d’IA intégrées aident vos utilisateurs à trouver des réponses et votre équipe à maintenir le contenu plus efficacement. Votre contenu fournit le contexte à ces fonctionnalités natives à l’IA pour améliorer les expériences de lecture, de rédaction et de découverte de votre documentation. +Lorsque vous hébergez votre documentation sur Mintlify, des fonctionnalités d'IA intégrées aident vos utilisateurs à trouver des réponses et votre équipe à maintenir le contenu plus efficacement. Votre contenu fournit le contexte à ces fonctionnalités natives à l'IA pour améliorer les expériences de lecture, de rédaction et de découverte de votre documentation.
- ## Ce qui rend votre documentation native à l’IA + ## Ce qui rend votre documentation native à l'IA
### Consultation
-En plus de consulter des pages individuelles, les utilisateurs peuvent échanger avec l’[Assistant](/fr/ai/assistant) dans votre documentation pour obtenir immédiatement des réponses à leurs questions et des liens vers du contenu pertinent. L’Assistant aide à orienter les utilisateurs dans votre produit grâce à des informations précises tirées de votre documentation. Intégrez l’Assistant à des applications personnalisées via l’[API](/fr/api/assistant/create-assistant-message) afin d’étendre les points d’accès à votre documentation. +En plus de consulter des pages individuelles, les utilisateurs peuvent échanger avec l'[Assistant](/fr/ai/assistant) dans votre documentation pour obtenir immédiatement des réponses à leurs questions et des liens vers du contenu pertinent. L'Assistant aide à orienter les utilisateurs dans votre produit grâce à des informations précises tirées de votre documentation. Intégrez l'Assistant à des applications personnalisées via l'[API](/fr/api/assistant/create-assistant-message) afin d'étendre les points d'accès à votre documentation.
### Rédaction
-L’[agent](/fr/agent) vous aide à rédiger et à maintenir votre documentation. Il crée des pull requests (demandes de fusion) avec des modifications proposées à partir de vos instructions, de pull requests et de fils Slack. Ajoutez l’agent à votre espace de travail Slack pour que chacun dans votre équipe puisse contribuer à la maintenance de votre documentation en discutant avec lui. Ou intégrez l’agent à des applications personnalisées via l’[API](/fr/api/agent/create-agent-job). +L'[agent](/fr/agent) vous aide à rédiger et à maintenir votre documentation. Il crée des pull requests (demandes de fusion) avec des modifications proposées à partir de vos instructions, de pull requests et de fils Slack. Ajoutez l'agent à votre espace de travail Slack pour que chacun dans votre équipe puisse contribuer à la maintenance de votre documentation en discutant avec lui. Ou intégrez l'agent à des applications personnalisées via l'[API](/fr/api/agent/create-agent-job). -Vous pouvez configurer l’agent pour surveiller les dépôts connectés et [suggérer](/fr/agent/suggestions) proactivement des mises à jour de la documentation lorsqu’il identifie des changements visibles pour les utilisateurs. +Créez des [workflows](/fr/agent/workflows) pour exécuter l'agent selon un calendrier ou lors d'un push sur un référentiel. Chaque workflow définit un prompt pour l'agent et un déclencheur indiquant quand l'exécuter. -Configurez des outils populaires comme [Cursor](/fr/guides/cursor), [Claude Code](/fr/guides/claude-code) et [Windsurf](/fr/guides/windsurf) pour s’appuyer sur le schéma Mintlify, votre guide de style et les bonnes pratiques. +Configurez des outils populaires comme [Cursor](/fr/guides/cursor), [Claude Code](/fr/guides/claude-code) et [Windsurf](/fr/guides/windsurf) pour s'appuyer sur le schéma Mintlify, votre guide de style et les bonnes pratiques.
### Découverte
-Votre site est automatiquement optimisé pour les outils d’IA et les moteurs de recherche afin d’aider les utilisateurs à découvrir votre documentation. Toutes les pages envoient leur contenu en Markdown aux agents d’IA plutôt qu’en HTML, ce qui permet à ces outils de traiter votre contenu plus rapidement et d’utiliser moins de jetons. Chaque page est également consultable en Markdown en ajoutant `.md` à l’URL. +Votre site est automatiquement optimisé pour les outils d'IA et les moteurs de recherche afin d'aider les utilisateurs à découvrir votre documentation. Toutes les pages envoient leur contenu en Markdown aux agents d'IA plutôt qu'en HTML, ce qui permet à ces outils de traiter votre contenu plus rapidement et d'utiliser moins de jetons. Chaque page est également consultable en Markdown en ajoutant `.md` à l'URL. -Mintlify héberge les fichiers `llms.txt` et `skill.md` pour votre documentation. Ces fichiers, standard dans l’industrie, aident les LLM à répondre efficacement avec des informations pertinentes aux requêtes des utilisateurs et fournissent une liste de capacités que les agents peuvent utiliser, afin que les utilisateurs réussissent mieux avec votre produit. +Mintlify héberge les fichiers `llms.txt` et `skill.md` pour votre documentation. Ces fichiers, standard dans l'industrie, aident les LLM à répondre efficacement avec des informations pertinentes aux requêtes des utilisateurs et fournissent une liste de capacités que les agents peuvent utiliser, afin que les utilisateurs réussissent mieux avec votre produit. -Votre site de documentation héberge également un serveur MCP qui permet aux utilisateurs de connecter votre documentation directement à leurs outils d’IA pour obtenir des informations à jour sur votre produit, là où ils en ont besoin. +Votre site de documentation héberge également un serveur MCP qui permet aux utilisateurs de connecter votre documentation directement à leurs outils d'IA pour obtenir des informations à jour sur votre produit, là où ils en ont besoin. -La recherche en texte intégral et la compréhension sémantique aident les utilisateurs et les outils d’IA à trouver rapidement des informations pertinentes. La recherche comprend l’intention de l’utilisateur plutôt que de simplement faire correspondre des mots-clés. Et si un utilisateur rencontre une erreur 404, votre site suggère des pages pertinentes pour l’aider à trouver ce qu’il recherche. Aucune configuration n’est requise. +La recherche en texte intégral et la compréhension sémantique aident les utilisateurs et les outils d'IA à trouver rapidement des informations pertinentes. La recherche comprend l'intention de l'utilisateur plutôt que de simplement faire correspondre des mots-clés. Et si un utilisateur rencontre une erreur 404, votre site suggère des pages pertinentes pour l'aider à trouver ce qu'il recherche. Aucune configuration n'est requise.
- ## Activer les fonctionnalités d’IA + ## Activer les fonctionnalités d'IA
-Sélectionnez l’une des cartes suivantes pour en savoir plus. +Sélectionnez l'une des cartes suivantes pour en savoir plus. - + - Configurez l’Assistant pour rechercher sur des sites externes ou orienter les utilisateurs vers votre équipe d’assistance s’il ne peut pas répondre à leurs questions. + Configurez l'Assistant pour rechercher sur des sites externes ou orienter les utilisateurs vers votre équipe d'assistance s'il ne peut pas répondre à leurs questions. - - - Utilisez l’agent dans votre Dashboard pour créer des mises à jour de la documentation. - - - - Surveillez les dépôts Git pour détecter les modifications et recevez des propositions de mises à jour de la documentation. + + Recevez automatiquement des mises à jour de la documentation selon un calendrier ou lors d'un événement push. - - Ajoutez aux pages un menu qui permet aux utilisateurs d’envoyer des requêtes à des outils d’IA, de se connecter à votre serveur MCP et de copier des pages comme contexte en un clic. + Ajoutez aux pages un menu qui permet aux utilisateurs d'envoyer des requêtes à des outils d'IA, de se connecter à votre serveur MCP et de copier des pages comme contexte en un clic. - \ No newline at end of file + diff --git a/fr/changelog.mdx b/fr/changelog.mdx index f8667ad26..ac8732655 100644 --- a/fr/changelog.mdx +++ b/fr/changelog.mdx @@ -228,7 +228,7 @@ noindex: true ## Suggestions de l’Assistant pour tous les utilisateurs - Les [analyses de conversations](/fr/agent/suggestions#conversation-insights) sont désormais disponibles pour tous les sites de documentation qui ont à la fois l’agent et l’Assistant activés. L’agent analyse les tendances dans les conversations avec l’Assistant pour identifier les lacunes de la documentation et suggérer des améliororations, ce qui vous aide à traiter de manière proactive les questions fréquentes des utilisateurs. + Les analyses de conversations sont désormais disponibles pour tous les sites de documentation qui ont à la fois l’agent et l’Assistant activés. L’agent analyse les tendances dans les conversations avec l’Assistant pour identifier les lacunes de la documentation et suggérer des améliororations, ce qui vous aide à traiter de manière proactive les questions fréquentes des utilisateurs. ## Synchronisation des onglets et des groupes de code @@ -254,7 +254,7 @@ noindex: true ## Suggestions de l’agent à partir des conversations avec l’Assistant - L’[agent](/fr/agent) peut désormais suggérer des mises à jour de la documentation sur la base des [conversations avec l’Assistant](/fr/agent/suggestions#conversation-insights). Lorsqu’il est activé, l’agent analyse les questions que les utilisateurs posent à l’Assistant pour identifier les tendances indiquant une documentation manquante ou peu claire. + L’[agent](/fr/agent) peut désormais suggérer des mises à jour de la documentation sur la base des conversations avec l’Assistant. Lorsqu’il est activé, l’agent analyse les questions que les utilisateurs posent à l’Assistant pour identifier les tendances indiquant une documentation manquante ou peu claire. Cela ajoute une deuxième source de suggestions de l’agent en plus de la surveillance du référentiel, ce qui vous aide à traiter de manière proactive les questions fréquentes des utilisateurs. @@ -283,7 +283,7 @@ noindex: true ## Améliorations de l’agent * Ajout de la prise en charge de la lecture des [instructions personnalisées](/fr/agent/customize) depuis un fichier `AGENTS.md`. - * L’agent ouvre désormais des pull requests (demandes de fusion) sous votre compte GitHub si vous [connectez votre compte](/fr/agent/quickstart#connect-your-github-account) dans le Dashboard. + * L’agent ouvre désormais des pull requests (demandes de fusion) sous votre compte GitHub si vous connectez votre compte dans le Dashboard. ## Améliorations de l’Assistant diff --git a/fr/dashboard/audit-logs.mdx b/fr/dashboard/audit-logs.mdx index d1a927ce2..87d1ee9de 100644 --- a/fr/dashboard/audit-logs.mdx +++ b/fr/dashboard/audit-logs.mdx @@ -55,7 +55,7 @@ Filtrez les journaux d’audit pour trouver des activités spécifiques. | Billing | Mises à jour d’abonnements, achats de modules complémentaires et affichage des factures. | | Quota | Modifications de la politique de dépassement de quota et de la configuration des alertes. | | User | Paramètres de notification des utilisateurs individuels. | -| Suggestions | Configurations de suggestions et gestion des référentiels. | +| Workflows | Configurations de workflows et gestion des référentiels. | | Audit log | Consultations et exportations des journaux d’audit. | | Auth | Tentatives de connexion, déconnexions et créations de sessions. | diff --git a/fr/guides/knowledge-base.mdx b/fr/guides/knowledge-base.mdx index aec7f3d34..a3739df62 100644 --- a/fr/guides/knowledge-base.mdx +++ b/fr/guides/knowledge-base.mdx @@ -11,7 +11,7 @@ Mintlify fournit l'infrastructure pour des bases de connaissances auxquelles * **Recherche optimisée par l'IA** : L'[assistant](/fr/ai/assistant) répond aux questions en utilisant le contenu de votre base de connaissances, afin que chacun puisse trouver des réponses sans savoir exactement où chercher. * **Intégrations Slack** : Ajoutez l'assistant à [Slack](/fr/ai/slack-bot) pour que votre équipe puisse poser des questions et utilisez l'[agent](/fr/agent/slack) pour capturer les connaissances issues des conversations. -* **Contributions simplifiées** : Le [web editor](/fr/editor) et l'[agent](/fr/agent/quickstart) permettent à n'importe quel membre de votre équipe de mettre à jour le contenu sans apprendre Git ou Markdown. +* **Contributions simplifiées** : Le [web editor](/fr/editor) et l'[agent](/fr/agent/index) permettent à n'importe quel membre de votre équipe de mettre à jour le contenu sans apprendre Git ou Markdown. * **Authentification intégrée** : Contrôlez l'accès avec [SSO ou OAuth](/fr/deploy/authentication-setup), et utilisez les [groupes](/fr/deploy/authentication-setup#control-access-with-groups) pour afficher des contenus différents selon les équipes.
@@ -227,7 +227,7 @@ Cela convient bien aux experts métier qui connaissent le contenu mais ne sont p ### Agent
-L'[agent](/fr/agent/quickstart) dans votre Dashboard crée des mises à jour de documentation à partir d'instructions en langage naturel. Décrivez ce que vous souhaitez modifier et l'agent crée une pull request (demande de fusion) avec les mises à jour. +L'[agent](/fr/agent/index) dans votre Dashboard crée des mises à jour de documentation à partir d'instructions en langage naturel. Décrivez ce que vous souhaitez modifier et l'agent crée une pull request (demande de fusion) avec les mises à jour. Par exemple, un membre de l'équipe pourrait demander « Ajoutez une section à la page de la politique de dépenses expliquant comment soumettre des reçus pour des repas de plus de 50 $ » et copier la page de la politique de dépenses existante dans l'instruction. L'agent rédigerait le contenu et ouvrirait une pull request (demande de fusion) pour relecture. diff --git a/zh/agent/index.mdx b/zh/agent/index.mdx index e8080ce4f..78aa4ae3d 100644 --- a/zh/agent/index.mdx +++ b/zh/agent/index.mdx @@ -47,14 +47,22 @@ agent 是一款 AI 工具,会根据你的提示,为文档创建包含建议 * **Slack**:将 agent 添加到你的 Slack 工作区,并在任意频道中提及 `@mintlify`。你可以在消息中直接附加文件和图片,供 agent 处理。 * **API**:使用 [agent 端点](/zh/api/agent/create-agent-job) 将 agent 嵌入自定义应用中。 +
+ ## 连接你的 GitHub 账号 +
+ +默认情况下,agent 创建的拉取请求会归属于 Mintlify 机器人。若要将拉取请求归属到你自己,请在控制台的[我的资料](https://dashboard.mintlify.com/settings/account)页面连接你的 GitHub 账号。 + +
+ ## 连接代码仓库作为上下文 +
+ +agent 只能访问你通过 Mintlify GitHub App 连接的代码仓库。你可以在 agent 面板的 **Settings** 中或 [GitHub App 设置](https://github.com/apps/mintlify/installations/new)中配置 agent 可以访问哪些仓库。 +
## 后续步骤
- - 在控制台中开始使用 agent。 - - 将 agent 添加到你的 Slack 工作区。 diff --git a/zh/agent/quickstart.mdx b/zh/agent/quickstart.mdx deleted file mode 100644 index fa86416c0..000000000 --- a/zh/agent/quickstart.mdx +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: "快速入门" -description: "开始在控制台中使用 agent 来更新文档。" -keywords: ["agent 设置"] ---- - -
- ## 打开 Agent 面板 -
- -在桌面设备上,Agent 面板可以调整大小。在移动设备上,Agent 会以全屏方式打开。 - -要打开 Agent 面板: - -- 在控制台的任意页面,使用快捷键 +I(macOS)或 Ctrl+I(Windows/Linux)。 -- 在 [Overview](https://dashboard.mintlify.com/) 页面,点击 **Ask agent**。 - -
- ### Agent 面板视图 -
- - - Agent 面板中的视图:新建聊天、建议、历史记录和设置。 - Agent 面板中的视图:新建聊天、建议、历史记录和设置。 - - -- **Chat**:点击加号 icon,,开始新的聊天。在聊天视图中,向 agent 发送提示词,以更新你的文档或提出问题。Agent 会根据你的指令创建拉取请求(PR;亦称“合并请求”/Merge Request),并显示链接以查看这些拉取请求,或在 web 编辑器中打开变更。 -- **Suggestions**:如果启用,建议面板会基于拉取请求中的更改以及用户与 AI 助手的对话,显示对文档的推荐更新。 -- **History**:点击历史记录 icon,,浏览过去的对话并继续处理先前的请求。点击任意对话即可在聊天视图中加载。 -- **Settings**:点击设置 icon,,配置 agent 的 integrations 和存储库访问权限。 - - - 为每个任务与 agent 开启一段新的对话。这样可以让 agent 的上下文更聚焦,并帮助你将对话与特定项目关联起来。 - - -
- ## 连接你的 GitHub 账号 -
- -默认情况下,代理会以 Mintlify 机器人身份发起拉取请求(PR)。要让拉取请求归属到你本人,请在控制台的 [My profile](https://dashboard.mintlify.com/settings/account) 页面连接你的 GitHub 账号。 - -
- ## 将代码仓库连接为 context -
- -此 agent 只能访问你通过 Mintlify GitHub 应用连接的代码仓库。你可以在 agent 面板的 **Settings**,或在 [GitHub 应用设置](https://github.com/apps/mintlify/installations/new) 中配置 agent 可访问的代码仓库。 \ No newline at end of file diff --git a/zh/agent/suggestions.mdx b/zh/agent/suggestions.mdx deleted file mode 100644 index 646d38c7b..000000000 --- a/zh/agent/suggestions.mdx +++ /dev/null @@ -1,105 +0,0 @@ ---- -title: "Agent 建议" -description: "监控 Git 仓库中的变更,并接收文档更新建议。" -keywords: ["自动化", "文档缺口", "自我更新", "自我更新", "自动更新", "自动驾驶"] ---- - - - Agent 建议适用于 [Enterprise 方案](https://mintlify.com/pricing?ref=autopilot)。如需为你的组织启用该功能,请[联系我们的销售团队](mailto:gtm@mintlify.com)。 - - -你可以让 Agent 基于两个来源提出文档更新建议。 - -* **Pull Request 变更**:监控选定的 Git 仓库中的代码变更,这些变更可能需要更新文档。 -* **AI 助手对话**:分析用户在你的文档站点中向 AI 助手提出的问题,以识别内容缺口。 - -当 Agent 识别出潜在的文档更新时,它会在你的控制台中创建一个建议,并附上创建拉取请求(PR;亦称“合并请求”/Merge Request)所需的上下文信息。 - -使用这些建议,可以在新功能发布时主动保持文档最新,或用来解决常见的用户问题。 - -
- ## 前置条件 -
- -在使用建议功能之前,你必须在你的组织中安装 [Mintlify GitHub 应用](/zh/deploy/github)。该应用必须能够访问你的文档存储库,以及至少一个在代码更改时需要更新文档的其他存储库。 - -
- ## 配置建议 -
- -在代理设置中配置代理需要监控哪些代码仓库,以及你希望如何接收通知。设置页面会显示代理正在监控的所有 GitHub 组织和代码仓库。 - -要打开代理设置: - -1. 在控制台中点击 **Ask agent** 按钮以打开代理面板。 -2. 点击 **Settings** 按钮。 - - 浅色模式下的设置按钮。 - - 深色模式下的设置按钮。 - - -
- ### 监控存储库 -
- -无论合并到哪个 branch,只要你为某个存储库启用了监控,智能体就会监控该存储库中所有已合并的拉取请求(PR)。名为 **Mintlify Autopilot** 的 GitHub 检查会在受监控存储库中的拉取请求上运行,分析这些拉取请求是否需要更新文档。当你合并了需要更新文档的拉取请求时,智能体会在你的控制台中创建一条建议。 - - - 当你首次为某个存储库启用监控时,智能体会为过去 7 天内已合并的拉取请求创建建议。只有在该存储库还不存在任何建议时,才会进行这次回填操作。启用监控后,你可能会立即看到多条建议出现。 - - -如果你禁用监控,智能体会立即停止监控该存储库。该存储库已有的任何建议会继续保留在你的控制台中,直到你将其关闭。 - -
- ### 对话洞察 -
- -如果你同时拥有 agent 和 AI 助手的访问权限,agent 会根据用户与 AI 助手的对话生成建议。 - -agent 会定期分析这些对话,当识别出表明文档内容缺失或不够清晰的问题模式时,就会生成相应的建议。 - -
- ### 通知 -
- -Agent 的建议始终显示在你的控制台中。你可以配置通知,在 Agent 创建新建议时通过电子邮件或 Slack 私信接收提醒。 - - - 如果你没有收到与建议相关的电子邮件通知,请检查垃圾邮件文件夹,并将邮箱地址 `notifications@mintlify.com` 添加到你的安全发件人列表中。 - - -
- ## 审阅建议 -
- -智能代理会在你的控制台中创建建议。每条建议都会显示触发该建议的拉取请求(PR;亦称“合并请求”/Merge Request)或 AI 助手对话主题、创建日期,以及建议的文档更新内容。 - -控制台中的 **Ask agent** 按钮会显示等待你审阅的建议数量。 - - - Ask agent 按钮在浅色模式下显示四条建议。 - - Ask agent 按钮在深色模式下显示四条建议。 - - -
- ### 创建拉取请求 -
- -将这些建议作为 context 提供给 agent,以便其创建拉取请求。 - -1. 在控制台中点击 **Ask agent** 按钮以打开 agent 面板。 -2. 点击 **Add to chat**。 -3. 向 agent 提交该提示,以创建拉取请求。 - -
- ### 忽略建议 -
- -如果某条建议不需要更新文档,或者你已经根据它完成了相关更改,可以忽略它,将其从控制台中移除。 - -1. 在控制台中点击 **Ask agent** 按钮以打开 agent 面板。 -2. 点击你想忽略的任意建议旁边的 **Dismiss** 按钮。 - -该建议会立即从你的控制台中移除,且无法恢复。 \ No newline at end of file diff --git a/zh/ai-native.mdx b/zh/ai-native.mdx index 14076352a..6b3a3b5c0 100644 --- a/zh/ai-native.mdx +++ b/zh/ai-native.mdx @@ -23,7 +23,7 @@ keywords: ["AI","assistant","agent","llms.txt","MCP","llms-full.txt"] [agent](/zh/agent) 可帮助你撰写和维护文档。它会基于你的提示、拉取请求(PR;亦称“合并请求”/Merge Request)以及 Slack 讨论串,创建包含建议更改的拉取请求。将 agent 添加到你的 Slack 工作区,你的团队成员即可通过与 agent 对话协同维护文档。你也可以通过 [API](/zh/api/agent/create-agent-job) 将 agent 嵌入自定义应用。 -你可以配置 agent 监控已连接的代码仓库,并在识别到面向用户的变更时,[主动建议](/zh/agent/suggestions) 文档更新。 +创建 [workflows](/zh/agent/workflows) 以按计划或在代码仓库收到 push 时运行 agent。每个 workflow 定义 agent 执行的 prompt 以及触发执行的条件。 配置常用工具(如 [Cursor](/zh/guides/cursor)、[Claude Code](/zh/guides/claude-code) 和 [Windsurf](/zh/guides/windsurf)),以对齐 Mintlify 架构、你的风格指南和最佳实践。 @@ -45,19 +45,13 @@ Mintlify 会为你的文档托管 `llms.txt` 和 `skill.md` 文件。这些行 选择以下任意卡片以了解更多信息。 - + 配置 AI 助手以搜索外部网站,或在其无法回答问题时将用户引导至你的支持团队。 - - - 在控制台中使用 Agent 创建文档更新。 - - - - 监控 Git 仓库的变更,并接收推荐的文档更新建议。 + + 按计划或在发生 push 事件时自动获取文档更新。 - 为页面添加菜单,让用户可以向 AI 工具发起查询、连接到你的 MCP 服务器,并一键复制整页作为上下文。 diff --git a/zh/changelog.mdx b/zh/changelog.mdx index 2b1bda9b1..cd1a56699 100644 --- a/zh/changelog.mdx +++ b/zh/changelog.mdx @@ -228,7 +228,7 @@ noindex: true ## 面向所有用户的 AI 助手建议 - [对话洞察](/zh/agent/suggestions#conversation-insights) 现已对所有同时启用了 Agent 和 AI 助手的文档站点开放。Agent 会分析用户与 AI 助手对话中的模式,以识别文档空白并给出改进建议,帮助你主动解决用户的常见问题。 + 对话洞察 现已对所有同时启用了 Agent 和 AI 助手的文档站点开放。Agent 会分析用户与 AI 助手对话中的模式,以识别文档空白并给出改进建议,帮助你主动解决用户的常见问题。 ## Tab 与代码组同步 @@ -254,7 +254,7 @@ noindex: true ## 基于 AI 助手对话的 Agent 建议 - [Agent](/zh/agent) 现在可以基于[与 AI 助手的对话](/zh/agent/suggestions#conversation-insights)来建议文档更新。启用后,Agent 会分析用户向 AI 助手提出的问题,以识别哪些模式表明文档存在缺失或表述不清。 + [Agent](/zh/agent) 现在可以基于与 AI 助手的对话来建议文档更新。启用后,Agent 会分析用户向 AI 助手提出的问题,以识别哪些模式表明文档存在缺失或表述不清。 这为 Agent 的建议在存储库监控之外新增了第二个来源,帮助你主动解决用户的常见问题。 @@ -283,7 +283,7 @@ noindex: true ## Agent 功能改进 * 新增从 `AGENTS.md` 文件读取[自定义指令](/zh/agent/customize)的支持。 - * 如果你在控制台中[连接 GitHub 账号](/zh/agent/quickstart#connect-your-github-account),Agent 现在会以你的 GitHub 账号身份创建 PR。 + * 如果你在控制台中连接 GitHub 账号,Agent 现在会以你的 GitHub 账号身份创建 PR。 ## AI 助手功能改进 diff --git a/zh/dashboard/audit-logs.mdx b/zh/dashboard/audit-logs.mdx index e65ae2150..4b5da595d 100644 --- a/zh/dashboard/audit-logs.mdx +++ b/zh/dashboard/audit-logs.mdx @@ -55,7 +55,7 @@ keywords: ["monitoring", "activity tracking", "security", "compliance"] | Billing | 订阅更新、附加组件购买和发票查看。 | | Quota | 超额策略和告警配置更改。 | | User | 个人用户通知设置。 | -| Suggestions | 建议功能配置和存储库管理。 | +| Workflows | Workflow 配置和代码仓库管理。 | | Audit log | 审计日志的查看和导出。 | | Auth | 登录尝试、登出和会话创建。 | diff --git a/zh/guides/knowledge-base.mdx b/zh/guides/knowledge-base.mdx index 45d9b4db6..6ee085801 100644 --- a/zh/guides/knowledge-base.mdx +++ b/zh/guides/knowledge-base.mdx @@ -11,7 +11,7 @@ Mintlify 提供搭建知识库的基础设施,让整个团队都能参与贡 * **AI 驱动搜索**:通过 [AI 助手](/zh/ai/assistant) 使用你的知识库内容来回答问题,让用户即使不知道去哪找,也能找到答案。 * **Slack 集成**:将 AI 助手添加到 [Slack](/zh/ai/slack-bot),这样你的团队就可以在不离开工作流程的情况下提问,并使用 [agent](/zh/agent/slack) 将对话中的信息沉淀为知识。 -* **低门槛贡献**:使用 [web editor](/zh/editor) 和 [agent](/zh/agent/quickstart),团队中的任何人都可以在不学习 Git 或 Markdown 的前提下更新内容。 +* **低门槛贡献**:使用 [web editor](/zh/editor) 和 [agent](/zh/agent/index),团队中的任何人都可以在不学习 Git 或 Markdown 的前提下更新内容。 * **内置认证**:通过 [SSO 或 OAuth](/zh/deploy/authentication-setup) 控制访问,并使用 [用户组](/zh/deploy/authentication-setup#control-access-with-groups) 为不同团队展示不同的内容。
@@ -227,7 +227,7 @@ AI 助手会自动为 Pro 和 Enterprise 套餐启用。AI 助手让你的团队 ### Agent
-控制台中的 [agent](/zh/agent/quickstart) 可以根据自然语言提示生成文档更新。描述你想要修改的内容,agent 会创建包含这些更新的拉取请求(PR;亦称“合并请求”/Merge Request)。 +控制台中的 [agent](/zh/agent/index) 可以根据自然语言提示生成文档更新。描述你想要修改的内容,agent 会创建包含这些更新的拉取请求(PR;亦称“合并请求”/Merge Request)。 例如,某个团队成员可以输入提示:“在报销政策页面中添加一个部分,说明如何提交超过 50 美元餐饮费用的收据”,并将现有的报销政策页面复制到提示中。agent 会起草内容并打开一个 PR 供审核。