Newer Version Available

This content describes an older version of this product. View Latest

Get Access to Scratch Orgs That Have Agentforce

Agentforce is a set of tools to create and customize AI agents that are deeply and securely integrated with customers' data and apps. Agentforce brings together humans with agents to transform the way work gets done. Start your journey with Agentforce by testing it in a scratch org.

If you don’t already have a Partner Business Org (PBO), join the Salesforce Partner Community and request a PBO.

If you’re new to creating scratch orgs, follow these steps to complete the one-time Dev Hub setup in your PBO. The Dev Hub is a feature within an org that lets you create and manage scratch orgs, second-generation managed packages (2GP), and namespaces.

As of September 16, 2024, all active Partner PBOs can create scratch orgs with Agentforce and Prompt Builder. Agentforce and Prompt Builder can be enabled for scratch orgs that are associated with a Dev Hub in a PBO.

Partners with active PBO orgs Enabled as of September 16, 2024
New PBO orgs (Trial or Active) Automatically enabled when created

To create a scratch org with Agentforce and Prompt Builder enabled, use this sample project-scratch-def.json file (or simply add the feature and setting shown in this sample to your existing scratch org definition file).

1{
2  "orgName": "GenAI Scratch Org",
3  "edition": "Partner Developer",
4  "features": ["Einstein1AIPlatform"],
5  "settings": {
6    "einsteinGptSettings" : {
7      "enableEinsteinGptPlatform" : true
8    }
9  }
10}

To create a scratch org with the Einstein1AIPlatform feature, the scratch org you create must be a Partner Developer edition.

To create a scratch org, run this Salesforce CLI command. Update the definition-file name, alias, and target-dev-hub alias as needed.

1sf org create scratch --definition-file config/my-agentforce-project-scratch-def.json --alias MyScratchOrg --set-default --target-dev-hub MyHub

Scratch Orgs with both Agentforce and Data Cloud

For some use cases such as prompt templates that use RAG, Retrievers, and BYO LLM, a scratch org that has both GenAI and Data Cloud functionality enabled is required.

Only include Data Cloud if it’s required. Specifying Data Cloud in a scratch org significantly increases the time it takes for a scratch org creation to complete.

Including Data Cloud in a scratch org has a prerequisite. You must first open a case in the Salesforce Partner Community to request for your PBO Dev Hub org to be granted permission to create Data Cloud scratch orgs. This request is only granted to PBO orgs.

Note

1{
2  "orgName": "GenAI & Data Cloud Scratch Org",
3  "edition": "Partner Developer",
4  "features": ["CustomerDataPlatform", "CustomerDataPlatformLite","Einstein1AIPlatform"],
5  "settings": {
6    "einsteinGptSettings" : {
7      "enableEinsteinGptPlatform" : true
8    }
9    "customerDataPlatformSettings": {
10      "enableCustomerDataPlatform": true
11    }
12  }
13}

Set up Agentforce in your Scratch Org

After your scratch org is created, follow these steps to start developing with Agentforce.