Menu
Agentforce agent management commands including creation, activation, deactivation, and testing.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Salesforce CLI (sf command) reference and best practices. Use this skill when working with Salesforce development, deployment, org management, data operations, or CI/CD workflows. Covers modern sf v2 commands from version 2.140.6 (June 28, 2026).
Raw REST API and GraphQL requests via sf CLI. Use for custom endpoints, GraphQL queries/mutations, and arbitrary HTTP calls to Salesforce APIs.
Data operations including SOQL queries, single record CRUD, bulk import/export/update, and search.
Org management commands including listing, displaying, opening, and creating Scratch Orgs and Sandboxes.
Apex development commands including class and trigger generation, anonymous execution, unit test running, and debug log management.
Authentication commands for connecting to Salesforce orgs. Includes Web Login, JWT, SFDX-URL, and Access Token flows.
| name | sf-agent |
| description | Agentforce agent management commands including creation, activation, deactivation, and testing. |
sf agent ManagementAgentforce agent management commands.
Create an agent in your org using a local agent spec file.
# Create agent with name and spec file
sf agent create --name "Resort Manager" --api-name Resort_Manager \
--spec specs/resortManagerAgent.yaml --target-org myOrg
# Preview agent creation without saving
sf agent create --name "Resort Manager" --spec specs/agent.yaml --preview
| Flag | Description |
|---|---|
--name | Name (label) of the new agent |
--api-name | API name of the agent |
--spec | Path to agent spec YAML file |
--preview | Preview without saving |
Activate an agent in an org.
# Activate with API name and specific version (New in 2.128.5)
sf agent activate --api-name My_Agent --version 4 --target-org myOrg
# Activate with JSON output
sf agent activate --api-name My_Agent --json
[!NOTE] The
--versionflag corresponds to thevXpart of theBotVersionmetadata in your project. If omitted, the command provides a list of versions to choose from.
Deactivate an agent in an org.
# Deactivate agent with JSON output
sf agent deactivate --api-name Resort_Manager --target-org myOrg --json
Generate an agent spec YAML file.
sf agent generate agent-spec --type customer \
--role "Field customer complaints and manage schedules." \
--company-name "Coral Cloud Resorts" \
--output-file specs/agentSpec.yaml --target-org myOrg
Generate an authoring bundle from agent spec.
sf agent generate authoring-bundle --spec specs/agentSpec.yaml \
--name "My Authoring Bundle" --target-org myOrg
Publish authoring bundle to create an agent in org.
sf agent publish authoring-bundle --api-name My_Bundle --target-org myOrg
Validate authoring bundle before publishing.
sf agent validate authoring-bundle --api-name My_Bundle --target-org myOrg
Interactive agent preview session.
# Preview agent
sf agent preview --api-name Resort_Manager --target-org myOrg
# Start preview session
sf agent preview start --api-name Resort_Manager --target-org myOrg
# Send message to session
sf agent preview send --session-id <session-id> --message "Hello"
# End session
sf agent preview end --session-id <session-id>
Agent testing commands.
# Create agent test
sf agent test create --api-name My_Agent --output-file specs/test.yaml
# Run tests
sf agent test run --api-name Resort_Manager --target-org myOrg
# Get results
sf agent test results --test-run-id <test-run-id> --target-org myOrg