API de Azure DevOps: work items, repositorios y pipelines con IA
Azure DevOps expone Boards, Repos, Pipelines, Test Plans y Artifacts mediante una API REST con versiones. Los equipos de ingeniería y de TI la usan para automatizar el flujo de trabajo e integrarlo con otros sistemas. El acceso se hace con un token de acceso personal (PAT) o con una identidad de Microsoft Entra ID.
Qué ofrece la API de Azure DevOps
Work items y WIQL
Crear, actualizar y consultar work items con el lenguaje WIQL.
Repositorios y pull requests
Leer código, ramas y commits, y comentar en los pull requests.
Pipelines
Lanzar ejecuciones y leer los logs y el estado de builds y releases.
Test Plans
Consultar planes, casos y resultados de prueba.
Service hooks
Enviar eventos a sistemas externos.
Proyectos y equipos
Consultar proyectos, áreas, iteraciones y miembros.
Cómo acceder a la API de Azure DevOps
- Con las credenciales de tu empresaToken de acceso personal (PAT) con scopes limitados, u OAuth o identidad administrada de Microsoft Entra ID, recomendada para integraciones.
- Los PAT caducan y dan acceso amplio; prefiere scopes mínimos y Entra ID.
- Lanzar pipelines de producción, solo con aprobación.
- Hay límites de uso por usuario; el agente evita los barridos grandes.
Documentación oficial: learn.microsoft.com/rest/api/azure/devops
Qué hace un agente de iTeam con la API de Azure DevOps
Revisión de pull requests
El agente lee el diff, señala riesgos y deja comentarios para que el revisor humano decida.
Build roto explicado
Cuando el pipeline falla, el agente lee el log y publica en Teams la causa probable.
Estado del sprint
El agente consulta la iteración y resume lo que se entregó y lo que está bloqueado.
Bug bien registrado
Los reportes de usuarios se convierten en work items con pasos, entorno y prioridad.
De la credencial al agente trabajando, con aprobación
Crear el acceso
Crea una identidad de servicio o un PAT con scopes mínimos (por ejemplo, lectura de work items y de código) en la organización.
Guardar el acceso y limitar lo que hace cada agente
El acceso a Azure DevOps se registra en la bóveda de iTeam. Tú eliges qué agentes lo usan y qué pueden hacer (consultar work items, comentar en un PR, leer pipelines), con un tope de costo y el registro de cada llamada.
Ejecutar el piloto con aprobación
En el piloto, pide al agente un comentario en un PR de prueba. El equipo aprueba las acciones sensibles y sigue el historial de llamadas en iTeam.
Equipos de IA listos para este trabajo
Preguntas sobre la API de Azure DevOps
¿La API de Azure DevOps es gratuita?
La API viene con Azure DevOps; el costo es el de los usuarios y los recursos del plan, como el paralelismo de pipelines.
¿Necesito programar para usar la API de Azure DevOps con iTeam?
No necesariamente. El equipo de implantación de iTeam configura el acceso a Azure DevOps y las acciones de cada agente a partir de la documentación; TI solo habilita la credencial y revisa los permisos.
¿Existe un MCP para Azure DevOps?
Sí, Microsoft ofrece un servidor MCP para Azure DevOps. iTeam puede usarlo o llamar directamente a la API REST.