Agentforce Builder Considerations
Carefully review the current considerations and limitations for the new Agentforce Builder.
Required Editions
| Available in: Lightning Experience |
| Available in: Enterprise, Performance, Unlimited, and Developer Editions. Required add-on licenses vary by agent type. |
- Agent actions trigger billing when they run, whether they run deterministically (for example, in reasoning instructions) or during agent reasoning with an LLM. Utilities such as escalations to a representative, setting variables, or transitions to another subagent don't incur billing as agent actions.
- You can’t modify agents that you created in the legacy Agentforce Builder in the new builder. As a workaround, create a similar agent in the new builder. Then, copy and paste important fields from the original agent, such as system messages, and add the same subagents and actions. We recommend exploring the new builder’s features, such as the logical expressions available with Agent Script. Do this before adding the subagent instructions from your original agent.
- Agents created in both the new Agentforce Builder and the legacy builder are available in the Agents list in Agentforce Studio and in the Agentforce Agents Setup page list view. Clicking the agent name opens it in the builder in which it was created.
- Agents can only use the Messaging connection, Enhanced Chat v2 connection, and Service Email connection. Salesforce plans to support more connections.
- Agentforce Employee agents created in Agentforce Builder support configuring conversation recommendations.
- Some features are only available in Script view. For details about these
features and Agent Script, see Agent Script.
- The after_reasoning block is Agent Script-only and isn't supported in Canvas view.
- Customizing an agent action's input or output with a custom Lightning type isn't supported in Canvas view. As a workaround, create a custom action from the asset library, edit the Input Rendering or Output Rendering parameter, and then add the action to a subagent in Agentforce Builder.
- You can't select a search provider for the Search the Web agent action in Canvas view. As a workaround, add an action input that stores the provider name.
- When Agent Script can't compile, the Canvas view underlines the code that produces the error in red. Switch to Script view for more details and to fix the error. It's possible to make invalid changes in the Script view that make the Canvas view unavailable. To switch back to the Canvas view, fix the errors in the Script view.
- When previewing custom Lightning types (CLTs) in Agentforce Builder, these
considerations apply.
- Preview for CLTs is currently supported only for actions added from the asset library. To preview CLTs for actions created or customized in Agentforce Builder, recreate the actions in the asset library, and then add them to your agent.
- Preview for CLTs is supported for Agentforce Employee agents and Agentforce Service agents. Service agents must have an Enhanced Chat v2 connection. Agents can be in draft or committed states.
- To preview CLTs for an agent, start a preview conversation in live test mode.
- Starting in May 2026, Salesforce adds
wss://*.livekit.cloudandhttps://*.livekit.cloudto your Trusted URLs when you create an agent or when you open an existing agent in Agentforce Builder. These URLs are added so that you can preview and deploy voice agents.
Did this article solve your issue?
Let us know so we can improve!
