API do Azure DevOps: work items, repositórios e pipelines com IA
O Azure DevOps expõe Boards, Repos, Pipelines, Test Plans e Artifacts por uma API REST versionada. Times de engenharia e TI usam para automatizar fluxo de trabalho e integrar com outros sistemas. O acesso é por token de acesso pessoal (PAT) ou identidade do Microsoft Entra ID.
Os grandes recursos da API, em português claro.
Criar, atualizar e consultar work items com a linguagem WIQL.
Ler código, branches, commits e comentar em pull requests.
Disparar execuções, ler logs e status de builds e releases.
Consultar planos, casos e resultados de teste.
Enviar eventos para sistemas externos.
Consultar projetos, áreas, iterações e membros.
Como se acessa a API do Azure DevOps.
- Com credencial da sua empresaToken de acesso pessoal (PAT) com escopos limitados, ou OAuth/identidade gerenciada do Microsoft Entra ID, recomendada para integrações.
- Documentação oficiallearn.microsoft.com/rest/api/azure/devops
- PATs expiram e dão acesso amplo; prefira escopos mínimos e Entra ID.
- Disparar pipelines de produção só com aprovação.
- Há limites de uso por usuário; o agente evita varreduras grandes.
- api azure devops
- azure devops rest api
- azure devops api work items
- azure devops pat
- integração azure devops
- azure devops api pull request
O que um agente do iTeam faz com a API do Azure DevOps.
O agente lê o diff, aponta riscos e deixa comentários para o revisor humano decidir.
Quando o pipeline falha, o agente lê o log e posta no Teams a causa provável.
O agente consulta a iteração e resume o que foi entregue e o que está bloqueado.
Relatos de usuários viram work items com passos, ambiente e prioridade.
Da credencial ao agente trabalhando, com aprovação.
Criar o acesso
Crie uma identidade de serviço ou um PAT com escopos mínimos (por exemplo, leitura de work items e código) na organização.
Guardar o acesso e limitar o que cada agente faz
O acesso ao Azure DevOps é cadastrado no cofre do iTeam. Você escolhe quais agentes usam e o que podem fazer (consultar work items, comentar em PR, ler pipelines), com teto de custo e registro de cada chamada.
Rodar o piloto com aprovação
No piloto, peça ao agente um comentário em um PR de teste. O time aprova as ações sensíveis e acompanha o histórico de chamadas no iTeam.
Dúvidas sobre a API do Azure DevOps.
A API do Azure DevOps é gratuita?
A API vem com o Azure DevOps; o custo é o de usuários e recursos do plano, como paralelismo de pipelines.
Preciso programar para usar a API do Azure DevOps com o iTeam?
Não obrigatoriamente. O time de implantação do iTeam configura o acesso ao Azure DevOps e as ações de cada agente a partir da documentação; o TI só libera a credencial e revisa as permissões.
Existe MCP para Azure DevOps?
Sim, a Microsoft disponibiliza um servidor MCP para Azure DevOps. O iTeam pode usá-lo ou chamar a API REST diretamente.
Qual a melhor forma de autenticar um agente de IA no Azure DevOps?
Pela identidade do Microsoft Entra ID, como uma entidade de serviço ou identidade gerenciada, em vez de token de acesso pessoal. O PAT dá acesso amplo, expira e pertence a uma pessoa. Se for usar PAT, limite os escopos, por exemplo a leitura de work items, e coloque uma data de expiração curta.
O agente consegue criar e atualizar work items no Azure DevOps?
Consegue: a API de work items cria itens, altera estado e responsável, e a linguagem WIQL busca por critérios, como bugs abertos de uma sprint. Um uso bom: transformar um relato de cliente em um bug com os campos preenchidos e ligado ao produto certo. A priorização continua com o time.
O Azure DevOps tem sandbox para testar integrações?
Não há um sandbox da API, mas a solução é simples: criar uma organização e um projeto de teste, que cabem no plano gratuito para pequenos times, e apontar o agente para lá. Confira na página oficial os limites atuais do plano gratuito. O projeto de teste isola o agente do trabalho real.
Existe MCP para o Azure DevOps usar com agentes?
Há servidores MCP para o Azure DevOps, mantidos pela Microsoft e pela comunidade, que expõem work items, repositórios e pipelines a agentes. Confira o repositório oficial da Microsoft para o estado atual. No iTeam, a plataforma tem servidor MCP próprio e consegue aprender a API a partir da documentação, então o MCP é uma opção entre outras.
O agente pode disparar pipelines do Azure DevOps?
Pode, pela API de pipelines, mas disparar um pipeline de produção deve exigir aprovação humana. Pipelines de teste ou de ambientes de desenvolvimento podem ser liberados com mais autonomia. O Azure DevOps também permite aprovações e verificações no próprio ambiente, uma segunda camada de controle além da do agente.
Como o agente avisa a equipe sobre pull requests parados no Azure DevOps?
Listando pull requests abertos pela API, conferindo há quanto tempo aguardam revisão e enviando um aviso ao revisor pelo canal do time. Com service hooks, o Azure DevOps notifica o agente a cada novo pull request, sem varreduras. A regra de quanto tempo é demais deve ser combinada com a equipe.
Que limites de uso do Azure DevOps o agente precisa respeitar?
O Azure DevOps limita o uso por usuário e por organização, e chamadas em excesso são atrasadas ou recusadas. O agente deve evitar varreduras grandes, usar consultas filtradas e reaproveitar resultados. Confira na documentação oficial a política de limites vigente, que a Microsoft atualiza.
Vale a pena usar agente de IA no Azure DevOps em um time pequeno de desenvolvimento?
Vale quando o time perde tempo organizando backlog, escrevendo descrições de bugs e cobrando revisões. Em time pequeno, um agente de triagem e resumo já ajuda. Se o backlog é curto e o fluxo é simples, o ganho é pequeno. Código e merge em produção continuam com pessoas.
