用途:在本地 localhost 开发过程中,启动一个已通过 Aircall staging 凭据认证的无头浏览器实例,供调试和交互使用。
主要能力:先调用 /staging-token 技能获取 JWT,从返回 JSON 中提取 idToken 与 refreshToken,然后直接导航到 /sso/callback 并携带 token、refresh_token、redirect 查询参数完成认证;认证后应用会保存令牌并跳转到目标路径。
使用方式:
- 调用 /staging-token 获取令牌,提取 idToken 和 refreshToken。
- 执行命令:agent-browser --session staging open "http://localhost:<PORT>/sso/callback?token=$ID_TOKEN&refresh_token=$REFRESH_TOKEN&redirect=$TARGET_PATH"
- 交互:用 agent-browser --session staging snapshot -i -c 获取可访问性快照;用 agent-browser --session staging screenshot /tmp/staging-screenshot.png 截图。
参数:URL 可选,指定 localhost 地址;若给出路径(如 /playground),作为 redirect 参数。
技术细节:SSO 回调路由为 /sso/callback;查询参数为 token、refresh_token、redirect;会话名为 staging;浏览器默认无头模式,可用 --headed 显示。会话使用 --session staging 隔离,需通过 agent-browser --session staging close 显式关闭。
限制:依赖 /staging-token 技能与 Aircall staging 环境;仅适用于 localhost 开发场景。使用前的具体配置、端口范围、凭据来源等资料暂未提供。