Uninstalling Agentforce Beta Packages

This guide provides specific instructions for administrators on how to remove beta (test) versions of Agentforce packages. Beta packages in Salesforce are intended for internal testing only and are not upgradable; you must uninstall an old version before installing a new one.

Before You Begin: Prerequisite

To successfully uninstall the packages, the administrator performing the action must have the “Prompt Template Manager” permission set assigned. The uninstallation will fail without this permission.

How to Uninstall the Industry Unlocked Package (Beta)

Follow these steps to remove the industry-specific unlocked package.

  1. Deactivate the Agent. This can be done in Agentbuilder.

  2. Remove all custom topics from the agent.

  3. After the topics are removed, you can proceed with uninstalling the unlocked package.

How to Uninstall the Actions Package (Beta)

The Actions package can only be uninstalled after any packages that depend on it, such as the Industry Unlocked Package, have been removed.

  1. Ensure you have already uninstalled any unlocked packages that depend on the Actions Package Beta.

  2. Deactivate the Flows that were included in the package.

  3. Once the flows are inactive, you can uninstall the Actions Unlocked Package.

How to Resolve Common Issues When Uninstalling Agetforce Packages (Beta)

This section helps you resolve common issues that may occur when uninstalling Agentforce beta packages.

  • Problem: The package uninstallation fails or gives a permissions error.
    • Solution: The user performing the uninstall must have the “Prompt Template Manager” permission set assigned; otherwise, the process will fail.
  • Problem: You cannot uninstall the Actions Package.
    • Solution: You must first uninstall any unlocked packages that depend on the Actions Package, such as the industry-specific package.
  • Problem: You receive an error that a component is still in use.
    • Solution: Before attempting to uninstall, ensure you have completed all prerequisite steps, such as deactivating the agent , removing all custom topics from the agent , and deactivating the flows included in the package.

FAQ

This section answers frequently asked questions about uninstalling Agentforce beta packages.

Q: Why can't I just upgrade my beta package?

A: Beta packages in Salesforce are not upgradable and are intended for internal testing only. You must uninstall the current version before you can install a new one.

Q: Is there a specific order for uninstalling the packages?

A: Yes. You must uninstall the industry-specific unlocked package first. The Actions Package can only be uninstalled after any packages that depend on it have been removed.