agent-qa-plugin-steel Skill
在配置 agent-qa 网页测试通过 Steel 插件运行于 Steel 云浏览器时使用,或在 Steel 远程连接被拒绝时使用。
安装方式:把技能目录放入 ~/.claude/skills/(Claude Code)或在 claude.ai 设置中启用;也可复制右侧安装命令一键添加。
技能指令原文(SKILL.md)
Steel remotes for agent-qa
The Steel plugin gives an agent-qa web test a Steel browser session. Before the test connects it
creates a session through Steel's API, and after the test it releases the session. Steel runs
Chromium only. CAPTCHA solving, ad blocking, Steel's proxies and Steel's fingerprint injection are
off unless a setting turns them on, so a test sees the app the way its users do.
Declare the plugin and a remote
plugins:
- name: steel
package: "@vostride/agent-qa-plugin-steel"
options:
apiKey: "{{secret:STEEL_API_KEY}}"
registry:
remotes:
- name: steel
plugin: steel
settings:
idleMinutes: 5
- The
pluginsentry holds the account:apiKey, andapiUrl, which defaults to
https://api.steel.dev. Write the key as a {{secret:}} reference to a name in the file
workspace.secretsFile names. Never write the key itself in the config.
- The remote holds one place:
pluginnames thepluginsentry, andsettingshold that place's
Steel settings.
use.browser.remote: steelin the config, a suite or a test runs the test there.- Add the plugin with
npx agent-qa plugins add @vostride/agent-qa-plugin-steel: it pins the
package at the project's agent-qa version and writes the plugins entry. agent-qa plugins list
prints that line when the package is missing or the version differs.
- For a self-hosted steel-browser, set
apiUrlto its loopbackhttp://address, leave out
apiKey, and set use.workers: 1: it serves one session at a time, and releasing one ends
whatever session is active. It returns no session link.
Settings
timeoutMinutes(default1440, 1 to 1440): minutes before Steel ends the session. Steel's
plans cap it: Launch at 15, Scale at 60, Enterprise at up to 1440.
idleMinutes(default5, 1 to 60): minutes with no CDP command before Steel ends the session.
agent-qa's heartbeat keeps a running test from going idle.
solveCaptcha(defaultfalse),blockAds(defaultfalse): Steel's CAPTCHA solving and ad
blocking.
fingerprint(defaultfalse): Steel's fingerprint injection. The plugin always tells Steel to
skip it unless this is true.
proxy(defaultfalse):true, or Steel's proxy object, sent asuseProxy.proxyUrl: your own proxy,http(s)://user:password@host:port, a credential. Write it as a
{{secret:}} reference. It is sent instead of Steel's proxy, so do not also set proxy.
dimensions({ width, height }),region(for exampleus-east),extensions(extension
ids): Steel's own create fields.
profile: a Steel profile id. It loads read-only: nothing the test does is saved back. It needs
context: reuse on the remote, because the profile lives in the browser's first context:
- name: steel-signed-in
plugin: steel
context: reuse
settings:
profile: <Steel profile id>
extra: any other Steel request field. It is merged last, so it overrides the settings above.
It cannot set sessionId, which the plugin chooses to release the session.
When a remote is refused
auth: Steel refused the API key. Check the secret's value.capacity: Steel answered 429. The account has no free sessions, or is rate limited. Wait, or
lower the run's concurrency.
refusedwhose line endsset settings.timeoutMinutes to the cap: Steel refused the create with
400 or 422, and its reason may be the plan capping sessions below the lifetime asked for. Set
timeoutMinutes to the plan's cap, for example 15 on Launch. A 400 or 422 whose reason
names another field ends without this, so fix the field it names.
refusedwith pathsettings.profile: the remote setsprofilewithoutcontext: reuse. Add
context: reuse to the remote.
refusedwith pathsettings.extra.sessionId:extrasetssessionId. Remove it.refusedwith pathsettings.proxyUrl: the remote sets bothproxyandproxyUrl. Keep one.refusednaming a browser or platform: Steel runs Chromium web tests only. Use
use.browser.name: chromium, or another remote.
refusedwithUnrecognized key: "recording": Steel has no switch to turn recording off, so
the plugin has no recording setting. Remove it.
refusedatoptions.apiUrl: the endpoint must usehttps://with no user or password, unless
it points at this machine.
unreachable: Steel could not be reached. Check the network, or that a self-hosted
steel-browser is running.
Recording
Steel records every session and keeps the replay on its dashboard, behind its login. agent-qa's
masking does not reach that replay, so a secret a test types may show in it. Steel offers no switch
to turn recording off. The session link opens the session's page in Steel's dashboard. Steel's
debug URL lets anyone who has it drive the session, so agent-qa masks it and never shows it.
Check and describe
agent-qa doctorruns the plugin's account check. It lists sessions to prove the key and opens
none.
agent-qa plugins describe steel --jsonlists every option and setting with its type, default
and description.