Understand Topic-Based Access

Topics organize related agents and tools around a common business area or purpose. When a user starts a chat from a topic, the orchestrator can use the agents and tools associated with that topic to process the request.

Topic-based access can provide an alternative to granting a user access to each individual agent associated with the topic. When the required topic access is granted, the agents associated with that topic become available to the user through the topic. Other required Agent Hub and AI Registry access still applies.

How Topic Access Works

Topic access is controlled at two levels.
Access Level What It Controls Managed By
Topics feature access Determines whether a user can access the Topics feature and what actions they can perform, such as using, creating, or managing topics. It doesn't grant access to individual topics. Agent Hub administrator
Individual topic access Determines whether a user can view, use, or manage a particular topic, provided they also have the required Topics feature access. Topic administrator

An Agent Hub administrator grants access to the Topics feature from Agent Hub Administration. A topic administrator separately grants access to individual topics from the Topic access section of the Edit Topic page. Both levels of access are required to use a particular topic.

Topic Permission Levels

The Topics feature provides the following access levels:
Access Level General Purpose
None The user doesn't have access to the Topics feature.
Viewer The user can view topics where the applicable topic access permits it.
User The user can use topics where the applicable topic access permits it.
Manager The user can manage topics where the applicable topic access permits it, including updating topic information and managing associated AI resources.
Administrator The user has administrative capabilities for topics.

Access a Specific Topic

In addition to access to the Topics feature, a user must have access to the particular topic. Access to an individual topic determines whether the user can view, use, or manage that topic. A topic administrator manages this access.

Permission to view a topic doesn't necessarily allow the user to start a conversation from it. The user must have the appropriate permission to use the topic.

Access Agents Through a Topic

Topic-based access provides an alternative to granting individual access to every agent associated with the topic.

For example, suppose a Recruiting topic contains agents that help with recruiting-related tasks. Instead of granting the user individual access to each agent in the topic, an administrator can provide the required topic access. The user can then reach the associated agents through the Recruiting topic, assuming the user's other required access is in place.

Topic-based access doesn't necessarily make the associated agents directly visible to the user outside the topic. The topic provides the access path to those agents.

Why this matters

Topic-based access can simplify access management when multiple users need to work with a related group of agents. Instead of granting direct access to each agent individually, administrators can use topics to provide an appropriate access path to the agents associated with a business area or purpose.

Topic access doesn't replace the other access requirements described in this chapter. The user must still have the permissions required to access Agent Hub and the applicable AI Registry areas.

For information about granting access to the Topics feature, see Grant and Manage Topic Access.

For information about granting access to an individual topic, see Grant Users or Roles Access to a Topic.