sfagent-tools — Claude Code plugin: test Agentforce agents
This plugin runs test conversations against your Agentforce agent, checks routing and guardrails, and returns a scored report.
/plugin marketplace add anthropics/claude-plugins-community
/plugin install sfagent-tools@claude-communityWhat sfagent-tools does
The plugin pulls your agent's configuration from the org — subagents, actions, descriptions — so it knows what to exercise. Then it drives multi-turn sessions headlessly through sf agent preview, and you can follow the markdown transcript live in a split pane. Injection attempts, off-topic asks and manager-escalation triggers get probed along the way.
Put your expectations in sfagent-config.yaml: per-subagent rules, global rules, custom scenarios. Each one comes back as pass or fail, and the run ends with a report scoring routing accuracy, guardrail strength and multi-turn coherence. A YAML export for sf agent test run-eval lets the same scenarios run on every commit.
No new credentials are involved. The plugin reuses your sf CLI auth, so sf org login web once is enough. Production orgs are blocked at the tool level, which means tests only touch sandboxes, scratch orgs or Developer Edition. Diagnostics rely on sf agent trace, so routing and action details need sf CLI 2026-05-20 or later.
What it helps with
- check whether a customer request reaches the right subagent
- catch attempts to talk the agent out of its role
- compare replies against rules in
sfagent-config.yaml - see if context survives a multi-turn conversation
- export scenarios as YAML for CI runs
Example prompts for the agent
- Test my Agentforce agent
- List the subagents and actions in this org
- Run the scenarios from
sfagent-config.yamland show which rules fail
How to install sfagent-tools
Plugin marketplace
/plugin marketplace add anthropics/claude-plugins-community/plugin install sfagent-tools@claude-communityStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about sfagent-tools
How do I install sfagent-tools in Claude Code?
Add the marketplace with /plugin marketplace add anthropics/claude-plugins-community, then install the plugin: /plugin install sfagent-tools@claude-community.
What does sfagent-tools do?
It reads an Agentforce agent's configuration, holds test conversations with it, and scores routing, guardrails and business-rule compliance. You get a report plus YAML for CI.
Does it need separate Salesforce credentials?
No. It reuses your existing sf CLI authentication, and testing is limited to sandboxes, scratch orgs and Developer Edition.
