Agentforce Metadata Types (v68 and Later)
To manage agents, agent actions, and subagents, use the Metadata API.
Agent metadata changed in v68. To learn more, see Move an Agent to a New Org.
- AiAuthoringBundle: Represents an AI authoring bundle, which contains the blueprint of an agent. For example, an AI authoring bundle for an Agentforce agent contains:
- An Agent Script file, stored in
<bundle-api-name>.agent - A Metadata API XML file, stored in
<bundle-api-name>.bundle-meta.xml
- An Agent Script file, stored in
- AiAgentDefinition: Represents the definition of an Agentforce agent, including its type, context variables, and conversation settings.
- AiAgentDefinitionVersion: Represents a version of an Agentforce agent definition, including its dialogs, conversation variables, planner configuration, and behavior settings.
- GenAiFunction: Represents an action that you can add to agents.
- GenAiPlugin: Represents an agent’s subagent.
In v68 and later releases, these metadata types are no longer used to represent Agentforce agents:
- Bot and BotVersion: Used only by Einstein Bots, not by Agentforce agents.
- GenAiPlannerBundle: Doesn’t exist in v68 and later releases.
- Agentforce DX: Manage agents by using pro-code tools.
- Move an Agent to a New Org: Use Salesforce DX and agent metadata to move your agent to a new org.