Agent Script Example: Ground Your Agent With Updated Terminology

Ensure that your grounded agent understands your organization’s evolving jargon, domain-specific terms, or updated product names — without having to update and reindex your information sources.

Grounded agents are grounded in information, either using an Agentforce Data Library or Retrieval Augmented Generation. However, the grounding information might contain only formal names while customers use jargon, acronyms, or new names. Even if the grounding information contains both correct and jargon terms, it might be indexed only on the correct names — so the retriever or data library misses relevant chunks even though correct information exists.

Updating and reindexing an agent’s grounding information (which typically contains thousands of articles) can be time-consuming and involve special roles. Plus, jargon can change quickly!

One solution is to map informal to correct terms before retrieval. Maintain a lightweight old-to-new term map in Salesforce Knowledge (or other object), fetch the mapped information once per session, and hydrate the prompt so the agent can translate user questions when necessary. By telling your agent to map jargon to correct terms before fetching grounding content, your agent can find relevant chunks in the search index and reduce false “irrelevant question” routing. By using Knowledge (or other object), business users rather than IT can make terminology updates.

This solution is a good fit when:

• Your grounding content is mostly correct, but users ask questions with terms that differ from your indexed content.
• Product names, acronyms, or internal jargon change frequently, but the core content in your data library is still accurate.
• Your terminology map isn’t so large that it impacts your agent’s context engineering.

This solution is not a good fit when:

• Your terminology map is so large it starts to affect your agent’s performance.
• Your information sources are easy to update and re-index.

To follow along with this example, you can sign up for a free Salesforce Developer Edition org, then configure the org with Data Cloud and Agentforce.

For a complete Agentforce implementation guide, see Create Agents in Record Time with Agentforce Implementation Guides.

1. Go to the signup page to sign up for a Developer Edition org with Agentforce and Data Cloud.
2. Fill out the form and submit it.
3. Look for a welcome email from Salesforce in your inbox.
4. Verify your account using the verification link in the email.
5. When prompted, set a new password and select a security question for your Developer Edition org. Then complete the login process.
6. Keep track of your username and password so that you can log in again later from the Salesforce login page.

Data Cloud is required for essential Einstein generative AI and Agentforce functionality, such as the Trust Layer, agent event logs, and consumption billing tracking. In our example, we need Data Cloud for Agentforce Data Library.

Verify your Data Cloud installation. From Setup, in the Quick Find box, enter Data Cloud, and then select Data Cloud Setup Home. Verify that a home org is created on the Data Cloud Setup Home page, with a home org ID, a home org instance, and a tenant endpoint.

If Data Cloud isn’t set up, in Set Up Data Cloud, click Get Started. Setup can take about 10 minutes.

Turn on Einstein to use generative AI features, including Agentforce.

1. From Setup, in the Quick Find box, enter Einstein Setup, and then select Einstein Setup.
2. Enable Turn on Einstein.
3. Refresh the page.

After you turn on Einstein, it can take a few minutes to sync Einstein and Data Cloud.

Turn on Agentforce to start building, customizing, testing, and launching AI agents.

1. From Setup, in the Quick Find box, enter Agent, and then select Agentforce Agents.
   If you don’t see Agents in Setup, verify that Einstein Generative AI is enabled for your org.
2. To enable Agentforce, turn on Agentforce.

After you enable Agentforce, refresh the page to see the New Agentforce Builder panel.

Use the standard Agentforce Service Agent template.

Aura & Ash sells skincare products and has a service agent that helps customers select, combine, and use products. Because product names frequently change, and the company wants to stay current with viral product nicknames, Aura & Ash will create a Knowledge article to map old and new product names.

1. In the New Agentforce Builder panel, click Let’s Go. To access the Agentforce Builder later, from the App Launcher, find and select Agentforce Studio, and then click Agents.
2. Click New Agent, then select Agentforce Service Agent.
3. Name your agent Aura & Ash Service Agent and accept the developer default.
4. Click Select User, then select EinsteinServiceAgent user.
5. Click Let’s Go.

The agent opens in canvas view. You can see that the Service Agent template provides typical subagents for a service agent. Leave your new agent open in a browser tab.

To ground your agent’s responses in Aura & Ash’s product information, you’ll create a data library and upload a PDF.

1. Download the Aura_Ash_Product_Instructions.pdf. This PDF provides brief usage instructions for skincare products, but uses the old product names.
2. Leave your agent open in a browser tab. From Setup, in the Quick Find box, enter Data Library, and then select Agentforce Data Library.
3. Click New Library.
4. For the library name, enter Aura and Ash Products. The API name is automatically populated.
5. For the description, enter Sources for Aura & Ash Customer Service agent’s product usage agent.
6. Save your changes.
7. In the Data Type field, select Files.
8. Click Select Files, then upload the Aura & Ash Product Instructions.pdf file from wherever you saved it on your computer. When your file is finished uploading, click Done.

Salesforce takes some time to create your data library. Wait until the Status is Ready — you might need to refresh your page.

Now that you’ve created your data library, add it to your agent.

1. From your agent’s Explorer panel, expand Data and select Data Library.
2. Select the Aura & Ash Products library. If you don’t see your library, refresh the page.
3. Leave the Show Sources setting disabled. When this setting is enabled, your agent shows the sources for every answer it generates with your data library. For the Aura & Ash use case, we’ll leave that setting disabled because we’re using a single PDF for all answers.
4. In the upper right, click Save.

Your agent is now grounded on Aura & Ash product instructions and can answer customer questions, provided customers use legacy product names.

1. Click Preview and click Refresh (circular arrow).
2. In the test window, enter this text: How do I use the Hand & Cuticle Oil.
3. The agent responds with information grounded in your library, such as massaging a few drops into your nails and allowing time for absorption.
4. Now, repeat the question with the product’s new name by entering How do I use Iron Grip Rescue Fuel?. The agent doesn’t have your product’s new name and responds that it can’t help. We’ll download the product’s old and new name map in the next step, so that the agent can find the relevant information.

Your agent is grounded on Aura & Ash’s product usage information, but your data library uses the old product names. Real-world data libraries can be large and complex to configure. It’s often much easier to provide an agent with a simple terminology map that a business user can update, rather than rewriting and rebuilding a data library.

To create a Knowledge article, set up Salesforce Knowledge, grant yourself and your agent user permissions on the knowledge__kav object, create a template, and grant the agent user access to Knowledge.

Assign your user the Knowledge user license so you can create Knowledge articles.

1. From Setup, in the Quick Find box, enter and select Users.
2. Next to your user name, click Edit.
3. Select the Knowledge User checkbox.
4. Click Save.

1. From Setup, in the Quick Find box, enter and select Knowledge Settings.
2. Select Yes, I understand the impact of enabling Salesforce Knowledge and click Enable Salesforce Lightning Knowledge, then click Ok.

You need a Knowledge article layout with a text field to hold your map of old and new product names.

1. In Setup, select Object Manager.

2. In Quick Find, enter and select Knowledge (API name Knowledge__kav).

3. Select Fields & Relationships then click New.

4. Select Text Area (Long) and click Next.

5. Enter this information:

   Field	Value
   Field Label	Alternate Product Names
   Description	New or alternate names, acronyms, and slang terms for products
   Visible lines	40
   Field Name	Accept Alternate_Product_Names__c

6. Leave all other fields the same and click Next.

7. Ensure the new field is visible to the Einstein Agent User and click Next.

8. Select the box next to Knowledge Layout and click Save.

The new field is created and added to the Knowledge page layout.

Your agent user needs read permissions on the Knowledge object,Knowledge__kav, but only when operating the Aura & Ash agent.

1. From Setup, in the Quick Find box, enter and select Permission Sets.
2. Click to open the Agentforce Agent Aura_Ash_Service_Agent Permission set.
3. Click to open Object Settings.
4. Scroll down, then click to open Knowledge, with the API name Knowledge__kav.
5. Click Edit.
6. Under Object Permissions, for Read and View all Fields, select Enabled.
7. Click Save.

You can’t give the agent user a Knowledge license, but you can grant the Allow View Knowledge app permission.

1. From Setup, in the Quick Find box, enter and select Users.
2. Click to open your EinsteinServiceAgent name.
3. Expand the list of permission set assignments, then click to open the Service User permission set.
4. Click to open App Permissions.
5. Click Edit.
6. Select Allow View Knowledge.
7. Click Save.

Your agent user has permissions to view Knowledge articles. For more information about agent user permissions, see (Help):Best Practices for Agent User Permissions.

1. Download the document Aura_Ash_New_Names.pdf. This document maps old product names to new product names.
2. From the app menu, enter and select Knowledge, then click New to create a new Knowledge document.
3. Name your document Aura & Ash Updated Product Names and accept the default URL name.
4. In the field Alternate Product Names, paste the entire contents of the Aura & Ash New Names.pdf, including the instructions.
5. Click Save.
6. Return to the list of Knowledge articles, then select and publish your article.
7. Copy your Knowledge article number - you’ll need it to create your agent action.

Your Knowledge Article is published and ready to use in a Flow.

Create a flow that looks up your knowledge article by article ID.

1. From Setup, in the Quick Find box, enter Flows, and then select Flows.
2. Click New Flow.
3. Select the Autolaunched Automations category, and then select Autolaunched Flow (No Trigger).
4. Add a Get Records Element.
   1. For the label, enter Get Knowledge Article by ID.
   2. For the object, select Knowledge (Knowledge__kav).
5. Select the knowledge record by article number
   • For the condition requirements, leave All Conditions Are Met (And) selected.
   • For the field, select Article Number.
   • For the operator, select Equals.
   • For the value, add a new resource with these values:

6. Click Done

7. Create a variable to store the new product names.

   • Under How to Store Record Data, select Choose fields and assign variables (advanced).
   • Under Where to Store Field Values, select In separate variables.
   • Under Select Variables to Store Knowledge Fields, for Field, select Alternate_Product_Names__c.
   • For Variable, create a new resource.

1. Click Done.
2. Select When no records are returned, set specified variables to null.
3. Save the flow. Use the name Alternate Product Names and accept the api name.

To test your flow and make sure your agent has all of the required permissions to run it, debug the flow as your agent user.

1. Give yourself permission to debug your flow as another user.

   • From Setup, in the Quick Find box, enter Process Automation, and then select Process Automation Settings.
   • Select Let admins debug flows as other users then click Save.

2. In Flow Builder, click Debug.

   • Select Run automation as another user, and then select your EinsteinServiceAgent User.
   • For articleNumber, enter the article number for your Aura & Ash Updated Product Names article. You saved this number in a previous step.
   • Click Run and expand Details to see the returned list of product names.

3. To activate the flow, click Activate.

Tip: If you get an error running the flow as the EinsteinServiceAgent user, switch to your user. If the flow is successful running under your user, check the EinsteinServiceAgent’s permissions.

Now that you’ve created a Knowledge article to map old and new product names, then created a flow to fetch the names, you’re ready to ground your agent with the new product names. First, you’ll create a variable to store the mapped names. Then, you’ll create an agent action based on your flow. Finally, you’ll update your agent to run the action and use the mapped names to find answers to your customer’s questions.

You’ll use the Old2NewProductNames variable to store the mapped product names that your flow returns from the Knowledge article.

1. In your agent’s Explorer panel, click Variables.
2. In the upper right of the Canvas, click New, then select Create Custom Variable.
3. Use these values to create your variable.

   Field	Value
   Name and API Name	Old2NewProductNames
   Data Type	String
   Description	Maps the old product names to the new product names.
   Default value	NotRun

4. Click Create, then save your agent.

Your Old2NewProductNames variable is created.

1. In Agentforce Builder, from the Explorer tab, expand Subagents > General FAQ.
2. Click the plus sign (+) next to General FAQ and select Create New Action.
3. Set these fields on your action.

   Field	Value
   Action Name	GetNewProductNames
   Description	Get the new names for products.

4. Click Create and Open.
5. For the reference action type, select Flow.
6. For the reference action, select your Alternate Product Names flow.
7. Under Inputs, for articleNumber, select Require Input to execute action.
8. Under Outputs, for alternateProductNames, select Show in conversation.
9. Click Save.

Run your GetNewProductNames action in the reasoning instructions, then store the output list of mapped names in the Old2NewProductNames variable. To improve performance, only run the action once by checking if the Old2NewProductNames variable is NotRun.

1. Switch to Script mode.
2. In the GeneralFaq subagent, below instructions: -> and above | Your job is solely to help with issues, paste these instructions.

1if @variables.Old2NewProductNames == "NotRun":
2      run @actions.GetNewProductNames
3         with articleNumber = "000001000"
4         set @variables.Old2NewProductNames = @outputs.alternateProductNames

3. Align the script with the pipe (“|”) character below.

4. If needed, replace 000001000 with your Knowledge article’s article number that you copied in a previous step. Your script should look like this.

5. Save the agent, then verify in Canvas view.

1. In Canvas, click your cursor after the first sentence, which says something like Your job is solely to help with issues and answer questions about the company's products, procedures, or policies by searching knowledge articles.

2. Press Enter/Return, then paste this text. Product names have changed. Customers might use a new product name in their questions. When a mentioned product is not found in the knowledge content, consult

3. Enter "@" to bring up the context menu, then scroll down to This Agent’s Variables and select Old2NewProductNames.

4. Paste this text to determine whether it maps to an older product name. If a mapping exists, use the older product name when searching knowledge articles.

5. Click Save.

Your Canvas view should look like this.

Your agent is now grounded on Aura & Ash product instructions and new product names. The agent can answer customer questions for both legacy and new product names.

1. Click Preview, then next to Set Context, click Refresh (circular arrow).
2. Enter the prompt: Tell me about the Iron Grip Rescue Fuel.
3. The agent responds with information grounded in your library for the old product name, Hand & Cuticle Oil.

You can see that your Get Alternate Product Names action is run only once.

This example’s Agent Script uses these patterns and best practices.

j

Get Started

Agentforce Examples

Apex - Custom Action Example

Agent Script - Customer Support

Agent Script - Update Agents With New Terms

Agent Script - Enforce Subagent Sequencing With Variables

Agent Script

Agentforce DX

Agentforce APIs and SDKs

Agentforce Actions

Agentforce Service Errors

Models and Prompts

Headless Agentforce Development