atlas:AI Agent 工具实践指南
2026-10-03
2026-10-07 0
真正理解sorify,要从它处理的任务开始:sorify - AI Agentic QA AI 代理平台。实际做软件开发时,经常会碰到依赖、接口和异常处理往往比主路径更影响采用,所以功能列表并不能代替验证。与其反复读介绍,不如在隔离分支完成一个可回滚的小任务,再依据安装步骤、接口契约、测试结果和错误信息做取舍。对需要可检查开发流程而非单次演示的工程师来说,这个仓库值得继续验证;只求即装即用的人则要先看维护成本。

下一代AI 第一 - 浏览器测试 &浏览器自动化平台
AI 完全可控 - 剧作家管理 Platform
专为 AI 代理打造 - Claude・Codex
专为 developers 打造 通过 MCP
管理整个工作区 打造强大 browser automations
与scheduler
双向 webhook integrations
Chrome 扩展程序,带有 MCP(适用于混合动力爱好者)
24/7 背景 Agents
Page 知晓 MCP
Comprehensive 测试 management
与 Ephemeral 上的剧作家跑步者一起
Control 本地的所有内容 harness
克劳德·法典·OpenCode
Pick 从左边开始 off
AI 仪表板上的代理 itself
24/7 背景 AI Agents
Page 感知 - 与 MCP sync
为本地 harness 提供支持的相同 MCP 工具 也在UI上
Admin tools
用户管理,oAuth apps
监控、日志等
Code coverage
对于前端 assets
User Skills
创建、重用技能 - 多合一 place
分享、浏览、复制attach
对于本地或 UI Agent
★ 自动化: 使用 claude、codex - 以及技能、mcp、测试运行程序和仪表板自动化浏览器测试。
★ Chrome 扩展: 捕获浏览器操作,发送到 AI 编写测试、上传、自我修复。
★ Webhooks: 3 种类型的双向集成。触发器远程运行,或触发 Github Actions 或 HTTP Webhook pre/post 从 sorify 运行。
★ 临时: 自托管,可在临时模式下扩展。
★ 计划: 在内置计划程序中运行自动化浏览器任务。
✴ 测试管理: 组织测试套件和测试用例,按需或按计划运行它们。
✴ 剧作家代码覆盖率: 仪表板内的代码覆盖率支持。
✴ 测试运行程序: 由剧作家驱动的执行,具有完整的运行历史记录。
✴ 通知: 当套件完成或失败时收到通知。
✴ Cookie 管理器:sorify 支持来自 UI、MCP 和 chrome 扩展的每套件 cookie 注入。
✴ 用户管理: 角色、权限和每个用户 IAM。
✴ MCP 服务器: MCP 层上的低令牌消耗,控制测试用例、代码的各个方面。
✴ 代理插件: 包含 Claude/Codex 插件 - 零代码测试代码管理。
✴ 我的 AI 代理: 具有仪表板后台功能,AI 代理您自己的 OpenAI-compatible。
✴ MCP: 页面感知聊天,可以调用每个 sorify MCP 工具,可恢复切换到本地代理。
✴ 技能: 在平台内为座席创建、分享技能。使用过MCP或UI内的代理。
✴ i18n 和 2 种模式: 支持日语、中文、马来语,带有深色模式。
快速入门
docker-compose up
特点
WITH ALL MCP CONTROLS - SUPPORTED
▼ Core Testing
・ AI test generation ・ Playwright execution
・ Browser automation ・ Cross-browser support
・ Headless mode ・ Scheduled runs
・ Cron scheduling ・ Per-test scheduling
・ Run history ・ Run cancellation
・ Status polling ・ Test logs
・ Pass-rate analytics ・ Screenshot on failure
・ Code coverage reports ・ LCOV coverage export
・ Bundle URL filter ・ Run retention pruning
▼ Test Management
・ Suite management ・ Test case management
・ Bulk test creation ・ Bulk test deletion
・ Suite duplication ・ Test duplication
・ Code version history ・ Version restore
・ Test enable/disable ・ Search and filters
・ Suite bookmarks ・ Suite review page
・ Dashboard analytics
▼ Sessions and Data
・ Cookie injection ・ Pre-authenticated sessions
・ Storage state upload ・ Suite variables
・ Proxy routing ・ Per-domain proxies
・ Timeout configuration ・ History retention
▼ Access Control
・ User management ・ Role-based permissions
・ Per-suite members ・ Suite sharing
▼ Notifications
・ Teams notifications ・ Email notifications
・ Inline screenshot emails ・ Notification cooldown
・ Digest summaries
▼ Integrations
・ CI webhook trigger ・ Bi-directional webhooks
・ Webhook concurrency guard ・ Webhook token regeneration
・ GitHub Actions dispatch ・ HTTP request hooks
・ Pre-run hooks ・ Post-run hooks
・ Multi GitHub App support ・ GitHub/GHE OAuth login
・ MCP discovery endpoint
▼ AI and Agents
・ MCP server ・ Low-token consumption
・ Claude plugins ・ Codex plugins
・ My AI Agent web chat ・ Agent chat handoff to MCP
・ Agent profiles ・ Ask and Agent chat modes
・ User skills (markdown) ・ Skills library + copy
・ Long running agents ・ Live agent streaming
・ Agent turn cancellation ・ Agent web tools
・ AI healing ・ Failure investigation
・ Gateway live lookups
▼ Dashboard and UI
・ Activity feed ・ Cmd+K command palette
・ Global search ・ Screenshot gallery
・ Syntax highlighted editor ・ Admin dashboard note
・ i18n (JA, ZH, MS) ・ Dark mode
▼ Recorder
・ Chrome extension ・ Session recording
・ Recorded test generation ・ Standalone recorder MCP
▼ Deployment
・ Self hosting ・ Ephemeral mode
・ Docker deployment ・ Admin panel
・ Ephemeral readiness check ・ Execution mode switcher
・ Runner image build ・ Data retention pruning
特征矩阵
▼ Feature Matrix
MCP Dashboard Webhook API
--------------------------------------
・ Suites: list/get/create/update/delete/duplicate ○ ○ — ○
・ Suite schedule: update/delete ○ ○ — ○
・ Suite cookies: upload ○ ○ — ○
・ Suite integrations: GitHub Action/HTTP request (pre/post run hooks) ○ ○ — ○
・ Suite bookmarks: list/toggle ○ ○ — ○
・ Suite members: list/add/update/remove ○ ○ — ○
・ Tests: list/get/create/update/update code/delete/duplicate ○ ○ — ○
・ Tests: bulk-create/bulk-delete ○ ○ — ○
・ Tests: toggle enabled/disabled ○ ○ — ○
・ Runs: trigger/list/get/cancel/delete ○ ○ — ○
・ Runs: status ○ ○ ○ ○
・ Runs: logs ○ ○ — ○
・ Screenshots: list/get ○ ○ — ○
・ Recorder: chrome extension events ○ — — —
・ Suite webhook token: regenerate — ○ — ○
・ Test code-version: restore — ○ — ○
・ Login/register/logout/password reset — ○ — ○
・ Profile: update name/password — ○ — ○
・ Dashboard analytics (stats, recent runs) — ○ — —
・ Admin: manage users (create, list, role, delete, reset password) — ○ — ○
AI 用法
克劳德·科德
$ cat ~/.sorify
SORIFY_URL=http://localhost:8000/sorify
[email protected]
SORIFY_PASSWORD=changeme
claude /plugin marketplace add https://github.com/rakutentech/sorify.git
在 Claude Code 中从该市场安装 sorify,然后启动一个新的
会议。现有的 /sorify:gateway、/sorify:generate 和
/sorify:recording 命令仍然可用。
法典
codex plugin marketplace add https://github.com/rakutentech/sorify.git
codex plugin add sorify@sorify
法典: 调用 $sorify:sorify-setup 技能一次。
使用法典技能
$sorify:sorify-gateway
$sorify:sorify-generate
$sorify:sorify-recording
$sorify:sorify-update
codex mcp get sorify
SKILL 1 - 索瑞菲 MCP
/sorify:gateway Create a test suite called "Awesome App"
/sorify:gateway List latest failing tests
/sorify:gateway Create new test suite. Get requirements from JIRA/GHE/Excel. Write using /sorify:generate
/sorify:gateway Update the test suite http://localhost:8000/sorify/suites/{id} by adding retry twice
AI 治疗
/sorify:gateway why my test is failing
/sorify:gateway why my test is failing
SKILL 2 - 内置 QA 技能
# Tests from source code (git)
/sorify:generate Scan my code and generate tests for
# Tests from source code (path)
/sorify:generate Scan my code and generate tests for , ref
# Tests from url (remote)
/sorify:generate Crawl site and generate tests for https://rakuten.co.jp
OR SKILL BYO - 自带 QA 技能
/my:qa:skill Create detailed tests <...>
...then /sorify:gateway once done - upload, run and invetigate failed tests
Chrome 记录器 - 记录、捕获、生成、上传(Chrome 扩展)
这是一个 Chrome 扩展,可以选择在混合模式下工作。浏览时,它会记录浏览器事件并存储到文件中。 然后,AI 可以拾取事件序列,以更好地编写测试代码,当补充更多有关项目的上下文(例如源代码)时,效果很好。
从真实录制的会话生成测试,而不是 DOM 探索 — chrome-mcp-playwright sorify-recorder-mcp
♢ 1. 安装 mcp
curl -fsSL https://raw.githubusercontent.com/rakutentech/sorify/master/mcp/install-mcp.sh | sh
♢ 2. 加载 Chrome 扩展程序
chrome://extensions/ → 启用 “开发者模式” → “加载解压”→ 选择 extension/ 文件夹
我们没有 npx,抱歉
♢ 3. 启动录音机
当您启动 Claude Code 或
法典。在克劳德代码中,检查 /mcp
plugin:sorify:sorify-recorder.
如果没有,则在以下位置启动侦听器:
~/.sorify-bin/sorify-recorder-mcp
否 4. 单击扩展图标 → 连接 → 开始录制
执行您想要变成测试的clicks/inputs,然后停止录制。
提示:检查端口lsof -nP -iTCP:7420 -sTCP:LISTEN
否 5. 生成测试
/sorify:recording latest
在 Codex 中,使用 $sorify:sorify-recording 并请求最新记录。
快速入门(来自源码)
发展(本地)
# 更新:APP_KEY、DB_PASSWORD、MYSQL_ROOT_PASSWORD
cp .env.example .env
composer setup
php artisan dev
验证
http://localhost:8000/sorify
有关其他详细信息,自托管、临时模式、docker,请参阅 INSTALL.md。
可定制的设置
Suite settings
|
Webhook settings CI webhook for triggering Sorify runs |
Run settings
Webhook URL、令牌和运行选项
集成
HTTP 集成 settings
从 sorify 触发 HTTP - pre/post 运行
GitHub、GHES、GHEC 集成
集成 1:Github Actions → sorify
触发器 sorify 使用套件的 CI webhook(令牌身份验证,无会话)从工作流程运行。 从套件的设置页面获取 Webhook URL,将令牌存储为秘密,然后:
on: [push]
jobs:
e2e:
runs-on: ubuntu-latest
steps:
- name: Trigger Sorify run
run: |
curl -sf -X POST "$SORIFY_WEBHOOK_URL/trigger" \
-H "Content-Type: application/json" \
-d '{"test_ids": [12, 34]}' # omit to run all active tests
env:
SORIFY_WEBHOOK_URL: ${{ secrets.SORIFY_WEBHOOK_URL }}
- name: Poll run status
run: |
curl -sf "$SORIFY_WEBHOOK_URL/runs/{run}/status"
env:
SORIFY_WEBHOOK_URL: ${{ secrets.SORIFY_WEBHOOK_URL }}
集成 2:sorify → Github 操作(前或后)
GitHub 应用程序在管理 → GitHub 应用程序(仪表板)下进行管理。 用于登录或触发 sorify 的操作。
要注册应用程序,请按照仪表板本身上的演练操作:管理→ GitHub 应用程序→“如何 注册“。
sorify 调度的工作流程如下所示:
on:
workflow_dispatch:
inputs:
# Injected by Sorify — do not edit
sorify_run_id:
type: string
sorify_suite_id:
type: string
# and so on. Custom add from - sorify's suite/{id} > settings
jobs:
sorify:
name: Sorify
steps:
- name: Show Sorify context
run: |
echo "sorify_run_id=${{ github.event.inputs.sorify_run_id }}"
HTTP API 参考
有关完整端点列表和示例curl 请求,请参阅 API.md。
业主
|
asghar-ahmed | HiromichiHagiwara | |
|
pulkit-kathuria | chetra-tep | chetratep |