Azure DevOps

使用说明

Integrate Azure DevOps into your workflow. List and inspect pipelines and builds, query and manage work items, and add or read comments.

工具

`azure_devops_list_pipelines`

List all pipelines in an Azure DevOps project. Returns pipeline ID, name, folder, revision, and URL.

输入

参数	类型	必填	描述
`organization`	string	是	Azure DevOps organization name
`project`	string	是	Azure DevOps project name
`orderBy`	string	否	Field to sort results by (e.g. "name")
`top`	number	否	Maximum number of pipelines to return
`continuationToken`	string	否	Continuation token for paginating results

输出

参数	类型	描述
`content`	string	Human-readable summary of pipelines
`metadata`	object	Pipelines metadata
↳ `count`	number	Total number of pipelines returned
↳ `pipelines`	array	Array of pipeline objects
↳ `id`	number	Pipeline ID
↳ `name`	string	Pipeline name
↳ `folder`	string	Folder path (e.g. "\\")
↳ `revision`	number	Pipeline revision number
↳ `url`	string	Pipeline API URL

`azure_devops_get_pipeline`

Get details for a specific pipeline in an Azure DevOps project, including configuration and repository info.

输入

参数	类型	必填	描述
`organization`	string	是	Azure DevOps organization name
`project`	string	是	Azure DevOps project name
`pipelineId`	number	是	ID of the pipeline to retrieve
`pipelineVersion`	number	否	Specific revision of the pipeline to retrieve (defaults to latest)

输出

参数	类型	描述
`content`	string	Human-readable summary of the pipeline
`metadata`	object	Pipeline detail metadata
↳ `pipeline`	object	Full pipeline detail object
↳ `id`	number	Pipeline ID
↳ `name`	string	Pipeline name
↳ `folder`	string	Folder path
↳ `revision`	number	Pipeline revision number
↳ `url`	string	Pipeline API URL
↳ `configuration`	object	Pipeline configuration
↳ `type`	string	Configuration type (e.g. "yaml")
↳ `path`	string	YAML file path in the repository
↳ `repository`	object	Source repository info
↳ `id`	string	Repository ID
↳ `type`	string	Repository type (e.g. "azureReposGit")
↳ `links`	object	Hypermedia links
↳ `self`	string	API self-link
↳ `web`	string	Browser URL for the pipeline

`azure_devops_list_pipeline_runs`

List runs for a specific pipeline in an Azure DevOps project. Returns run ID, name, state, result, and timestamps.

输入

参数	类型	必填	描述
`organization`	string	是	Azure DevOps organization name
`project`	string	是	Azure DevOps project name
`pipelineId`	number	是	ID of the pipeline whose runs to list

输出

参数	类型	描述
`content`	string	Human-readable summary of pipeline runs
`metadata`	object	Pipeline runs metadata
↳ `count`	number	Total number of runs returned
↳ `runs`	array	Array of pipeline run objects
↳ `id`	number	Run ID
↳ `name`	string	Run name (e.g. "20210601.1")
↳ `state`	string	Run state (e.g. "completed", "inProgress")
↳ `result`	string	Run result (e.g. "succeeded", "failed") — absent if still running
↳ `createdDate`	string	ISO 8601 creation timestamp
↳ `finishedDate`	string	ISO 8601 finish timestamp — absent if still running
↳ `url`	string	Run API URL
↳ `webUrl`	string	Browser URL for the run

`azure_devops_get_pipeline_run`

Get details for a specific pipeline run in an Azure DevOps project. Returns run state, result, timestamps, and the pipeline reference.

输入

参数	类型	必填	描述
`organization`	string	是	Azure DevOps organization name
`project`	string	是	Azure DevOps project name
`pipelineId`	number	是	ID of the pipeline
`runId`	number	是	ID of the run to retrieve

输出

参数	类型	描述
`content`	string	Human-readable summary of the pipeline run
`metadata`	object	Pipeline run metadata
↳ `run`	object	Full pipeline run detail object
↳ `id`	number	Run ID
↳ `name`	string	Run name (e.g. "20210601.1")
↳ `state`	string	Run state (e.g. "completed", "inProgress")
↳ `result`	string	Run result (e.g. "succeeded", "failed") — absent if still running
↳ `createdDate`	string	ISO 8601 creation timestamp
↳ `finishedDate`	string	ISO 8601 finish timestamp — absent if still running
↳ `url`	string	Run API URL
↳ `webUrl`	string	Browser URL for the run
↳ `pipeline`	object	Pipeline reference
↳ `id`	number	Pipeline ID
↳ `name`	string	Pipeline name
↳ `folder`	string	Pipeline folder
↳ `revision`	number	Pipeline revision number
↳ `url`	string	Pipeline API URL

`azure_devops_list_builds`

List builds in an Azure DevOps project. Optionally filter by pipeline definition, status, result, or branch.

输入

参数	类型	必填	描述
`organization`	string	是	Azure DevOps organization name
`project`	string	是	Azure DevOps project name
`definitionIds`	string	否	Comma-separated pipeline definition IDs to filter by (e.g. "1,2,3")
`top`	number	否	Maximum number of builds to return
`statusFilter`	string	否	Filter by build status: inProgress, completed, cancelling, postponed, notStarted, none
`resultFilter`	string	否	Filter by build result: succeeded, partiallySucceeded, failed, canceled
`branchName`	string	否	Filter by source branch name (e.g. "refs/heads/main")

输出

参数	类型	描述
`content`	string	Human-readable summary of builds
`metadata`	object	Builds metadata
↳ `count`	number	Total number of builds returned
↳ `builds`	array	Array of build objects
↳ `id`	number	Build ID
↳ `buildNumber`	string	Build number (e.g. "20210601.1")
↳ `status`	string	Build status (e.g. "completed", "inProgress")
↳ `result`	string	Build result (e.g. "succeeded", "failed") — absent if still running
↳ `queueTime`	string	ISO 8601 queue timestamp
↳ `startTime`	string	ISO 8601 start timestamp
↳ `finishTime`	string	ISO 8601 finish timestamp — absent if still running
↳ `sourceBranch`	string	Source branch (e.g. "refs/heads/main")
↳ `sourceVersion`	string	Source commit SHA
↳ `definition`	object	Pipeline definition reference
↳ `id`	number	Definition ID
↳ `name`	string	Definition name
↳ `webUrl`	string	Browser URL for the build

`azure_devops_list_build_logs`

List all log entries for a specific build in Azure DevOps. Returns log IDs, types, and line counts — use the log ID with the Get Build Log tool to fetch actual log text.

输入

参数	类型	必填	描述
`organization`	string	是	Azure DevOps organization name
`project`	string	是	Azure DevOps project name
`buildId`	number	是	The build ID whose logs to list

输出

参数	类型	描述
`content`	string	Human-readable summary of build logs
`metadata`	object	Build logs metadata
↳ `count`	number	Total number of log entries returned
↳ `logs`	array	Array of log entry objects
↳ `id`	number	Log entry ID — use with Get Build Log to fetch content
↳ `type`	string	Log type (e.g. "Container", "Task", "Section")
↳ `url`	string	API URL for the log entry
↳ `lineCount`	number	Number of lines in the log
↳ `createdOn`	string	ISO 8601 creation timestamp
↳ `lastChangedOn`	string	ISO 8601 last-changed timestamp

`azure_devops_get_build_log`

Fetch the text content of a specific build log in Azure DevOps. Use List Build Logs first to get the log ID. Optionally retrieve only a line range with startLine/endLine.

输入

参数	类型	必填	描述
`organization`	string	是	Azure DevOps organization name
`project`	string	是	Azure DevOps project name
`buildId`	number	是	The build ID containing the log
`logId`	number	是	The log entry ID to fetch (from List Build Logs)
`startLine`	number	否	First line to return (1-based, inclusive)
`endLine`	number	否	Last line to return (1-based, inclusive)

输出

参数	类型	描述
`content`	string	Raw log text
`metadata`	object	Log metadata
↳ `lineCount`	number	Number of lines in the returned log text

`azure_devops_get_build_timeline`

Get the execution timeline for an Azure DevOps build — every stage, job, and task with its result and log ID. Use this to identify which steps failed before fetching their logs with Get Build Log.

输入

参数	类型	必填	描述
`organization`	string	是	Azure DevOps organization name
`project`	string	是	Azure DevOps project name
`buildId`	number	是	ID of the build whose timeline to retrieve

输出

参数	类型	描述
`content`	string	Summary of the build timeline, highlighting failed steps
`metadata`	object	Build timeline metadata
↳ `totalCount`	number	Total number of timeline records
↳ `failedCount`	number	Number of failed records
↳ `records`	array	All timeline records (stages, jobs, tasks)
↳ `id`	string	Record GUID
↳ `name`	string	Step name (e.g. "Run tests")
↳ `type`	string	Stage \| Phase \| Job \| Task
↳ `result`	string	succeeded \| failed \| skipped \| canceled \| null
↳ `logId`	number	Log ID to pass to Get Build Log, or null
↳ `errorCount`	number	Number of errors
↳ `warningCount`	number	Number of warnings
↳ `startTime`	string	ISO 8601 start timestamp
↳ `finishTime`	string	ISO 8601 finish timestamp
↳ `failedRecords`	array	Subset of records where result is failed, partiallySucceeded, or succeededWithIssues — use logId to fetch logs
↳ `id`	string	Record GUID
↳ `name`	string	Step name
↳ `type`	string	Stage \| Phase \| Job \| Task
↳ `result`	string	failed
↳ `logId`	number	Log ID to pass to Get Build Log
↳ `errorCount`	number	Number of errors
↳ `warningCount`	number	Number of warnings
↳ `startTime`	string	ISO 8601 start timestamp
↳ `finishTime`	string	ISO 8601 finish timestamp

`azure_devops_get_work_items_between_builds`

Get work item references associated with commits between two builds in Azure DevOps. Returns work item IDs and URLs — use Get Work Items Batch for full field details.

输入

参数	类型	必填	描述
`organization`	string	是	Azure DevOps organization name
`project`	string	是	Azure DevOps project name
`fromBuildId`	number	是	The older build ID (start of range)
`toBuildId`	number	是	The newer build ID (end of range)

输出

参数	类型	描述
`content`	string	Human-readable summary of work items between builds
`metadata`	object	Work items metadata
↳ `count`	number	Total number of work item references returned
↳ `workItems`	array	Array of work item references
↳ `id`	string	Work item ID
↳ `url`	string	API URL for the work item

`azure_devops_query_work_items`

Execute a WIQL query to search for work items in Azure DevOps and return full field details. Use TOP N in your query to limit results (Azure enforces a 200-item maximum per batch fetch).

输入

参数	类型	必填	描述
`organization`	string	是	Azure DevOps organization name
`project`	string	是	Azure DevOps project name
`wiqlQuery`	string	是	WIQL query string (e.g. "SELECT [System.Id] FROM workitems WHERE [System.State] = 'Doing' ORDER BY [System.Id] ASC"). Use TOP N to limit results.

输出

参数	类型	描述
`content`	string	Human-readable summary of matching work items
`metadata`	object	Work items metadata
↳ `count`	number	Number of work items returned (after hydration)
↳ `totalMatched`	number	Total number of work items matched by the WIQL query before hydration
↳ `workItems`	array	Array of work item details
↳ `id`	number	Work item ID
↳ `title`	string	Work item title
↳ `state`	string	Current state for Basic process (e.g. To Do, Doing, Done)
↳ `workItemType`	string	Work item type returned by Azure DevOps (e.g. Issue, Task, Epic)
↳ `assignedTo`	string	Display name of assigned user, or null if unassigned
↳ `areaPath`	string	Area path of the work item
↳ `url`	string	API URL for the work item

`azure_devops_get_work_item`

Fetch full details of a single work item by ID from Azure DevOps, including title, state, type, assignee, and area path.

输入

参数	类型	必填	描述
`organization`	string	是	Azure DevOps organization name
`project`	string	是	Azure DevOps project name
`workItemId`	number	是	The work item ID to fetch

输出

参数	类型	描述
`content`	string	Human-readable summary of the work item
`metadata`	object	Work item metadata
↳ `workItem`	object	Full work item details
↳ `id`	number	Work item ID
↳ `title`	string	Work item title
↳ `state`	string	Current state for Basic process (e.g. To Do, Doing, Done)
↳ `workItemType`	string	Work item type returned by Azure DevOps (e.g. Issue, Task, Epic)
↳ `assignedTo`	string	Display name of assigned user, or null if unassigned
↳ `areaPath`	string	Area path of the work item
↳ `url`	string	API URL for the work item

`azure_devops_get_work_items_batch`

Fetch full details for multiple work items by ID from Azure DevOps. Pass comma-separated IDs (e.g.

输入

参数	类型	必填	描述
`organization`	string	是	Azure DevOps organization name
`project`	string	是	Azure DevOps project name
`ids`	string	是	Comma-separated work item IDs to fetch (e.g. "123,456,789"). Lists longer than 200 IDs are chunked automatically.

输出

参数	类型	描述
`content`	string	Human-readable summary of the fetched work items
`metadata`	object	Work items metadata
↳ `count`	number	Number of work items returned
↳ `totalRequested`	number	Total number of IDs requested (across all chunks)
↳ `workItems`	array	Array of work item details
↳ `id`	number	Work item ID
↳ `title`	string	Work item title
↳ `state`	string	Current state for Basic process (e.g. To Do, Doing, Done)
↳ `workItemType`	string	Work item type returned by Azure DevOps (e.g. Issue, Task, Epic)
↳ `assignedTo`	string	Display name of assigned user, or null if unassigned
↳ `areaPath`	string	Area path of the work item
↳ `url`	string	API URL for the work item

`azure_devops_create_work_item`

Create a new Basic-process work item (Issue, Task, or Epic) in Azure DevOps. Returns the created work item with its assigned ID.

输入

参数	类型	必填	描述
`organization`	string	是	Azure DevOps organization name
`project`	string	是	Azure DevOps project name
`workItemType`	string	是	Basic-process work item type to create ("Issue", "Task", or "Epic"). Use Issue for bug or defect tracking.
`title`	string	是	Title of the new work item
`description`	string	否	HTML description of the work item (optional)
`assignedTo`	string	否	Email or display name of the user to assign the work item to (optional)
`priority`	number	否	Priority of the work item (1 = Critical, 2 = High, 3 = Medium, 4 = Low)
`effort`	number	否	Effort (Microsoft.VSTS.Scheduling.Effort). Basic process: Issue only.
`startDate`	string	否	Start date (Microsoft.VSTS.Scheduling.StartDate), ISO 8601. Basic process: Epic only.
`targetDate`	string	否	Target date (Microsoft.VSTS.Scheduling.TargetDate), ISO 8601. Basic process: Epic only.
`activity`	string	否	Activity (Microsoft.VSTS.Common.Activity). One of Deployment, Design, Development, Documentation, Requirements, Testing. Basic process: Task only.
`remainingWork`	number	否	Remaining work hours (Microsoft.VSTS.Scheduling.RemainingWork). Basic process: Task only.
`completedWork`	number	否	Completed work hours (Microsoft.VSTS.Scheduling.CompletedWork). Basic process: Task only.
`areaPath`	string	否	Area path for the work item, e.g. "MyProject\\Team" (optional)
`iterationPath`	string	否	Iteration path for the work item, e.g. "MyProject\\Sprint 1" (optional)
`tags`	string	否	Semicolon-separated tags, e.g. "issue; p1; auth" (optional)

输出

参数	类型	描述
`content`	string	Human-readable summary of the created work item
`metadata`	object	Created work item metadata
↳ `workItem`	object	Full details of the created work item
↳ `id`	number	Assigned work item ID
↳ `title`	string	Work item title
↳ `state`	string	Initial state for Basic process (e.g. To Do, Doing, Done)
↳ `workItemType`	string	Work item type returned by Azure DevOps (e.g. Issue, Task, Epic)
↳ `assignedTo`	string	Display name of assigned user, or null if unassigned
↳ `areaPath`	string	Area path of the work item
↳ `url`	string	API URL for the created work item

`azure_devops_update_work_item`

Update one or more fields on an existing work item in Azure DevOps. Provide only the fields you want to change.

输入

参数	类型	必填	描述
`organization`	string	是	Azure DevOps organization name
`project`	string	是	Azure DevOps project name
`workItemId`	number	是	ID of the work item to update
`title`	string	否	New title for the work item (optional)
`description`	string	否	New HTML description for the work item (optional)
`assignedTo`	string	否	Email or display name to reassign the work item to (optional)
`areaPath`	string	否	New area path for the work item (optional)
`priority`	number	否	Priority of the work item (1 = Critical, 2 = High, 3 = Medium, 4 = Low) (optional)
`state`	string	否	New state for Basic-process work items: "To Do", "Doing", or "Done" (optional)
`effort`	number	否	Effort (Microsoft.VSTS.Scheduling.Effort). Basic process: Issue only.
`startDate`	string	否	Start date (Microsoft.VSTS.Scheduling.StartDate), ISO 8601. Basic process: Epic only.
`targetDate`	string	否	Target date (Microsoft.VSTS.Scheduling.TargetDate), ISO 8601. Basic process: Epic only.
`activity`	string	否	Activity (Microsoft.VSTS.Common.Activity). One of Deployment, Design, Development, Documentation, Requirements, Testing. Basic process: Task only.
`remainingWork`	number	否	Remaining work hours (Microsoft.VSTS.Scheduling.RemainingWork). Basic process: Task only.
`completedWork`	number	否	Completed work hours (Microsoft.VSTS.Scheduling.CompletedWork). Basic process: Task only.
`tags`	string	否	Semicolon-separated tags to set on the work item (optional)

输出

参数	类型	描述
`content`	string	Human-readable summary of the updated work item
`metadata`	object	Updated work item metadata
↳ `workItem`	object	Full details of the updated work item
↳ `id`	number	Work item ID
↳ `title`	string	Work item title
↳ `state`	string	Current state after update
↳ `workItemType`	string	Work item type returned by Azure DevOps (e.g. Issue, Task, Epic)
↳ `assignedTo`	string	Display name of assigned user, or null if unassigned
↳ `areaPath`	string	Area path of the work item
↳ `url`	string	API URL for the work item

`azure_devops_add_comment`

Add a comment to a work item in Azure DevOps.

输入

参数	类型	必填	描述
`organization`	string	是	Azure DevOps organization name
`project`	string	是	Azure DevOps project name
`workItemId`	number	是	ID of the work item to comment on
`text`	string	是	Comment text (HTML supported, e.g. "<p>My comment</p>")

输出

参数	类型	描述
`content`	string	Human-readable confirmation of the added comment
`metadata`	object	Added comment metadata
↳ `comment`	object	Full details of the created comment
↳ `workItemId`	number	Work item the comment belongs to
↳ `commentId`	number	Comment ID
↳ `version`	number	Comment version
↳ `text`	string	Comment text
↳ `renderedText`	string	Rendered HTML comment text when available
↳ `createdBy`	string	Display name of the comment author, or null
↳ `createdDate`	string	ISO timestamp when comment was created
↳ `modifiedBy`	string	Display name of the last modifier, or null
↳ `modifiedDate`	string	ISO timestamp when comment was modified
↳ `isDeleted`	boolean	Whether the comment is deleted
↳ `url`	string	API URL for the comment

`azure_devops_get_comments`

List comments for an Azure DevOps work item.

输入

参数	类型	必填	描述
`organization`	string	是	Azure DevOps organization name
`project`	string	是	Azure DevOps project name
`workItemId`	number	是	ID of the work item whose comments should be listed
`top`	number	否	Maximum number of comments to return
`continuationToken`	string	否	Continuation token for paginating comments
`includeDeleted`	boolean	否	Whether deleted comments should be returned
`expand`	string	否	Additional comment data to include: none, reactions, renderedText, renderedTextOnly, all
`order`	string	否	Sort order for comments: asc or desc

输出

参数	类型	描述
`content`	string	Human-readable summary of work item comments
`metadata`	object	Comments metadata
↳ `count`	number	Number of comments returned in this page
↳ `totalCount`	number	Total number of comments on the work item
↳ `continuationToken`	string	Continuation token for the next page
↳ `nextPage`	string	API URL for the next page
↳ `url`	string	API URL for this comments list
↳ `comments`	array	Array of work item comments
↳ `workItemId`	number	Work item ID
↳ `commentId`	number	Comment ID
↳ `version`	number	Comment version
↳ `text`	string	Comment text
↳ `renderedText`	string	Rendered HTML comment text when available
↳ `createdBy`	string	Display name of the comment author
↳ `createdDate`	string	ISO 8601 creation timestamp
↳ `modifiedBy`	string	Display name of the last modifier
↳ `modifiedDate`	string	ISO 8601 modified timestamp
↳ `isDeleted`	boolean	Whether the comment is deleted
↳ `url`	string	API URL for the comment

Azure DevOps

On this page