Mastering Agentforce: The Power of Agent Script

Hi,

In the rapidly evolving world of AI, the challenge for developers has always been balancing the creative reasoning of Large Language Models (LLMs) with the rigid predictability required by enterprise business logic. Salesforce has bridged this gap with Agent Script, the foundational language for building intelligent agents in the new Agentforce Builder.

Whether you are a "low-code" admin or a "pro-code" developer, understanding Agent Script is the key to moving beyond simple chatbots to sophisticated, autonomous agents. 

What is Agent Script?

Agent Script is a hybrid language designed specifically for Agentforce. It combines natural language instructions with programmatic expressions. Think of it as a way to give your AI "guardrails" and "blueprints."

While an LLM can figure out what a user wants, Agent Script ensures the agent follows how your business requires that task to be handled. It allows you to define:

• Predictable Workflows: Control exactly when an agent moves from one topic (now called Subagents) to another
• Deterministic Logic: Use if/else conditions to handle business rules (e.g., "If a customer is Gold tier, offer a 20% discount").
• State Management: Use variables to store data reliably rather than hoping the LLM "remembers" it in the conversation history.

The Best of Both Worlds: Reasoning vs. Determinism

The standout feature of Agent Script is its ability to toggle between LLM reasoning and hardcoded logic.

• Reasoning Instructions: You can define areas where the LLM has the freedom to reason through a user's request.

• Action Chaining: You can programmatically sequence actions so they happen in a specific order every single time, regardless of how the user phrases their request.

Three Ways to Build

Salesforce has made Agent Script accessible regardless of your technical background:

1. The Conversational Approach: You can literally chat with Agentforce. Tell it, "If the order total is over $100, offer free shipping," and the builder will automatically generate the underlying Agent Script, actions, and instructions for you.
2. The Canvas View: For those who prefer a visual interface, the Canvas summarizes script into "blocks." You can use shortcuts like / to add logic patterns or @ to reference resources like variables and subagents.
3. The Script View (Pro-Code): Advanced developers can switch to a full IDE-like experience within Salesforce or use the Agentforce DX extension for Visual Studio Code. This supports syntax highlighting, autocompletion, and version control via Salesforce DX projects.

A Look at the Syntax

Agent Script is designed to be readable. A common pattern involves using reasoning instructions combined with conditional logic. For example:

// Example of a simple transition logic

if (customer.is_vip) {

    -> transition(VIP_Support_Subagent)

} else {

    | "Ask the customer how we can help them today."

}

In this snippet, the "->" indicates a deterministic transition, while the "|" provides a natural language prompt for the LLM to execute.

Example Agent Script:

system:

    instructions: "You are a friendly and empathetic agent that helps customers with their questions."

    messages:

        error: "Sorry, something went wrong."

        welcome: "Hello! How are you feeling today?"

config:

    agent_name: "HelloWorldBot"

    default_agent_user: "hello@world.com"

language:

    default_locale: "en_US"

    additional_locales: ""

variables:

    isPremiumUser: mutable boolean = False

        description: "Indicates whether the user is a premium user."

start_agent hello_world:

    description: "Respond to the user."

    reasoning:

        instructions: ->

            if @variables.isPremiumUser:

                | ask the user if they want to redeem their Premium points

            else:

                | ask the user if they want to upgrade to Premium service

Why It Matters for Developers

The shift from "Agent Topics" to Subagents (effective April 2026) signals Salesforce’s commitment to modular, scalable AI. By using Agent Script, you aren't just building a one-off bot; you are building a library of skills and subagents that can be reused across your entire enterprise.

With the ability to manage scripts locally in VS Code and deploy them via standard CI/CD pipelines, Agentforce brings AI development into the modern DevOps lifecycle.

Reference:

https://developer.salesforce.com/docs/ai/agentforce/guide/agent-script.html