--- schema_version: "1" id: 0dcb51ac3ffd272a7036d67d1b4afbaf30daed501af61f41f9e75e66ade39e33 title: Agentforce Builder Considerations collection: admin version: current locale: en-us portal_url: https://docs.salesforce.com/admin/current/en-us/ai/264-0-0/agent_considerations.md canonical_url: https://help.salesforce.com/s/articleView?id=ai.agent_considerations.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: a1d718b6ac119e93897b9343bfd41fbaaac68d1384eae14194d668383342c0d9 description: Carefully review the current considerations and limitations for the new Agentforce Builder. products: - Agentforce - Cross Cloud release: "264" --- # 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. Instead, [upgrade your agent from the legacy builder to the new builder](https://help.salesforce.com/s/articleView?id=ai.agent_setup_create_upgrade.htm&release=264.0.0&type=5 "Create a new version of an agent from the legacy Agentforce Builder in Setup in the new Agentforce Builder in Agentforce Studio, with just a few clicks. The new version contains all of the original agent's subagents, actions, system messages and settings, data, and connections, converted to Agent Script. Upgrading an agent doesn't affect the original agent in the legacy builder. You can continue to access and edit the agent in the legacy builder."). - 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 compatible builder. In the Setup page list view and the legacy builder, only committed versions of agents created in the new builder are visible. - For agents created before the week of August 3, 2026, a single agent version can have different numbering between the legacy and new builders because of metadata differences. In the legacy builder, draft versions can appear to be skipped. For example, you have two versions of an agent in the new builder. Version 1 is committed and Version 2 is a draft. In the Agentforce Agents Setup page list view, only Version 1 is visible. In the new builder, you create and commit a new version. In the new builder, the new version appears as Version 3. In the legacy builder, the draft version is skipped, so the new version appears as Version 2. - Some features are only available in Script view. For details about these features and Agent Script, see [Agent Script](https://developer.salesforce.com/docs/ai/agentforce/guide/agent-script.html). - [Customizing an agent action's input or output with a custom Lightning type](https://developer.salesforce.com/docs/ai/agentforce/guide/lightning-types.html) isn't supported in Canvas view. As a workaround, [create a custom action from the asset library](https://help.salesforce.com/s/articleView?id=ai.agent_actions_custom.htm&release=264.0.0&type=5 "Create a custom action in the asset library to make your action available to multiple agents, versions, and subagents. Then add it to one or more agents."), edit the Input Rendering or Output Rendering parameter, and then [add the action to a subagent in Agentforce Builder](https://help.salesforce.com/s/articleView?id=ai.agent_actions_add_asset_library.htm&release=264.0.0&type=5 "Add standard actions to your agent to start handling common business use cases quickly, or create custom actions tailored to your business needs. When you add these actions to an agent, the agent gets its own, independent copy. Changes to template actions within the asset library aren't automatically synced to subagents and actions within your agent. Changes made to one agent's actions don't affect another agent's subagents or actions."). - You can't select a search provider for the [Search the Web agent action](https://help.salesforce.com/s/articleView?id=ai.copilot_actions_ref_search_the_web.htm&release=264.0.0&type=5 "Retrieves real-time or external information that isn’t available in Salesforce CRM. Use it for questions about news, market trends, competitor details, and product comparisons, or when Salesforce answers need added context from the web.") in Canvas view. As a workaround, add an action input that stores the provider name. - Editing the fields of an agent action in Canvas view can cause validation issues. A fix is on the way. In the meantime, modify any fields or parameters for your action[in the action definition in the associated Subagent block](https://developer.salesforce.com/docs/ai/agentforce/guide/ascript-blocks.html#subagent-blocks) in Script View. If you prefer a form-based fix, you can create or edit an action in the asset library and add the action to your agent. - 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 supported for Agentforce Employee agents and Agentforce Service agents. Service agents must have an Enhanced Chat v2 connection, and you must select the Enhanced Chat v2 connection from the Preview Mode dropdown in the Agentforce Builder Preview panel. - To preview CLTs for an agent, start a preview conversation in live test mode. - Agents can be in draft or committed states. - When you use the render nested inline action in an agent action, these considerations apply. - The render nested inline action tells the agent to send the agent action's full output. For example, if a user asks for two places to visit and the agent calls an agent action that returns a list of ten places to visit, the render nested inline action tells the agent to show the list of ten places. To customize what's shown, edit the agent action's inputs or the subagent's Actions Available For Reasoning section. - Currently, you can't add the render nested inline action to an MCP tool action. - Currently, the render nested inline action isn't supported with multi-agent orchestration. - Starting in May 2026, Salesforce adds `wss://*.livekit.cloud` and `https://*.livekit.cloud` to your [Trusted URLs](https://help.salesforce.com/s/articleView?id=xcloud.security_trusted_urls_manage.htm&language=en_US) 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. - When you create an agent from a template or add a standard subagent or action to your agent, the agent metadata, subagents, and actions are copied to your agent. To protect your deployed agents and customizations, changes made to standard assets in the asset library aren't automatically applied to the agents that use them. To get changes to an agent template, create a new agent from the template and recreate any customizations. To get changes to a standard subagent or action, add the subagent or action to your agent from the asset library and recreate any customizations.