Guidelines for Creating Topics

Topic creators should plan the purpose, contents, and access requirements for a topic before creating it. A well-defined topic groups related agents and tools around a recognizable type of business work and provides Agent Hub with a focused set of resources to consider when users work within the topic.

Use the following guidelines when planning a topic.

Organize Topics Around Business Areas

Create topics around a recognizable business area or type of work rather than around the teams that develop or own the agents.

For example, a Finance topic might contain agents that support reconciliation, period close, and financial reporting. Organizing agents this way helps users select a topic based on the work they want to accomplish rather than requiring them to know which team owns a particular agent.

Keep Topics Focused

Include agents and tools that are relevant to the purpose of the topic and support the types of requests users are likely to make.

When a user works within a topic, the orchestrator considers the agents and tools associated with that topic rather than all available resources. Keeping the topic focused provides a relevant set of resources for Agent Hub to consider.

Use Clear Topic Names and Descriptions

Give each topic a clear name and description that communicate its business purpose and help users understand when to use it.

Agent Hub uses the topic description when answering questions about the topic's capabilities, such as What can this topic help with? The orchestrator doesn't use the topic description to select agents or tools when processing requests.

For example:

Name: Finance

Description: Use this topic to work with agents and tools that support reconciliation, period close, and financial reporting.

Add a Recognizable Topic Image

Add an image that helps users recognize the topic when they open and work with it. Choose an image that represents the topic's business area or purpose and helps distinguish it from other topics.

Topic images are displayed with the topic when the user works within the topic.

Select Resources That Support the Topic's Purpose

Add agents and tools that support the business area or work represented by the topic. Before adding a resource, consider whether its capabilities are relevant to the requests users are likely to submit while working within the topic.

Avoid adding a resource solely because it's available. Each resource should have a clear relationship to the topic's purpose.

For information about adding or removing agents and tools from existing topics, see Modify a Topic.

Plan Topic Access

Consider who needs to use, manage, and administer the topic when planning its configuration.

An Agent Hub administrator controls access to the Topics feature. A topic administrator controls access to the individual topic.

Topic access can provide users with an access path to the agents associated with the topic instead of requiring direct access to each agent individually. Other required Agent Hub and AI Registry access still applies.

When planning access, grant users only the level of access required for their responsibilities. Users who only need to work within a topic don't need the same permissions as users who manage the topic or administer access.

For information about how topic access works, see Understand Topic-Based Access.

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

Why this matters

A well-planned topic helps users recognize when the topic is relevant, provides Agent Hub with a focused set of agents to consider, and makes it easier to provide appropriate access to related business capabilities.

For information about creating and configuring a topic, see Create and Configure a Topic.