--- schema_version: "1" id: 29022a989c7aefa146e66f7e71b3f7195ee405b8c27ca30b87b0de65dd15bce1 title: Get to Know Prompt Builder collection: admin version: current locale: en-us portal_url: https://docs.salesforce.com/admin/current/en-us/ai/264-0-0/prompt_builder_get_to_know.md canonical_url: https://help.salesforce.com/s/articleView?id=ai.prompt_builder_get_to_know.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: e2a49af47d7498571b310e2509aef29972d529456bcdf94372f991b160e92d43 description: Prompt Builder features a guided, visual layout that takes you through each stage of your prompt’s lifecycle, from creation, to testing, and activation. products: - Agentforce - Cross Cloud release: "264" --- # Get to Know Prompt Builder Prompt Builder features a guided, visual layout that takes you through each stage of your prompt’s lifecycle, from creation, to testing, and activation. ### Required Editions

Available in: Lightning Experience

Available in: Enterprise, Performance, and Unlimited Editions with the Einstein for Platform, or Einstein or Agentforce for Sales or Service add-on, or Agentforce Foundations

## Navigate the Prompt Builder UI Prompt Builder features a guided, visual layout that takes you through each stage of your prompt’s lifecycle, from creation, to testing, and activation. The intuitive design helps you understand how a prompt is constructed and how it performs at each step. ![Prompt Builder Workspace with all of the sections expanded Prompt (1), Preview and Template Settings (2), Resolved Prompt (3), Generated Response (4), and Save, Activate and Delete Panel (5).](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/generative_ai/images/prompt_builder_intro_ui_v2.png) ## Build Your Prompt Template (1) Craft your prompt template by using merge fields to personalize responses based on real org data.

Prompt Section displaying a prompt with multiple merge fields.

- Type an @ symbol or select **Insert Resources** in the Prompt section to search for and insert merge fields. Adding resources ensures that your prompts are grounded in org data and generate relevant responses. - Select Copy ( ![Copy Icon](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/generative_ai/images/prompt_builder_gtk_copyIcon.png)) to quickly copy the prompt to your clipboard. The copy icon is also available in the Resolved Prompt and Response sections to easily reuse content. ## Template and Preview Settings (2) Take control of how your prompt behaves with the Template and Preview Settings.

**Template Settings** - View your template type (1). - Edit the prompt template name and description after drafting (1). - View the inputs required by this prompt template. For example, the Sales Email prompt template uses primary and related objects, while Flex templates use different inputs based on the use case (1). - Select and test LLM models with your prompt template. Quickly access the accepted file types and sizes and the exclusion process if a file exceeds the limits (2). - Select the allowed languages that the LLM can use to generate your prompt’s response when the outputLanguage parameter is specified during template invocation. See [Supported Languages in Prompt Template Responses](https://help.salesforce.com/s/articleView?id=ai.prompt_builder_localize_responses.htm&release=264.0.0&type=5 "A prompt template can use any language that Prompt Builder offers. Supported languages are optimized for business-appropriate phrasing and are integrated with the Einstein Trust Layer to use its data masking and toxicity scoring features.") (3).

**Preview Settings** - Select sample data to preview how your prompt’s output appears in production (1). - When Generate Response is off, only the resolved prompt displays. The prompt isn’t sent to the LLM, and no response is generated. Customize what’s visible in the Step-by-Step Layout (2). - Show or hide the prompt. - Show or hide the Resolved Prompt. - Focus only on the response for a clean preview output. ## Review the Resolved Prompt (3) In the Resolved Prompt section, you can view how test inputs are merged into your prompt template. This version of the prompt template represents what is sent to the LLM, with actual org data applied. - Verify that all merge fields are correctly resolved. - Ensure that the structure of the prompt is clear and complete. - Use Copy ( ![Copy Icon](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/generative_ai/images/prompt_builder_gtk_copyIcon.png)) to quickly add the resolved prompt to your clipboard. **Data Trust and Masking** ![Screenshot of the Resolved Prompt Section showing a prompt with the sensitive data masked with placeholder text](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/generative_ai/images/prompt_builder_gtk_resolved_prompt.png) If your prompt template includes sensitive data, it’s automatically replaced with a placeholder in angle brackets before being sent to the LLM. For example, . The Einstein Trust Layer masks sensitive values to protect customer information. When the response is returned, the original values are automatically reinserted and displayed in italics in the Response section. To turn on masking and verify that it’s configured properly, go to the [Einstein Trust Layer Settings](https://help.salesforce.com/s/articleView?id=ai.generative_ai_mask_select.htm&type=5&language=en_US) in Setup. ## Preview the LLM Response (4) The Response section displays the final output generated by the LLM based on your resolved prompt. This preview shows exactly what a customer or user sees, helping you to evaluate the clarity, tone, and accuracy of the response. ![Screenshot of the Response Section showing the response from the selected LLM with the sensitive data restored. A zoomed-in view of the icons displayed in the response section.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/generative_ai/images/prompt_builder_response_example.png) Use the icons at the top of the Response section to gain deeper insights and take action. - View Masking Details: Click the shield (![Shield icon](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/generative_ai/images/prompt_builder_gtk_shieldIcon.png)) to view which placeholders were used for sensitive org data and how that data was masked before the prompt was sent to the LLM. The placeholders are replaced with real data after the response is received so that you can inspect what was protected and how it maps to the final output. - Toxicity Warning: If applicable, a numeric value indicating the number of warnings in the response is shown next to the triangle, ![Warning icon with the number 0](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/generative_ai/images/prompt_builder_gtk_warning_icon.png). - Copy Response: Select the Copy ( ![Copy Icon](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/generative_ai/images/prompt_builder_gtk_copyIcon.png)) to quickly copy the generated response to your clipboard. If the response includes rich text, the format that's copied is JSON. ## Save, Activate, and Delete (5) When you’re ready, use the Save, Activate, and Delete panel to: - Save your prompt template as a draft. - Activate the prompt template to make it available for use across your org. - Delete a template that isn't currently in use. If the template is in use, remove the references before deactivating or deleting it. ## Put Prompts to Work in Salesforce After activation, your users can benefit from prompt templates directly within Salesforce apps like Sales Emails and Lightning record pages. To see how users interact with prompts, see [How Users Work with a Prompt Template](https://help.salesforce.com/s/articleView?id=ai.prompt_builder_how_users_work_with_templates.htm&release=264.0.0&type=5 "As a Salesforce administrator, you configure prompt templates to make tasks easier for your users. This section explains how your users can apply these prompt templates to write emails, generate case summaries, complete text form fields, and more."). ## Key Tasks in Prompt Builder - [Create a Prompt Template](https://help.salesforce.com/s/articleView?id=ai.prompt_builder_build_template.htm&release=264.0.0&type=5 "Select the type of prompt template to create based on your use case. Based on the template type, define the resources available for the template.") - [Ground Prompt Templates with Salesforce Resources](https://help.salesforce.com/s/articleView?id=ai.prompt_builder_ground_template.htm&release=264.0.0&type=5 "With Prompt Builder, you can dynamically ground prompt templates with CRM data using merge fields.") - [Change LLM Configurations in Prompt Templates](https://help.salesforce.com/s/articleView?id=ai.prompt_builder_changing_llm_configurations.htm&release=264.0.0&type=5 "Select and optionally modify an LLM configuration for generating outputs in Prompt Builder.") - [Enabling Resolution to Review a Prompt Template](https://help.salesforce.com/s/articleView?id=ai.prompt_builder_enable_resolution.htm&release=264.0.0&type=5 "When you enable resolution, you can review the resolved prompt that’s generated from your prompt template. Through a process called prompt resolution, Prompt Builder replaces each merge field in the prompt template with real CRM data related to the records that you selected.") - [Evaluate the Quality of a Response](https://help.salesforce.com/s/articleView?id=ai.prompt_builder_evaluate_response.htm&release=264.0.0&type=5 "When you preview a generated response, evaluate how well the response meets the goals of the prompt. Make sure that the response is factually accurate and doesn’t contain harmful content or bias.") - [Activate and Deactivate Prompt Templates](https://help.salesforce.com/s/articleView?id=ai.prompt_builder_activate_deactivate_templates.htm&release=264.0.0&type=5 "Use activation and deactivation of prompt templates to finely control which version your users can access.") #### See Also - [_Video_: Get to Know Prompt Builder](https://salesforce.vidyard.com/watch/kJPBHFRvvTpjJZ51Y4hj3A) - [Troubleshoot Prompt Builder](https://help.salesforce.com/s/articleView?id=ai.prompt_builder_troubleshoot.htm&release=264.0.0&type=5 "Solve common prompt template issues.")