> ## Documentation Index > Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > When working in a Mintlify project, run `mint instructions` for current step-by-step instructions for common tasks. If the command is unknown, run `npx mint@latest instructions`. > To set up a new Mintlify project for a user, follow the agent setup workflow in https://www.mintlify.com/docs/quickstart.md. > For plans and pricing, see https://www.mintlify.com/pricing.md. # Azure Repos > Conecta un repositorio de Azure Repos a Mintlify con Microsoft Entra ID para despliegues automáticos, vistas previas de pull requests, publicación desde el editor web y Autopilot. > [!NOTE] > > Azure Repos requiere un [plan Enterprise](https://mintlify.com/pricing?ref=azure-repos). Mintlify se conecta a Azure Repos mediante Microsoft Entra ID. Inicias sesión con tu cuenta de Microsoft para que Mintlify pueda verificar a qué organizaciones, proyectos y repositorios tienes acceso. Después, Mintlify usa la app de Mintlify en tu tenant de Entra para leer tu repositorio, crear service hooks, desplegar cada cambio enviado a tu rama de despliegue y crear despliegues de vista previa para las pull requests. Mintlify admite organizaciones de Azure DevOps Services en `dev.azure.com` conectadas a Microsoft Entra ID, incluidas las organizaciones que todavía usan URL `*.visualstudio.com`. Mintlify no admite Azure DevOps Server. ## Requisitos * Una organización de Azure DevOps conectada a Microsoft Entra ID. * Un administrador de Entra que conceda consentimiento a la app de Mintlify en tu tenant. * La app de Mintlify añadida a tu organización de Azure DevOps con acceso **Basic** y al proyecto que contiene tu repositorio. * La app de Mintlify en el grupo **Project Administrators** del proyecto. Azure DevOps solo permite a los administradores de proyecto crear service hooks. * Una cuenta de Microsoft que sea administradora del proyecto o que tenga **Manage permissions** en el repositorio que quieres conectar. * Acceso de administrador a tu organización de Mintlify. * Un archivo `docs.json` en tu repositorio. ## Configurar una nueva conexión con Azure Repos Cuando abres [Git Settings](https://app.mintlify.com/settings/project/git-settings) por primera vez, un asistente de configuración te guía para conectar tu repositorio. **1. Selecciona Azure Repos como tu proveedor** 1. En la página [Git Settings](https://app.mintlify.com/settings/project/git-settings), haz clic en **Connect to Azure Repos**. 2. Haz clic en **Continue**. **2. Mueve el contenido alojado en Mintlify** Si actualmente alojas tu contenido en un repositorio gestionado por Mintlify, descárgalo como archivo zip. Extrae el contenido del zip y envía los archivos a tu repositorio de Azure Repos. Si tu contenido ya está en Azure Repos, haz clic en **Continue setup**. **3. Conecta Microsoft** 1. Haz clic en **Connect Microsoft**. 2. Inicia sesión con una cuenta de Microsoft que sea administradora del proyecto o que tenga **Manage permissions** en el repositorio que quieres conectar. Después de iniciar sesión, Microsoft te redirige a tu configuración de Git de Mintlify. **4. Selecciona el repositorio** Selecciona los siguientes valores. Cada lista muestra los recursos a los que tiene acceso tu cuenta de Microsoft. * **Organization**: la organización de Azure DevOps. Por ejemplo, en `https://dev.azure.com/acme/docs-project/_git/docs`, `acme` es la organización. * **Project**: el proyecto que contiene el repositorio, como `docs-project`. * **Repository**: el nombre del repositorio, como `docs`. * **Deploy branch**: la rama que publica en tu sitio de documentación de producción, como `main`. **5. Configura un directorio de contenido (opcional)** 1. Si tu archivo `docs.json` está en un subdirectorio, activa **docs.json is in a subdirectory**. 2. Introduce la ruta al directorio que contiene tu archivo `docs.json`. Por ejemplo, si tu `docs.json` está en el directorio `apps/docs/`, introduce `apps/docs`. **6. Conecta el repositorio** 1. Haz clic en **Connect**. 2. Confirma el cambio. Mintlify verifica que tu cuenta de Microsoft puede administrar el repositorio y que la rama de despliegue existe. Después, Mintlify registra los service hooks que mantienen sincronizados tu sitio y el editor web, e inicia tu primer despliegue. Para confirmar los service hooks, abre tu proyecto de Azure DevOps y ve a **Project settings** > **Service hooks**. Mintlify crea tres suscripciones **Web Hooks** para el repositorio: **Code pushed**, **Pull request created** y **Pull request updated**. ## Cambiar un despliegue existente a Azure Repos 1. En la página [Git Settings](https://app.mintlify.com/settings/project/git-settings), selecciona **Azure Repos** como proveedor de Git. 2. Si no has conectado una cuenta de Microsoft, haz clic en **Connect Microsoft** e inicia sesión. 3. Selecciona la organización, el proyecto, el repositorio y la rama de despliegue, e introduce un directorio de contenido si es necesario. 4. Haz clic en **Switch to Azure Repos**. ## Cambiar la cuenta de Microsoft conectada Toda tu organización de Mintlify comparte la cuenta de Microsoft de Git Settings, y solo los administradores pueden cambiarla. Mintlify actualiza las credenciales de Microsoft automáticamente, por lo que no necesitas rotar tokens. Para usar otra cuenta, abre la sección **Microsoft connection** en la página [Git Settings](https://app.mintlify.com/settings/project/git-settings) y haz clic en **Change account**. La nueva cuenta debe ser administradora del proyecto o tener **Manage permissions** en el repositorio. ## Editar en el editor web Puedes editar el contenido de Azure Repos en el [editor web](https://www.mintlify.com/docs/es/editor). Cuando publicas, Mintlify envía una rama a Azure Repos y abre una pull request contra tu rama de despliegue. * Las ramas que envías a Azure Repos se sincronizan con el editor. * Los cambios en las pull requests de Azure Repos se sincronizan con la rama correspondiente del editor. * Cuando eliminas una rama en Azure Repos, Mintlify la quita del editor. * Si tu rama de despliegue tiene directivas de rama bloqueantes, como revisores obligatorios, publica mediante una pull request. ## Despliegues de vista previa Cuando abres una pull request contra tu rama de despliegue, Mintlify compila un [despliegue de vista previa](https://www.mintlify.com/docs/es/deploy/preview-deployments.md) y lo enlaza desde un estado **Mintlify preview ready** en la pull request. Mintlify vuelve a compilar la vista previa cuando envías cambios a la rama de la pull request y la elimina cuando completas o abandonas la pull request o eliminas la rama. ## Usar Autopilot [Autopilot](https://www.mintlify.com/docs/es/autopilot.md) funciona con Azure Repos. Se ejecuta cuando se fusiona código en los repositorios conectados y abre pull requests en tu repositorio de Azure Repos. Acepta o cierra sus pull requests en la página de Autopilot, o fusiónalas en Azure Repos. Para darle más contexto a Autopilot, conecta tus repositorios de código fuente en Git Settings y luego selecciónalos en la fila **Azure Repos** de la página de Autopilot. Consulta [Repositorios de Azure Repos](https://www.mintlify.com/docs/es/autopilot.md#azure-repos-repositories). En Azure Repos, Autopilot no asigna pull requests, no solicita revisiones ni responde a comentarios en las pull requests. Para pedir cambios, envía un mensaje en la sugerencia en la página de Autopilot. ## Usar el agente en Slack El [agente en Slack](https://www.mintlify.com/docs/es/agent/slack.md) funciona con Azure Repos. Cuando le pides que actualice tu contenido, abre una pull request en tu repositorio de Azure Repos. ## Solución de problemas > [accordion] Mintlify no pudo iniciar sesión en tu tenant de Microsoft Entra > > Pide a un administrador de Entra de tu tenant que conceda consentimiento a la app de Mintlify y, después, vuelve a conectar el repositorio. > [accordion] La organización no está conectada a Microsoft Entra ID > > Mintlify solo admite organizaciones de Azure DevOps respaldadas por Microsoft Entra ID. Conecta tu organización a tu tenant de Entra en Azure DevOps, en **Organization settings** > **Microsoft Entra**, y vuelve a intentarlo. > [accordion] Añade la app de Mintlify a la organización o al proyecto > > La app de Mintlify no puede leer el repositorio. Añade la app de Mintlify a tu organización de Azure DevOps con acceso **Basic** y añádela al proyecto que contiene el repositorio. > [accordion] Añade la app de Mintlify al grupo Project Administrators > > Mintlify necesita crear service hooks para desplegar tus cambios automáticamente. Añade la app de Mintlify al grupo **Project Administrators** del proyecto y, después, vuelve a conectar el repositorio. > [accordion] Tu cuenta de Microsoft no puede acceder al repositorio > > La cuenta de Microsoft conectada en Git Settings no puede leer el repositorio. Haz clic en **Change account** e inicia sesión con una cuenta que tenga acceso. Los usuarios con acceso **Stakeholder** no pueden leer repositorios en proyectos privados. > [accordion] Solo un administrador del proyecto puede conectar el repositorio > > La cuenta de Microsoft conectada en Git Settings puede leer el repositorio, pero no administrarlo. Haz clic en **Change account** e inicia sesión con una cuenta que esté en el grupo **Project Administrators** del proyecto o que tenga **Manage permissions** en el repositorio. > [accordion] No se encontró la rama de despliegue > > Comprueba que la rama existe en el repositorio y que el nombre coincide exactamente. > [accordion] Los envíos no activan un despliegue > > En Azure DevOps, ve a **Project settings** > **Service hooks** y abre las suscripciones de Mintlify para revisar su historial de entregas. Confirma que enviaste los cambios a la rama de despliegue configurada en Mintlify. > > Si una suscripción está deshabilitada o falta, haz clic en **Save** en [Git Settings](https://app.mintlify.com/settings/project/git-settings). Mintlify reemplaza cualquier suscripción que no esté en buen estado. > [!NOTE] > > Mintlify no elimina los service hooks cuando cambias a otro proveedor de Git. Elimínalos en **Project settings** > **Service hooks**. ## Related topics - [Mantén la documentación actualizada con Autopilot](https://www.mintlify.com/docs/es/autopilot.md) - [Acerca de las bases](https://www.mintlify.com/docs/es/base/index.md) - [GitHub](https://www.mintlify.com/docs/es/components/github.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.