docs(TSP-1108): add agent tagging system documentation

get-started/core-concepts/agents.mdx

@@ -6,7 +6,7 @@
 
 ## What are Agents?
 
 Agents are powered by LLMs that plan and complete tasks on autopilot. They are given tools, and decide how to use tools to achieve goals prompted by you.
 
 Unlike traditional automation that follows rigid, pre-programmed rules, AI agents can:
 
@@ -29,7 +29,7 @@
     If an agent doesn't know something, it can escalate to a human, store the answer, and use it next time. Ours posts unknowns to Slack for fast input and learning.
   </Card>
   <Card title="Works solo or with you" icon="user-gear">
     Agents can run fully autonomously or in co-pilot mode. One of ours builds Webflow pages daily—no human touch required.
   </Card>
   <Card title="Responds flexibly" icon="arrows-split-up-and-left">
     Unlike rule-based tools, agents adapt their responses to each task. A support agent might troubleshoot one day and resolve billing the next.
@@ -84,6 +84,17 @@
 
 You can organize your Agents into folders within your project, making it easier to categorize and find Agents based on their purpose, department, or use case. This is particularly useful for teams managing large numbers of Agents across different functions.
 
+### Tagging agents
+
+You can create custom color-coded tags to categorize and organize your Agents by function, department, project, or any other criteria that fits your workflow. Tags give you a flexible labeling system that works alongside folders to help you identify agents at a glance.
+
+Tags appear in two places:
+
+- **The Tag column** in your agents list
+- **The agent header** when viewing or editing an agent
+
+You can create multiple tags with different colors, and assign more than one tag to a single agent. This makes it straightforward to filter and identify agents across large collections without opening each one individually.
+
 ## How to get the most from your Agents?
 
 When inventing or creating an agent, you'd want to utilize domain expertise or model an agent after a Domain expert:
@@ -93,7 +104,7 @@
 3. **Establish escalation protocols**: Create clear paths for agents to involve humans when needed
 4. **Monitor and refine**: Regularly review agent performance and make adjustments
 5. **Integrate with existing systems**: Connect agents to your current tools and workflows
-6. **Organize for efficiency**: Use pinning and folders to keep your most important Agents easily accessible
+6. **Organize for efficiency**: Use pinning, folders, and tags to keep your most important Agents easily accessible
 
 By thoughtfully implementing AI agents, organizations can enhance productivity, improve customer experiences, and free human employees to focus on work that requires creativity, empathy, and strategic thinking.
 
@@ -170,8 +181,9 @@
 
     - **Pin important Agents**: Keep your most frequently used Agents at the top of your agents list in the main app for quick access
     - **Use folders**: Organize Agents into folders based on purpose, department, or use case
+    - **Add tags**: Create custom color-coded tags to label Agents by function, department, or project — tags appear in the agents list and agent header
     - **Project organization**: Separate Agents across different projects based on your team structure
-    
+
     These organizational features help you manage large collections of Agents efficiently.
   </Accordion>
 </AccordionGroup>