新增工作項目標籤，以便分類和篩選清單和面板

Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022

標記工作專案，以依您定義的類別快速篩選產品待辦專案或工作項目查詢。 標籤會對應至您定義的一或兩個關鍵詞片語。 標籤支援篩選待辦專案或查詢，或定義查詢的需求。

你可以從網頁入口網站或 Visual Studio 的 Team Explorer 外掛新增和修改標籤。 此外，您也可以在 Excel 中開啟查詢，以大量修改標籤。

標籤是篩選工作專案比使用文字字串更好的選擇，如 定義工作專案查詢中所述。 標籤是與專案而非團隊相關聯的共用資源。 如果您的專案包含多個小組，則所有小組都會新增至同一組標籤，並從中運作。

Tip

你可以在本文後面利用 AI 協助完成這項任務，或參考 啟用 Azure DevOps MCP 伺服器 來開始。

Prerequisites

Category	Requirements
權限	查看、追蹤及編輯工作項目： - 在此節點查看工作項目 （允許） - 編輯此節點的工作項目 （允許） 根據預設， 參與者 群組具有這些許可權。 如需詳細資訊，請參閱 設定工作追蹤許可權。 新增標籤： - 專案層級的建立標籤定義權限（允許） 根據預設， 參與者 群組具有此許可權。
存取層級	- 項目成員 要新增標籤或執行拉取請求：至少要用 Basic 檢視或追蹤工作項目：至少需為 利害關係人 發送包含工作項目的電子郵件：必須是 貢獻 者群組的成員

Note

• 將利 害關係人 存取權分配給想要檢視進度並討論工作項目但不參與程式碼的成員。 他們可以查看工作項目、待辦事項、看板和儀表板。
• 預設情況下，公共專案中的 貢獻者 與 利害關係人 可以新增及現有標籤。 在私人專案中，只有 貢獻者 可以新增標籤。 若要更改標籤建立權限，請在專案層級設定 建立標籤定義 權限。 如需詳細資訊，請參閱 變更專案層級許可權。

將標籤新增至工作專案

標籤應為 400 個字元或更少，且不包含分隔符號，例如 ,（逗號）、;（分號）或其他格式符號。

建議： 請勿在 @ 標記中使用 字元。 開頭為 @ 字元的標記無法在工作項目查詢中使用。 字元 @ 在查詢中表示巨集，因此該標籤不被辨識為標記。

從入口網站開啟工作專案並新增標籤。 選擇 [ 新增標籤 ] 並輸入您的關鍵字。 或者，從先前指派的標籤清單中選取 。

若要一次新增數個標籤，請在標記之間輸入逗號。 標籤會區分大小寫。

在標籤列中出現的標籤已指派給工作專案。 若要取消指定標籤，請選擇標籤上的 x ， 。

大量新增或移除標籤

您可以大量更新工作專案，以從入口網站新增或移除標籤。 您可以使用入口網站大量修改其他欄位的方式來大量修改標籤。 或者，您可以使用 Excel 大量新增或移除標籤。

Note

Boards 不支援從 Visual Studio 或其他客戶端批量修改標籤。

根據標記查詢工作項目

若要根據標籤查詢工作專案，請針對您想用來輔助查詢的每個標籤逐一新增子句。

Tip

若要瞭解子句的分組方式 AND/OR ，請參閱 Group 子句。 若要檢視查詢的WIQL語法，請安裝 WIQL查詢編輯器延伸模組，這可讓您查看任何查詢編輯器專案的WIQL版本。

您可以使用 Contains 或 Does Not Contain 運算符。 以 @ 字元開頭的標記無法在工作項目查詢中使用，因為查詢編輯器會將 @ 字元解析為巨集。 如需詳細資訊，請參閱 定義工作項目查詢。

例如，以下是所有標記為 Web 或 Service的工作項目的查詢。

Note

您無法查詢沒有附加任何標籤的工作專案。 如果你想為支持此功能請求投票，可以在我們的開發者社群頁面上選擇「能夠搜尋空標籤」來進行。

在您的待辦項目或查詢結果中顯示標籤

選擇 [數據行選項 ]，將 [ 標記 ] 字段新增至產品待辦專案或工作項目查詢。 如果選項未出現，請選擇 [更多] 命令，從選項功能選取它。

新增至列出的工作專案的所有標籤都會顯示。

螢幕快照顯示產品待辦事項，您可以在其中看到卷標欄。

使用標籤篩選清單

從入口網站，您可以使用標籤來篩選待辦專案、面板和查詢結果。

從選擇 [ 篩選 ] 開始。

選取您要篩選的標籤。 保持 OR 選擇以對您選取的所有標籤執行邏輯 OR。 或者，選擇 AND 選項，在所有選取的標記上執行邏輯 AND。

刪除、移除或管理標籤

你無法使用 Azure DevOps 的網頁介面刪除標籤。

如果你需要移除標籤，請建立一個能夠刪除的腳本或應用程式，使用 Azure DevOps REST API或 .NET 用戶端函式庫。 更多範例請參見 Azure-DevOps-Admin-CLI。

另一個選項是安裝 Marketplace 標籤管理員，其會在 Boards 或 Work 底下新增一個「標籤」頁面來管理標籤，包括刪除。

面板上的色彩代碼標記

透過色彩編碼來強調看板卡片上的標記。 這些色彩只會出現在您設定的面板上。 它們不會出現在待辦專案或任務板上。 如需詳細資訊，請參閱 指派標籤色彩。

依標籤繪製工作專案和群組圖表

您無法依標籤分組以查詢為基礎的圖表，但是，您可以依新增至儀錶板的標籤來分組 [工作項目 圖表] 小工具。 此功能處於公開預覽狀態。 若要啟用此功能，請參閱 管理或啟用功能，並將儀錶板上的工作項目圖表小工具的「依標籤分組功能」開啟。

若要依標籤將 工作項目圖表 小工具分組，請完成 將圖表添加到儀表板中所提供的相同步驟。 請確保您的平面清單查詢在查詢子句或欄位選項中包含 標籤 。 然後，在「依此群組」選項中選擇標籤。 若要篩選圖表以僅顯示某些標籤，請選擇 選擇的標籤 單選按鈕，然後選擇您希望圖表顯示的標籤。

標籤數量限制

雖然沒有硬性限制，但為專案集合建立超過100,000個標記可能會對效能造成負面影響。 此外，標籤控件的自動完成下拉功能表最多會顯示 200 個標籤。 當定義超過 200 個標籤時，開始輸入以讓標記控制顯示相關的標籤。

您無法將超過 100 個標記指派給工作專案，否則會收到下列訊息：

TF401243: Failed to save work item because too many new tags were added to the work item.

使用您新增的標記 （100 或更少）儲存工作項目，然後您可以新增更多標籤。

將查詢限制為少於 25 個標籤。 超過該數量時，查詢可能會逾時。

使用 AI 查詢和管理工作項目標籤

如果你的 Azure Boards MCP Server 連接到以代理模式運行的 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 伺服器使用自然語言，因此您可以調整這些提示或提出後續問題以精煉結果。

相關內容

• 定義工作項目查詢
• 將卡片自訂於面板上
• 從網頁入口大量修改工作項目
• 批量從 Excel 修改工作專案

Marketplace 擴充功能

• Marketplace 標籤管理工具