---
title: "为你的商家搭建 Shopify AI Agent"
description: "搭建一个 Shopify AI Agent：读取每个商家的订单和库存，给处理过的订单加标签。AIsa Connect 保管每家店铺的 Connection，并保证商家之间互相隔离。"
canonical: "https://aisa.one/zh/solutions/shopify-ai-agent"
---

# 搭建一个在每家店铺里干活的 Shopify AI Agent

> 搭建一个 Shopify AI Agent：读取每个商家的订单和库存，给处理过的订单加标签。AIsa Connect 保管每家店铺的 Connection，并保证商家之间互相隔离。

商家用 Admin API token 连接店铺，你的 Agent 读取未发货订单和库存，给处理过的订单加标签，AIsa 让每家店铺的 Connection 互相隔离。

- 网页版：https://aisa.one/zh/solutions/shopify-ai-agent
- 适合谁：Agent 开发者和跨境卖家
- 数据领域：AIsa Connect
- 基于 AIsa Connect 运行：[AIsa Connect](https://aisa.one/zh/products/connect)

## 从连接店铺到订单加标签的四个请求

每一步都是从你的服务器发出的一个请求，对象是虚构商家 store_8812，字段名来自每个操作公开的 schema。

### 1. 商家连接店铺

在你的产品里收集店铺的 Admin API token 和 myshopify.com 域名，转发一次。AIsa 检查字段，Shopify 验证 token，Connection 归属于这个商家的 externalUserId。

```
curl -X POST "https://api.aisa.one/apis/v1/connector/connect/shopify/credentials" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "externalUserId": "store_8812",
    "apiKey": "shpat_...",
    "credentials": {
      "shopDomain": "acme.myshopify.com"
    }
  }'
```

### 2. 读取需要处理的订单

shopify.list_orders 接受 Shopify 搜索语句，比如未发货订单，返回每个订单的编号、发货状态、金额和顾客。

```
curl -X POST "https://api.aisa.one/apis/v1/connector/actions/run" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actionKey": "shopify.list_orders",
    "externalUserId": "store_8812",
    "input": {
      "first": 50,
      "query": "fulfillment_status:unfulfilled"
    }
  }'
```

### 3. 承诺发货时间前先查库存

shopify.get_inventory_quantities 返回某个商品在某个仓库的可用数量，你的 Agent 能分清是发货晚了还是缺货。

```
curl -X POST "https://api.aisa.one/apis/v1/connector/actions/run" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actionKey": "shopify.get_inventory_quantities",
    "externalUserId": "store_8812",
    "input": {
      "inventoryItemId": "gid://shopify/InventoryItem/4410283321",
      "locationId": "gid://shopify/Location/7731205",
      "names": [
        "available"
      ]
    }
  }'
```

### 4. 给处理过的订单加标签

shopify.add_tags 会写入店铺，运行前先征求商家同意。AIsa 只发送一次；结果未知时，先到 Shopify 里查看订单，再决定是否重新运行。

```
curl -X POST "https://api.aisa.one/apis/v1/connector/actions/run" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actionKey": "shopify.add_tags",
    "externalUserId": "store_8812",
    "input": {
      "id": "gid://shopify/Order/5829113872",
      "tags": [
        "agent-reviewed"
      ]
    }
  }'
```

## 让你的编程 Agent 来搭建

把这段提示词粘贴到你产品代码仓库里的 Claude Code、Codex 或 Cursor，AIsa Key 放在服务器的环境变量里。

```text
用 AIsa Connect（https://aisa.one/docs/resources/aisa-connect）给这个应用加一个 Shopify Agent。

先阅读指南。只在服务器端调用 AIsa，从环境变量读取 AISA_API_KEY，不要把 Key 发到浏览器。

1. 加一个设置表单，让商家填写 Shopify Admin API token 和 myshopify.com 域名。用商家 ID 作为 externalUserId，把两者转发到 POST /connect/shopify/credentials，用通俗的话解释 400 错误，不要保存 token。
2. 加一个任务：为某个商家运行 shopify.list_orders，查询语句为 fulfillment_status:unfulfilled，并列出订单。
3. 用 shopify.get_inventory_quantities 检查每个订单商品的库存。
4. 运行任何 shopify.add_tags 之前，先让商家确认名单。outcome_unknown 按未知处理，重试前先查看订单。

写调用前，先从 GET /apps/shopify/actions 读取每个操作的 inputSchema。写代码前先把方案给我看。
```

你的编程 Agent 会先给出方案再写代码。先用开发店铺测试，再让商家连接自己的店铺。

## 关于搭建 Shopify AI Agent 的常见问题

### 什么是 Shopify AI Agent？

Shopify AI Agent 是替商家在店铺里读取数据和执行操作的软件，比如列出未发货订单、检查库存或给订单加标签。基于 AIsa Connect，每个商家连接自己的店铺，你的 Agent 只为这个商家执行 Shopify 操作。

### 我需要上架一个 Shopify 应用吗？

用 token 连接就不需要。每个商家在自己的店铺里创建 Admin API access token，填到你的产品里，AIsa 用它完成调用。

### 商家怎样连接店铺？

商家在你的产品里填写以 shpat_ 开头的 Admin API access token 和店铺的 myshopify.com 域名，你转发一次即可：缺少字段返回 invalid_request，token 被拒绝返回 connect_failed。

### 我的 Agent 能执行哪些 Shopify 操作？

将近 100 个，覆盖订单、商品、库存、顾客、草稿订单和发货。每个操作都公开输入 schema，并标明是读取、写入还是删除。

### Agent 能修改订单或商品吗？

可以。shopify.add_tags、shopify.update_product 等操作会写入店铺，运行前先征求商家同意。AIsa 不会自动重试任何运行。

### 运行一个 Shopify Agent 要花多少钱？

每次成功运行 $0.0003，所有套餐相同，失败的运行免费。连接店铺和管理 Connection 都不收费。

## 相关任务

- [搭建 AI 客服 Agent](https://aisa.one/zh/solutions/ai-customer-support-agent.md)：从商家的 Gmail 读取订单咨询，到店铺里查订单，起草回复交给人工发送。适合：Agent 开发者和企业团队
- [自动生成电商报表](https://aisa.one/zh/solutions/ecommerce-reporting.md)：每周拉取每个商家的订单和邮件营销活动，把报表写进他们的 Notion。适合：Agent 开发者和营销代理商
