Create and Configure a Topic

Create a topic to organize related agents and tools around a business area or purpose and provide users with a focused context for working with those resources.

When creating a topic, you can also grant users or roles access to the topic to control who can view, use, or manage it.

When a user starts a chat from a topic, the orchestrator can invoke the agents and tools associated with that topic. The orchestrator can invoke tools directly without routing requests through an agent.

You must have the appropriate Topics feature permission to create a topic. For information about topic permissions, see Understand Topic-Based Access.

  1. Open Agent Hub.
  2. In the navigation panel, click Registry Registry .
  3. On the Registry page, click the Topics tab Topics tab.
  4. Click Add Topic.
    The Create Topic page is displayed.
  5. In Name, enter a name that clearly identifies business area or purpose of the topic. For example, Finance.
  6. In Description, enter the purpose of the topic to help the user understand when to use the topic. For example, Use this topic to investigate supplier performance, review invoices and payment history, and identify procurement issues.
  7. Optional: In Topic Image, click the field to upload an image that displays with the topic when a user opens the topic. Choose an image that represents the topic's business area or purpose and helps users recognize the topic when working with it.
  8. In Select agents, click Set agents. In the Select agents panel, browse or search for and select the agents whose capabilities support the purpose of the topic.

    Click Done.
  9. In Topic access, click Set access. In the Topic access panel, select Roles or Users, locate the users or roles that you want to grant access to, and select the appropriate access level for each.

    Click Done.
  10. In Connected tools & services, click Set tools. In the Connected tools & services panel, browse or search for and select the tools or MCP servers that you want to include in the topic. Click Done.
  11. In the Create Topic page, confirm the topic's settings.

  12. Click Save.