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.

Enable the Dev Hub and 2GP
Create a Developer Edition org using Environment Hub
Create a namespace in the Developer Edition org
Link that namespace from your PBO. Linking the namespace lets you create 2GP packages that use that namespace.
Authorize the Dev Hub org.
Create a Salesforce DX Project.

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 can be a Partner Developer, Partner Enterprise, Developer, or Enterprise 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 MyNamespacedScratchOrg --set-default --target-dev-hub MyDevHubOrg

Scratch Orgs with both Agentforce and Data Cloud

For some use cases such as prompt templates that use RAG, Retrievers, or 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.

Create Agents manually in the scratch org.
To use prompt templates with your Agent Actions, assign prompt template permissions.

See Also