Azure DevOps
Microsoft Azure DevOps integration for work items, repositories, pull requests, and pipelines
The Azure DevOps integration lets your agents work with Boards (work items and WIQL queries), Repos (repositories and pull requests), and Pipelines in an Azure DevOps organization through the Azure DevOps REST API.
Prerequisites
You need:
- Organization — your Azure DevOps organization name, the
<org>segment inhttps://dev.azure.com/<org>. - Personal Access Token (PAT) — create one at
https://dev.azure.com/<org>/_usersSettings/tokenswith the scopes your tools need (Work Items, Code, Build).
Setup
- Open Integrations from the sidebar
- Select Azure DevOps from the catalog
- Click Add Integration Config
- Give the config a display name (e.g., "Azure DevOps — Platform").
- Enter your Organization name.
- In the auth section, paste your PAT into the Password field. The Username can be left blank or set to anything — Azure DevOps only reads the token.
- Save the config
Connection testing is available — click Test on the saved config to verify the organization and token against the Azure DevOps API before deploying.
Using in Your Agent
- Open your agent in Agent Studio and select an Agent Step
- Under Attached Integration Configurations, click Attach configuration and choose your config
- Attach Azure DevOps tools from the tools panel
- Tools are referenced as
azure_devops.list_projects,azure_devops.create_work_item, etc.
Most tools take a project (name or ID from List Projects). Pull request tools also need a repository_id (from List Repositories), and pipeline tools a pipeline_id (from List Pipelines).
Available Tools
Projects & Repositories
| Tool | Description | Action Type |
|---|---|---|
list_projects | List projects in the organization | ReadOnly |
list_repositories | List Git repositories in a project | ReadOnly |
Boards (Work Items)
| Tool | Description | Action Type |
|---|---|---|
query_work_items | Find work items with a WIQL query | ReadOnly |
get_work_item | Get a work item with all fields | ReadOnly |
create_work_item | Create a work item (Task, Bug, etc.) | Reversible |
update_work_item | Update a work item via JSON Patch | Reversible |
add_work_item_comment | Add a comment to a work item | Reversible |
Repos (Pull Requests)
| Tool | Description | Action Type |
|---|---|---|
list_pull_requests | List pull requests in a repository | ReadOnly |
get_pull_request | Get a pull request by ID | ReadOnly |
create_pull_request | Open a pull request | Reversible |
Pipelines
| Tool | Description | Action Type |
|---|---|---|
list_pipelines | List pipelines in a project | ReadOnly |
list_pipeline_runs | List recent runs of a pipeline | ReadOnly |
run_pipeline | Queue a new pipeline run | Reversible |