Writing and Updating Topic Descriptions, Scope and Instructions
5 minutes
5 Questions
In Agentforce, topics are the building blocks that define what an agent can handle. Writing and updating topic descriptions, scope, and instructions is essential for guiding how an autonomous agent behaves and responds to user requests. Each element serves a distinct purpose in shaping agent perfor…In Agentforce, topics are the building blocks that define what an agent can handle. Writing and updating topic descriptions, scope, and instructions is essential for guiding how an autonomous agent behaves and responds to user requests. Each element serves a distinct purpose in shaping agent performance.
The topic description explains the overall purpose of a topic. It should clearly state what business area or task the topic covers, such as order management, case creation, or account inquiries. A well-crafted description helps the agent classify incoming user requests and route them to the correct topic, improving accuracy and relevance of responses.
The scope defines the boundaries of what the topic should and should not do. It clarifies the range of actions the agent may take within that topic. By setting a precise scope, administrators help the agent understand when a request belongs to a particular topic versus another, reducing confusion and keeping interactions focused on appropriate tasks.
Instructions provide detailed, step-by-step guidance on how the agent should behave when the topic is triggered. These are natural language directives that tell the agent how to respond, what tone to use, which actions to invoke, and how to handle specific scenarios or edge cases. Clear instructions ensure consistent, reliable, and business-aligned behavior.
When writing or updating these elements, administrators should use concise, unambiguous language and align content with business goals. Testing changes in the Agent Builder or Testing Center helps verify that the agent responds as expected. Regular updates keep topics relevant as business needs evolve.
As a Platform Administrator, mastering these components allows you to fine-tune agent capabilities, maintain governance, and deliver trustworthy automated experiences. Strong descriptions, well-defined scope, and precise instructions together form the foundation of effective, controllable, and high-performing Agentforce agents that meet organizational requirements.
Writing and Updating Topic Descriptions, Scope and Instructions in Agentforce
Why This Matters In Agentforce, topics are the building blocks that define what your AI agent can do. Writing clear topic descriptions, scope, and instructions is essential because these elements guide the agent in deciding which topic to activate and how to behave when it does. Poorly written topics can lead to confusion, incorrect responses, or the agent failing to help users properly. Mastering this skill ensures your agent performs reliably and delivers value to your organization.
What Are Topics, Descriptions, Scope, and Instructions? Topics represent a category of related actions and knowledge that an agent can handle, such as handling order inquiries or booking appointments.
A topic description is a natural language summary that tells the agent what the topic covers. It helps the agent classify user requests and route them to the correct topic.
The scope defines the boundaries of what a topic should and should not address. It clarifies the range of the topic so the agent stays focused on relevant tasks.
Instructions are specific guidelines that tell the agent how to behave, what steps to follow, and how to respond when operating within a topic. They shape the agent's tone, decision-making, and use of actions.
How It Works When a user interacts with an agent, Agentforce uses the topic description to match the user's request to the most appropriate topic. Once a topic is selected, the agent relies on the scope to understand its limits and the instructions to determine the correct actions and responses.
Well-crafted descriptions use clear, specific language that reflects real user intent. Effective scope statements state what falls inside and outside the topic. Strong instructions are concise, action-oriented, and written in plain language so the agent can follow them accurately.
Best Practices for Writing and Updating Descriptions: Keep them focused on the purpose of the topic. Use terminology your users would naturally use.
Scope: Be explicit about what the topic handles and what belongs elsewhere. This prevents overlap between topics.
Instructions: Write them as clear steps or rules. Specify when to use particular actions and how to handle edge cases. Update instructions whenever business processes change.
Always test the agent after updates to confirm that changes produce the expected behavior.
How to Answer Exam Questions on This Topic Exam questions often present a scenario where an agent behaves incorrectly and ask you to identify the fix. Focus on which element (description, scope, or instructions) is responsible for the issue. If the agent selects the wrong topic, the description or scope likely needs refinement. If the agent selects the right topic but responds poorly, the instructions are usually the cause.
Exam Tips: Answering Questions on Writing and Updating Topic Descriptions, Scope and Instructions 1. Remember that topic descriptions drive topic selection and matching to user intent.
2. When a scenario shows an agent handling tasks outside its purpose, look to the scope as the answer.
3. If the agent performs the wrong steps or uses the wrong tone within a correct topic, the fix lies in the instructions.
4. Choose answers that favor clear, specific, natural language over vague or overly technical wording.
5. Watch for options suggesting you overlap topics; the best practice keeps each topic distinct with well-defined boundaries.
6. Prefer answers that recommend testing the agent after any update to confirm expected behavior.
7. Be cautious of answers that claim a single element solves every problem; match the element to the specific symptom described in the question.
