Agentforce Bot Upgrade
Use this skill to Upgrade Einstein Bots into Agentforce agents end-to-end in a single...
Install
npx skills add forcedotcom/sf-skills --skill agentforce-bot-upgrade -g -a claude-code -y- Repository
- forcedotcom/sf-skills1.1k
- Category
- Testing
- Updated
- 5d ago
- License
- Apache-2.0
- Context cost
- Mediumabout 3,000 tokens
- Runs scripts
- No, instructions only
What it does
Use this skill to Upgrade Einstein Bots into Agentforce agents end-to-end in a single pass, orchestrating per-bot Agent Spec generation, planner reconciliation across bots, agentforce-generate authoring, and post-conversion .agent enhancements. TRIGGER when: user asks to migrate, upgrade, or convert one or more Einstein Bots (BotDefinition/BotVersion chatbots) to Agentforce agents; runs a multi-bot bot-to-agent upgrade; needs Einstein Bot metadata turned into Agent Spec handoffs and generated .agent agents; convert bots to agents; upgrade my service bots; move bots to Agentforce. DO NOT TRIGGER when: user already has an approved Agent Spec and only wants direct .agent authoring, deploy, test, or observe flows; user wants to migrate or upgrade an EXISTING Agentforce agent from a legacy GenAiPlannerBundle to an NGA aiAuthoringBundle (that is agentforce-generate's 'Migrate a Legacy Agent to Agent Script' flow, not an Einstein Bot upgrade); the request is unrelated to Einstein Bot migration.
Einstein Bot Upgrade Orchestrator
Purpose
Run a multi-bot upgrade-and-handoff cycle:
- Parse and validate bot/version pairs from
--bots - Follow Generate Agent Spec Reference per bot-version pair (parallelizable)
- Aggregation step that requires all generated Agent Specs
/agentforce-generateper Agent Spec (parallelizable)- Post-conversion enhancement pass per generated Agent Script (parallelizable)
Scope, this skill only converts Einstein Bots (BotDefinition/BotVersion chatbots) into new Agentforce agents. It does NOT migrate an existing Agentforce agent from a legacy GenAiPlannerBundle to an NGA aiAuthoringBundle, for that, use the agentforce-generate skill's "Migrate a Legacy Agent to Agent Script" flow.
Inputs
Inputs:
--mode <online|offline>is optional; default isonlinewhen omitted.- If
mode=online, required:--org-alias <org-alias>--bots <bot1:v1,bot2:v2,...>
- If
mode=offline, required:--offline-dir <offline-dir>
--interactive <true|false>is optional; default istruewhen omitted.
If required inputs are missing, handle per the Missing Input Handling and Interactive Mode rules below.
Interactive Mode
--interactive controls whether the skill pauses for user input during execution:
