跳到主要内容

快速开始

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

下一步