快速开始
AI Toolkit 运行在 Shoplazza CLI 之上,因此配置分四步:安装 CLI、添加技能、认证,再向智能体发指令。
环境要求
- Node.js 16.0.0 或更高
- 能执行 shell 命令的 AI 智能体(如 Claude Code,或任何具备终端访问能力的智能体)
1. 安装 Shoplazza CLI
shell
npm install -g shoplazza-cli
其他方式(shell 脚本、Homebrew、预编译二进制)与完整说明,见安装 Shoplazza CLI。
2. 添加 Agent Skills
shell
npx skills add Shoplazza/shoplazza-cli -g
这条命令会把技能安装到 ~/.agents/skills/,并软链到你的 agent 技能目录,全局跨项目生效。技能清单与工作方式见 Agent Skills。
3. 认证
shell
shoplazza auth login --store-domain my-store.myshoplazza.com --domain products,orders
该命令会打开浏览器进行 OAuth 授权,并将凭据安全存储在操作系统钥匙串中。用 shoplazza auth status 验证。UAT/CI 登录与店铺切换见认证。
提示
若由 AI 智能体替你执行登录,它应从命令输出中提取授权 URL 并发给你——命令会轮询,直到你在浏览器中完成 OAuth。
4. 向智能体发出指令
用 /shoplazza-<域> 前缀调用技能,再用自然语言描述任务:
/shoplazza-products 看下店里所有带 shirt 关键词、已上架的商品
在背后,智能体运行:
shell
shoplazza products +search --keyword "shirt" --format table
下一步
- Agent Skills —— 选对业务域并理解安全协议
- 使用示例 —— 各模块的即拷即用指令