# Shoplazza AI Toolkit 概述

> Shoplazza AI Toolkit 让 AI 编码智能体用自然语言操作店铺，由 Shoplazza CLI 做执行引擎，配合按业务域划分的 Agent Skills。

Shoplazza AI Toolkit 让 AI 编码智能体用自然语言操作 Shoplazza 平台。它构建于 [Shoplazza CLI](/zh-CN/docs/app/developer-tools/shoplazza-cli/) 之上——CLI 为 **Agent 原生设计**：每条命令开箱即向智能体和脚本返回结构化 JSON，因此智能体无需额外适配即可管理商品、折扣、订单与客户。

## 工作原理

Toolkit 由两部分组成：

1.  **Shoplazza CLI** —— 执行引擎。它对店铺完成认证，并提供[三层命令体系](/zh-CN/docs/app/developer-tools/shoplazza-cli/guides/command-layers)（快捷命令 → API 命令 → 原始 API），输出结构化 JSON。
2.  **Agent Skills** —— 每个业务域一个的 `SKILL.md` 指引文件，教会智能体_何时_、_如何_调用每条命令。一条命令即可安装，用 `/shoplazza-<域>` 前缀调用。

两者就位后，你用自然语言描述任务，智能体便替你运行正确的命令：

```text
/shoplazza-products 上架一个新品:夏季印花T恤,卖 129
```

## 你能做什么

- [快速开始](/zh-CN/docs/app/developer-tools/ai-toolkit/get-started): 安装 Shoplazza CLI、添加 Agent Skills、认证，并在 Claude Code、Codex CLI、Cursor IDE、Gemini CLI、Antigravity CLI 或 GitHub Copilot 里运行第一个指令。
- [Agent Skills](/zh-CN/docs/app/developer-tools/ai-toolkit/skills): 理解按业务域划分的技能、/shoplazza 前缀、域边界，以及内置的安全协议。
- [使用示例](/zh-CN/docs/app/developer-tools/ai-toolkit/usage/products): 商品、折扣、订单的即拷即用自然语言指令。

## 下一步

*   [快速开始](/zh-CN/docs/app/developer-tools/ai-toolkit/get-started) —— 安装、添加技能、认证并运行第一个指令
*   [Agent Skills](/zh-CN/docs/app/developer-tools/ai-toolkit/skills) —— 技能、前缀与安全协议如何运作
*   [安全与权限](/zh-CN/docs/app/developer-tools/ai-toolkit/safety-and-permissions) —— Scope、安全协议与护栏
*   [使用示例](/zh-CN/docs/app/developer-tools/ai-toolkit/usage/products) —— 按模块划分的指令库（商品、折扣、订单、客户、店铺、Webhook、计费）
*   [端到端工作流](/zh-CN/docs/app/developer-tools/ai-toolkit/end-to-end) —— 跨多个域的完整大促
*   [无头与 CI](/zh-CN/docs/app/developer-tools/ai-toolkit/headless-ci) —— 在自动化环境中运行 Toolkit
*   [排错](/zh-CN/docs/app/developer-tools/ai-toolkit/troubleshooting) —— 修复常见的智能体与认证问题