> ## Documentation Index
> Fetch the complete documentation index at: https://docs.duckie.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Knowledge Tags

> Organize and filter knowledge for agents

Knowledge tags let you organize articles and control which knowledge each agent can access.

{/* Screenshot: Tags management view showing tags with article counts */}

## What are Knowledge Tags?

Tags are labels you apply to knowledge articles. They serve two purposes:

### 1. Organization

Group related articles together:

* Find articles by topic
* Keep knowledge base organized
* See what content exists for each area

### 2. Access Control

Restrict which knowledge agents can search:

* **Billing Agent** → Only "billing", "payments" tagged articles
* **Technical Agent** → Only "technical", "api" tagged articles
* **General Agent** → All articles (no tag filter)

## Managing Tags

### Creating Tags

<Steps>
  <Step title="Navigate to Knowledge">
    Go to **Train → Knowledge**.
  </Step>

  <Step title="Open Tag Manager">
    Click **Manage Tags** in the page header.

    {/* Screenshot: Knowledge page with Manage Tags button highlighted */}
  </Step>

  <Step title="Create Tag">
    Click **Create Tag**, enter a name, and save.

    {/* Screenshot: Create tag dialog with name field */}
  </Step>
</Steps>

### Editing Tags

1. Open the tag manager
2. Click on a tag to edit
3. Rename or change color
4. Save changes

### Deleting Tags

1. Open the tag manager
2. Click delete on the tag
3. Confirm removal

<Warning>
  Deleting a tag removes it from all articles that use it. This may affect agent knowledge access.
</Warning>

## Tagging Articles

### When Creating

{/* Screenshot: Article editor with tags dropdown showing available tags */}

1. In the article editor, find the **Tags** field
2. Click to open the tag selector
3. Check the tags that apply
4. Save the article

### Bulk Tagging

To tag multiple articles at once:

1. Select articles in the list view
2. Click **Add Tags**
3. Choose tags to apply
4. Confirm

{/* Screenshot: Articles list with multiple selected and Add Tags button */}

### Auto-Tagging from Sources

Tag all content from a source automatically:

1. Edit the knowledge source
2. Set default tags
3. All synced articles receive these tags

## Filtering Agent Knowledge

Control which knowledge an agent can access:

<Steps>
  <Step title="Open Agent Configuration">
    Go to **Build → Agents** and click on an agent.
  </Step>

  <Step title="Go to Knowledge Tab">
    Select the **Knowledge** tab.
  </Step>

  <Step title="Select Tags">
    Choose tags to include. The agent will only search articles with these tags.

    {/* Screenshot: Agent configuration - knowledge tab with tag filter */}
  </Step>

  <Step title="Save">
    Save the agent configuration.
  </Step>
</Steps>

### How Filtering Works

| Configuration      | What Agent Searches            |
| ------------------ | ------------------------------ |
| No tags selected   | All articles                   |
| "billing" selected | Only articles tagged "billing" |
| "billing" + "faq"  | Articles tagged with either    |

## Tagging Strategies

### By Topic

Organize by subject matter:

```
billing, payments, invoices
technical, api, troubleshooting
account, login, security
shipping, returns, delivery
```

### By Product

Useful for multi-product companies:

```
product-a, product-b
platform, mobile-app
enterprise, free-tier
```

### By Team

Match your organizational structure:

```
support, sales, engineering
tier-1, tier-2, escalation
```

### By Audience

Control visibility:

```
customer-facing, internal-only
public, confidential
```

### Combined Approach

Most organizations use multiple dimensions:

```
billing + customer-facing
technical + product-a + tier-1
```

## Example Setup

**Company with multiple products and support tiers:**

**Tags created:**

* `product-a`, `product-b`, `platform`
* `billing`, `technical`, `account`
* `tier-1`, `tier-2`
* `internal`

**Agents configured:**

| Agent             | Tag Filter  | Can Search                       |
| ----------------- | ----------- | -------------------------------- |
| Product A Support | `product-a` | Only Product A articles          |
| Billing Agent     | `billing`   | Only billing articles            |
| Tier 1 Agent      | `tier-1`    | Only tier-1 appropriate articles |
| Internal Agent    | All tags    | Everything including internal    |

## Best Practices

### Naming

* Use lowercase, hyphenated names: `customer-support`, not `Customer Support`
* Be consistent across your organization
* Keep names short but descriptive

### Organization

* Don't over-tag — 2-3 tags per article is usually enough
* Review tags periodically for cleanup
* Remove unused tags

### Access Control

* Start broad, then narrow as needed
* Test that agents can find the knowledge they need
* Balance restriction with usefulness

## Next Steps

<CardGroup cols={2}>
  <Card title="Custom Knowledge" icon="file-lines" href="/knowledge/custom-knowledge">
    Create tagged articles
  </Card>

  <Card title="Agent Configuration" icon="robot" href="/agents/configuration">
    Set up agent knowledge access
  </Card>
</CardGroup>