# Agentforce Bot Upgrade

Use this skill to Upgrade Einstein Bots into Agentforce agents end-to-end in a single...

- Repository: https://github.com/forcedotcom/sf-skills (1134 stars)
- Category: Testing
- License: Apache-2.0
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add forcedotcom/sf-skills --skill agentforce-bot-upgrade -g -a claude-code -y`
Codex: `npx skills add forcedotcom/sf-skills --skill agentforce-bot-upgrade -g -a codex -y`
Cursor: `npx skills add forcedotcom/sf-skills --skill agentforce-bot-upgrade -g -a cursor -y`
Gemini CLI: `npx skills add forcedotcom/sf-skills --skill agentforce-bot-upgrade -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add forcedotcom/sf-skills`

## Description

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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Einstein Bot Upgrade Orchestrator

## Purpose

Run a multi-bot upgrade-and-handoff cycle:

1. Parse and validate bot/version pairs from `--bots`
2. Follow [Generate Agent Spec Reference](references/generate-agent-spec.md) per bot-version pair (parallelizable)
3. Aggregation step that requires all generated Agent Specs
4. `/agentforce-generate` per Agent Spec (parallelizable)
5. 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 is `online` when 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 is `true` when 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:

The rest: https://github.com/forcedotcom/sf-skills/blob/HEAD/plugins/builder/agentforce-adlc/skills/agentforce-bot-upgrade/SKILL.md