---
schema_version: "1"
id: 0f563bda3171c90b10c17f6ec26a0fe9617a2efb28fde8e1c29ea1bfed5989fa
title: Agentforce Metadata Types (v67 and Earlier)
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/genai/agentforce/references/agents-metadata-tooling/agents-metadatav67.md
canonical_url: https://developer.salesforce.com/docs/ai/agentforce/references/agents-metadata-tooling/agents-metadatav67.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 303f0f43c4bb3e0e587a7a9fb14a5ed4c1d5b7426499796a31121151a4b39d80
products:
  - Agentforce Developer Guide
  - Agentforce and Einstein Generative AI
---
# Agentforce Metadata Types (v67 and Earlier)

Manage actions and customize the planner service using the [Metadata API](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_intro.htm).

**important:** Agent metadata changed in v68. To learn more, see [Move an Agent to a New Org](/docs/ai/agentforce/guide/agent-dx-deploy-metadata.html).

![Agent metadata hierarchy](https://developer.salesforce.com/docs/media/bot-agent-metadata.png '{"class": "image-md"}')

## Metadata Types

- [AiAuthoringBundle](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_aiauthoringbundle.htm): 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](/docs/ai/agentforce/guide/agent-script.html) file stored in `<bundle-api-name>.agent`
  - the Metadata API XML, stored in `<bundle-api-name>.bundle-meta.xml`

  To commit an agent version, the `target` field must specify the `developerName` for the [Bot](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_bot.htm) and [BotVersion](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_botversion.htm) components, separated by a period: `{Bot}.{BotVersion}`. For example, `Agentforce_Service_Agent.v2`. These two components tie the AI authoring bundle to a specific agent and a specific agent version.

- [Bot](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_bot.htm): The top-level representation of an [Einstein Bot](https://help.salesforce.com/s/articleView?id=service.bots_service_whats_a_bot.htm&type=5) or an [Agentforce Agent](https://help.salesforce.com/s/articleView?id=ai.copilot_overview.htm&type=5).
  - `localMlDomain.name`: Agent name.
  - `type`: Agent type.
  - `description`: Agent description.
  - [`ConversationContextVariable`](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_bot.htm#ConversationContextVariable): A context variable local to the current bot or agent version.
- [BotVersion](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_botversion.htm): A BotVersion represents the configuration for a specific bot or agent version. A single Einstein Bot or Agentforce Agent can have many versions, but only one version can be active.
  - [ConversationVariable](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_botversion.htm#ConversationVariable): A container that stores a specific piece of data collected from the customer. You can use variables within actions as both inputs and outputs.
- [GenAiFunction](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_genaifunction.htm): Represents an action that can be added to agents. Action input and output variables are located in `schema.json` for each action's input and output folders, or in `schema.json` in the `localActions` folder of `genAIPlannerBundle`.
- [GenAiPlannerBundle](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_genaiplannerbundle.htm) represents a planner for an agent or agent template. It’s a container for all the subagents and actions used to interact with a large language model (LLM). An agent has a single GenAiPlannerBundle component. A `GenAIPlannerBundle` file contains the Agentforce Builder Subagent Map for a specific agent.
  - `GenAiPluginInstructionDef`: Subagent instructions.
- [GenAiPlugin](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_genaiplugin.htm): Represents a subagent, which is a category of actions related to a particular job to be done by the agent. An agent can have multiple GenAiPlugin components.
  - `developerName`: Subagent API name.

## See Also

- [Agentforce DX](/docs/ai/agentforce/guide/agent-dx.html) for instructions on how to manage agents using pro-code tools.
- [Define Agent Metadata (v67 and Earlier)](/docs/ai/agentforce/guide/agent-dx-api-v67-earlier.html) for instructions on how to use Salesforce DX and agent metadata to move your agent to a new org