Azure DevOps 服务 |Azure DevOps Server |Azure DevOps Server 2022
标记工作项以便按定义的类别快速筛选产品积压工作或工作项查询。 标记对应于定义的一个或两个关键字短语。 标记支持您筛选工作积压或查询，或定义查询。
可以通过 Web 门户或 Visual Studio 的团队资源管理器插件添加和修改标记。 此外，还可以在 Excel 中打开查询以批量修改标记。
标记是筛选工作项比使用文本字符串更好的选择，如 “定义工作项查询”中所述。 标记是与项目而不是与团队相关联的共享资源。 如果项目包含多个团队，则所有团队会添加到同一标记集并通过此标记集进行工作。
Tip
可以在本文后面了解如何使用 AI 来帮助完成此任务，或查看Azure DevOps MCP Server 中的 Enable AI Assistance以便开始。
Prerequisites
| Category | Requirements |
|---|---|
| 权限 | - 若要查看、关注和编辑工作项：查看此节点中的工作项，并 编辑此节点中的工作项 权限设置为 “允许”。 默认情况下，参与者组具有这些权限。 有关详细信息，请参阅设置工作跟踪权限。 - 若要将标记添加到工作项：项目级别 创建新标记定义 权限设置为 允许。 默认情况下，参与者组拥有此权限。 |
| 访问权限级别 |
-
项目成员。 - 若要将标记添加到工作项，或者查看或跟踪拉取请求：至少具有“基本”访问权限。 - 若要查看或跟踪工作项：需至少拥有 级别的利益相关者 访问权限。 有关详细信息，请参阅关于访问级别。 - 所有项目成员（包括 读者 组中的成员）都可以发送电子邮件，其中包含工作项。 |
Note
- 为希望参与讨论和评审进度的成员提供 利益干系人访问权限 。 这些成员通常不参与代码，但想要查看工作项、积压工作、面板和仪表板。
向工作项添加标记
标记长度应不超过 400 个字符，并且不包含分隔符（例如 ,（逗号）、;（分号）），或其他格式的字符。
建议：不要在标记中使用 @ 字符。 无法在工作项查询中使用以 @ 字符开头的标记。 字符 @ 表示查询中的宏，因此无法将此标记识别为标记。
从 Web 门户打开工作项并添加标记。 选择“添加标记”并键入关键字。 或者，从之前分配的标记的列表中进行选择。
若要一次性添加多个标记，请在各个标记之间键入逗号。 标记是区分大小写的。
标记栏上出现的标记已分配给工作项。 若要取消分配标记，请选择标记上的 x。 
批量添加或删除标记
可以批量更新工作项以从 Web 门户中添加或删除标记。 批量修改标记的方式与使用 Web 门户批量修改其他字段的方式相同。 或者，可以使用 Excel 批量添加或删除标记。
Note
Boards 不支持从Visual Studio或其他客户端批量修改标记。
基于标记查询工作项
若要基于标记查询工作项，请为要用于支持查询的每个标记添加子句。
Tip
要了解 AND/OR 子句的分组方式，请参阅对子句进行分组。 若要查看查询的 WIQL 语法，请安装 WIQL 查询编辑器扩展，以便查看任何查询编辑器条目的 WIQL 版本。
可以使用 Contains 或 Does Not Contain 运算符。 不能在工作项查询中使用以 @ 字符开头的标记，因为查询编辑器将 @ 字符解释为宏。 有关详细信息，请参阅定义工作项查询。
例如，下面是一个查询，查询的是标记为Web或Service的所有工作项。
Note
无法查询没有附加任何标记的工作项。 如果您想为支持此功能的请求投票，可以在我们的开发者社区页面能够搜索空标记上表达支持。
显示积压工作 (backlog) 或查询结果中的标记
选择“列选项”可将“标记”字段添加到产品积压工作或工作项查询中。 如果选项未显示，请选择“更多命令”
，从选项菜单中将其选中。
所有添加到列出的工作项的标记都会出现。
使用标记筛选列表
在 Web 门户中，可以使用标记筛选积压工作、面板和查询结果。
首先选择“筛选器”
。
选择要筛选的标记。 保持选择 OR，以便对所选的所有标记运行逻辑 OR。 或者，选择 AND 选项，以便对所有选定的标记运行逻辑 AND。
删除、移除或管理标记
无法使用 Azure DevOps Web UI 删除标记。
如果需要删除标记，请使用 Azure DevOps REST API 或 .NET 客户端库创建能够删除的脚本或应用程序。 有关更多示例，请参阅 Azure-DevOps-Admin-CLI。
另一个选项是安装市场标记管理器，它可以在“Boards”或“工作”下添加“标记”页来管理标记（包括删除）。
面板上的颜色代码标记
通过对面板卡片进行颜色编码来突出显示标记。 这些颜色仅显示在你配置的面板上。 它们不会显示在积压工作或“任务面板”上。 有关详细信息，请参阅 “分配标记颜色”。
绘制工作项图表并按标记分组
虽然无法按标记对基于查询的图表进行分组，但可以按添加到仪表板的标记对工作项图表小组件进行分组。 此功能目前以公共预览版提供。 要启用该功能，请参阅管理或启用功能，并开启“为仪表板上的工作项图表小部件启用按标记分组”。
若要按标记对 “工作项图表 ”小组件进行分组，请完成向 仪表板添加图表中提供的相同步骤。 确保您的平面列表查询在查询子句中包含标签，或将其作为列选项。 然后，在“分组依据”选项中选择“标记”。 若要筛选图表以仅显示某些标记，请选择“所选标记”单选按钮，然后选择想要图表显示的标记。
标记数限制
虽然不存在硬性限制，不过为项目集合创建 10 万个以上的标记可能会对性能产生负面影响。 此外，标记控件的自动完成下拉菜单最多显示 200 个标记。 在定义超过 200 个标记时，开始输入会导致标记控件显示相关标记。
无法为工作项分配 100 个以上的标记，否则将收到以下消息：
TF401243: Failed to save work item because too many new tags were added to the work item.
保存已添加标记（100 个或更少）的工作项，然后可以添加更多标记。
将查询限制为 25 个以下的标记。 超过该数量时，查询可能会超时。
在产品积压工作上向默认列视图添加标记
若要将 “标记” 字段添加为产品积压工作列字段，请修改 ProcessConfiguration 文件以包含 System.Tags 有关详细信息，请参阅 Process 配置 XML 元素参考。
使用人工智能查询和管理工作项标记
如果Azure Boards MCP 服务器在代理模式下连接到 AI 代理，则可以使用自然语言提示根据标记查找和更新工作项。
| 任务 | 示例提示 |
|---|---|
| 查找标记的项目 | Find all active work items tagged with "security" in my project |
| 批量添加标记 | Add the tag "tech-debt" to all active bugs in the current sprint |
| 查找未标记的项目 | List work items with no tags assigned in the <Contoso> area path |
| 按多个标记查询 | Find user stories tagged with both "performance" and "P1" |
| 列出正在使用的所有标记 | Show all distinct tags used on work items in project <Contoso> sorted by usage count |
| 清理过时标记 | List tags in <Contoso> that are used on fewer than 2 work items |
| 替换标记 | Find all work items in <Contoso> tagged "wontfix" and replace that tag with "by-design" |
| 按条件标记 | Add tag "needs-review" to all user stories in <Contoso> that were resolved in the last week but have no linked pull request |
| 分析标记模式 | Show the count of active work items per tag in area path <Contoso\\Frontend> |
| 查找标记不匹配 | List work items in <Contoso> tagged "sprint-goal" that aren't assigned to the current sprint |
Note
代理模式和 MCP 服务器使用自然语言，因此你可以调整这些提示或提出后续问题来优化结果。