What is an Agent Topic, and what makes a well-written topic description?
Suggested answer
An Agent Topic defines a coherent domain of capability for the agent, grouping related Actions that serve a common user goal. Each topic has:
1. Label: The internal name (e.g., "Case Management").
2. Description: Natural language text consumed by the Planner to classify which topic applies to a user's request. This is critical — a poorly written description causes misclassification.
3. Scope: Clarifies what this topic does and does not handle, preventing overlap with other topics.
4. Actions: The list of Actions assigned to this topic. A well-written description: uses clear, specific language about the user intent it addresses ("Use this topic when the user wants to create, update, or escalate a support case"); explicitly excludes adjacent intents ("Do not use this topic for billing questions — see the Billing topic"); is written from the user's perspective, not a technical description of the implementation. A single agent can have multiple topics, and the Planner's classification accuracy depends entirely on the clarity and non-overlap of these descriptions.
Practice content for interview preparation; not an official vendor answer. Verify details against current product documentation.
Community comments (0)
No comments yet.
Sign in or create a free account to add a comment. Comments are moderated before they appear.