Gearset for Agentforce

Deploy agents your team can stand behind

Salesforce Agentforce deployments fail in ways that are hard to predict and painful to explain. Gearset surfaces issues before you deploy — not after.

Start free trial

Behind every AI agent is a web of metadata – and every piece has to land perfectly

Planners, topics, actions, prompt templates — each with dependencies on Apex, Flows, and custom objects. Miss one or deploy in the wrong order, and the whole thing fails. Gearset treats Agentforce as what it is: Salesforce metadata. The same secure deployment process your team already relies on, extended to cover everything agents need.

Get your agents to production faster without the guesswork

Gearset gives you complete visibility over what you're deploying, before a single change moves.

Find everything you need in one place

A dedicated filter retrieves all Agentforce metadata — plus the Apex and Flows they depend on.

See exactly what's changing

Gearset's visual diff presents each component clearly, so you can review every change before it goes near production.

Nothing left behind

A single missing component or incomplete Data 360 configuration can bring an entire deployment down. Gearset makes sure neither happens.

  • Catch missing dependencies before you deploy: Gearset flags what's missing and lets you fix it in one click before validation.
  • Activate agents automatically: switched on out of the box after deployment — no manual steps, no scripts to maintain.
  • Deploy Agentforce and Data 360 in one workflow: no tool-switching, no multi-step complexity.

Gearset’s expertise helps showcase our expertise, and makes deploying Agentforce smooth and stress-free. I appreciate having Gearset as a trusted partner.

Melissa Hill Dees

Salesforce MVP

Know your agents are ready before the world does

Agents that fail in front of customers are worse than no agent at all. Gearset makes sure yours are tested, handled, and ready before they ever go live.

  • Test conversations, not just commands: Agentforce Testing Center results surface directly in Gearset — review evaluation outputs and deploy without switching tools.
  • Deploy and run tests together: ship test suites alongside your agents and set them to run automatically — so nothing reaches a new environment untested.
  • Decode errors fast with dedicated docs: when Salesforce surfaces a validation error, Gearset pairs it with clear explanations so your team can self-serve a fix instantly.

Agentforce, with DevOps done right

Agents evolve constantly and as more developers touch Agentforce, the risk of something going wrong in production grows. Gearset gives every release the process it deserves — repeatable, reviewable, and built to the standards your team already works to.

Explore the full Gearset platform

Learn more about Gearset and Agentforce

DevOps Diaries

Podcast

We did it! Practical advice for implementing Agentforce

Elements.cloud's advice for building effective agents.

Salesforce Agentforce: A complete guide

Blog post

Salesforce Agentforce: A complete guide

An in-depth look into Agentforce, the technology behind it and best practices to leverage it effectively.

How to deploy Agentforce: A simple guide for effective implementation

Blog post

How to deploy Agentforce: A simple guide for effective implementation

Learn how to build an agent in Salesforce and easily deploy it alongside its dependencies using Gearset.

Agentforce FAQs

Which Agentforce metadata types does Gearset support?

Gearset supports all key Agentforce metadata types, including GenAiPlannerBundle (agents), GenAiPlugin (topics), GenAiFunction (agent actions), GenAiPromptTemplate (prompt templates), and AiEvaluationDefinition (testing centre suites). Gearset also supports Agent Scripts (AiAuthoringBundle), available from API version 65. 

Note: the SDR Agent and Sales Coach Agent must currently be configured manually in each environment as they are not supported via the Metadata API.

How does Gearset support Agent Script?

When you compare environments, Gearset visualises your Agent Script in a clear table view, with each component organised into sub-sections so you can quickly see how the agent is put together — even if someone else built it.

Agent Script is also a versioned metadata type. Rather than seeing every version as a separate row in your comparison, Gearset groups them into a single row with the active version selected by default. You can switch between versions using a dropdown selector and choose exactly which one you want to deploy. And as with every other metadata type in Gearset, dependencies are surfaced and handled as part of your deployment, so nothing gets left behind when your Agent script moves between environments.

How does Gearset handle Agentforce metadata dependencies automatically?

Gearset gives you two layers of dependency handling. Firstly, you can drill into any Agentforce component to see its full dependency tree — every Prompt Template, Flow, Apex class, Topic, and Action it relies on. Then before deployment, Gearset’s Problem Analyser inspects your package and flags anything missing across both planner bundles and agent scripts, so nothing gets left behind.

Gearset also catches the subtler issues that cause silent failures: Prompt Templates referencing deprecated LLMs are flagged with a recommended alternative, org-specific retriever IDs are detected and swapped for the correct version in the target environment, and if a deployment would overwrite an already-committed agent script, Gearset flags it and offers to deploy it as a new draft instead.

Our documentation maps known error messages to their root causes so teams can fix problems quickly.

How does Gearset help me resolve Agentforce validation errors?

Gearset’s Problem Analyser catches the most common issues before validation runs, flagging missing dependencies so you can fix them in one click rather than discovering them mid-deployment.

That matters because Salesforce’s own Agentforce validation errors are often vague and don’t tell you which specific dependency is missing. Common causes include missing GenAiFunction or GenAiPlugin components in the target org, supporting metadata (like Apex classes or custom objects) not yet deployed, or Retrievers that don’t yet exist in the target environment. That last one catches many teams off guard. If your agent references a Retriever that hasn’t been deployed, validation will fail.

Gearset also makes it straightforward to deploy individual Retrievers via Direct Deploy, resolving this before it becomes a blocker. And for any errors that do slip through, our documentation maps validation messages to their root causes so your team can self-serve a fix quickly.

Can I deploy Agentforce from sandbox to production using Gearset?

Yes. Gearset supports Agentforce deployments between any two Salesforce environments — sandbox to sandbox, sandbox to production, or production to sandbox — using the same comparison and deployment workflow you’d use for any other metadata.

For teams ready to automate, Agentforce metadata can also be included in Gearset’s CI/CD pipelines, promoting agent changes through development, staging, and production with consistency. This matters more for agents than for most Salesforce changes. Because agents interact with customers directly and in real time, anything that hasn’t been properly validated, tested, and reviewed can have an immediate and visible impact. A structured promotion pipeline is the best way to know your agents work as expected before they ever reach a customer.

How does Gearset integrate with Agentforce Testing Center?

Agentforce Testing Center is a Salesforce sandbox environment tool for evaluating AI agent behaviour before changes reach production. Gearset Pipelines integrates with it and triggers tests automatically. Whenever a pull request contains Agentforce metadata, the relevant test suites run after deployment, and the results surface on the next PR downstream, so you see how your agents performed in one environment before promoting to the next. If tests fail, promotion is blocked until the failure is resolved or dismissed.

You can also deploy the test suites themselves through Gearset, so test coverage moves through environments alongside the agents it covers. And because Testing Center tests are only as good as the data in the sandbox they run against, Gearset’s sandbox seeding tool can populate dev and QA environments with realistic accounts, contacts, and case histories.

Do I need any additional tools or licences to deploy Agentforce with Gearset?

No. Everything is handled natively within Gearset. No additional tools, no automation scripts, and no extra licences are required. Gearset works at the metadata and API level, so manual steps are eliminated entirely rather than automated through fragile UI scripting.

Does Gearset support Data 360 deployments alongside Agentforce?

Yes. Businesses getting the most from Agentforce typically run Data 360 alongside it. Gearset supports deployments of both, so teams can manage changes to agents and Data 360 configuration in a single, seamless workflow, rather than maintaining two separate processes.

How does Gearset support security and compliance requirements for Agentforce deployments?

Gearset works entirely at the metadata and API level — the same way Salesforce itself manages deployments. There are no UI scripts to set up in your org, no automation touching live customer data, and no black-box processes. Every change is visible, reviewed, and logged before it’s deployed, giving your security and compliance teams full auditability over what changed, when, and by whom. Learn more about Gearset’s security.

What API version do I need to deploy Agentforce with Gearset?

API version requirements vary depending on the Agentforce metadata types you’re working with. Agentforce (GenAi) metadata types were introduced in API version 60, but some types require higher versions. You don’t need to track this manually — Gearset detects the API version you’re using and flags it if you’re on the wrong one for the metadata in your deployment. For the full breakdown and guidance on how to set your API version in Gearset, see our documentation.

Can I deploy Agentforce changes without taking my agent offline?

Yes. Gearset will automatically reactivate the new agent version immediately after the deployment stage completes, so your agent doesn’t have to be taken offline. You stay in control of which version goes live: you select the specific version to deploy, along with the relevant test suites, and that’s the one Gearset activates on the other side.

Deploy your agents faster with the confidence they deserve

Join 300+ teams who've made Agentforce a production-ready reality. Book a demo and we'll show you how it works with your setup.

Start free trial