Assign labels to your knowledge base documents

Labels let you tag documents in your knowledge base so your agent knows which content to use and when. This article walks you through assigning, creating, and removing labels directly from the builder.

📘

Note: Labels are available on Custom plans only. Contact your account manager to enable this feature for your account.

Before you start

• Labels must be enabled for your account. (See 👉 Enable and use agents for your knowledge base
• You need an existing agent with pages in its knowledge base.

Steps

1. On the agent whose documents you want to label, click the three-dot menu and select Build.

2. On the Build page, select the Documents tab.

3. Locate the document you want to label and click its metadata icon.

4. In the pop-up, scroll down to the Labels field.

Click the Labels field. A dropdown appears showing all labels in your agent's label library. Select a label to assign it to the document. You can assign more than one label to a document.

6. If the label you need does not exist yet, type it directly into the Labels field and click Add label.

7. Enter the label name once again and click Save Label. The new label is saved to your agent's label library and assigned to the document at the same time. It will appear in the dropdown for all other documents going forward.

8. To remove a label, In the Labels field, click the label you want to remove and deselect it. The label is removed from the document but remains in your agent's label library for future use.

9. Click Save Changes

---

What happens next

Once documents are labelled, you can use those labels to control which pages your agent draws from when responding to users. See Enable and use labels for your agent for how to configure filtering in your deployment.

🚧

Early Access: The Labels feature is currently in Early Access and available on Custom plans only. Behavior and availability are subject to change.

---

Related articles

• Enable and use labels for your agent