---
title: "搭建能查订单的 AI 客服 Agent"
description: "搭建一个 AI 客服 Agent：读取 Gmail 里的订单咨询，到 Shopify 或 WooCommerce 查对应订单，再起草回复。基于 AIsa Connect，每个商家的数据互相隔离。"
canonical: "https://aisa.one/zh/solutions/ai-customer-support-agent"
---

# 搭建一个回复“我的订单到哪了”邮件的客服 Agent

> 搭建一个 AI 客服 Agent：读取 Gmail 里的订单咨询，到 Shopify 或 WooCommerce 查对应订单，再起草回复。基于 AIsa Connect，每个商家的数据互相隔离。

商家连接一次 Gmail 和店铺，你的 Agent 在收件箱里找到订单咨询，到 Shopify 或 WooCommerce 查每个订单，再起草回复交给人工发送。

- 网页版：https://aisa.one/zh/solutions/ai-customer-support-agent
- 适合谁：Agent 开发者和企业团队
- 数据领域：AIsa Connect
- 基于 AIsa Connect 运行：[AIsa Connect](https://aisa.one/zh/products/connect)

## 从收件箱到回复草稿的四个请求

每个请求都从你的服务器为一个商家发出，Gmail、Shopify 和 WooCommerce 只返回这个商家的数据。

### 1. 商家连接 Gmail

为商家创建一个连接会话并打开它的 connectUrl。Google 的授权页从 AIsa 托管的页面打开，你轮询会话直到完成。店铺用凭证连接，做法和 Shopify Agent 页面一样。

```
curl "https://api.aisa.one/apis/v1/connector/connect/gmail?externalUserId=store_8812" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

### 2. 在收件箱里找到订单咨询

gmail.search_threads 接受 Gmail 搜索语句，返回匹配的邮件会话。之后用 gmail.fetch_message_by_thread_id 读取完整对话。

```
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": "gmail.search_threads",
    "externalUserId": "store_8812",
    "input": {
      "query": "newer_than:1d (order OR delivery OR refund)",
      "maxResults": 20
    }
  }'
```

### 3. 到店铺里查订单

按发件人的邮箱地址搜索：shopify.list_orders 接受 email: 查询，woocommerce.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": 5,
      "query": "email:jane@example.com"
    }
  }'
```

WooCommerce：

```
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": "woocommerce.list_orders",
    "externalUserId": "store_8812",
    "input": {
      "search": "jane@example.com",
      "perPage": 5
    }
  }'
```

### 4. 在订单上记下处理结果

你的 Agent 在你的产品里起草回复，由人工发送。随后 woocommerce.add_order_note 在订单上留一条内部备注，这是写入操作，需要商家先同意。

```
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": "woocommerce.add_order_note",
    "externalUserId": "store_8812",
    "input": {
      "orderId": 1043,
      "note": "Customer asked where the order is. Reply drafted with the tracking link.",
      "customerNote": false
    }
  }'
```

## 让你的编程 Agent 来搭建

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

```text
用 AIsa Connect（https://aisa.one/docs/resources/aisa-connect）给我们的客服收件箱加上订单查询。

先阅读指南。只在服务器端调用 AIsa，从环境变量读取 AISA_API_KEY。

1. 让商家连接 Gmail：用商家 ID 作为 externalUserId 调用 GET /connect/gmail，打开完整的 connectUrl，轮询连接会话直到完成。
2. 让商家用各应用要求的字段连接 Shopify（POST /connect/shopify/credentials）或 WooCommerce（POST /connect/woocommerce/credentials）。
3. 每 15 分钟运行一次 gmail.search_threads 查找新的订单咨询，并用 gmail.fetch_message_by_thread_id 读取每个会话。
4. 用 shopify.list_orders（email: 查询）或 woocommerce.list_orders（search）查发件人的订单。
5. 在我们的应用里起草一封带订单状态的回复，交给客服审核后发送。不要发送邮件。

写调用前先读取每个操作的 inputSchema，先把方案给我看。
```

你的编程 Agent 会先给出方案再写代码。Gmail 以只读权限连接，回复从你的产品或商家自己的邮箱客户端发出。

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

### AI 客服 Agent 能做什么？

AI 客服 Agent 读取顾客发来的消息，到你的系统里找到需要的信息，然后起草或发送回复。基于 AIsa Connect，它读取商家的 Gmail，并到商家的 Shopify 或 WooCommerce 店铺查订单。

### 它能回答“我的订单到哪了”这类问题吗？

能。它用发件人的邮箱地址匹配订单，读取每个订单的发货状态，回复草稿可以说明订单是待发货、部分发货还是已发货。

### Agent 能直接从 Gmail 发送回复吗？

目前不能。Gmail 以只读权限连接，Agent 在你的产品里起草回复，由人工在你的产品或 Gmail 里发送。

### 商家可以连接哪些邮箱和店铺？

邮箱用 Gmail，订单用 Shopify 或 WooCommerce，都已在生产环境验证。连接器页还列出了其他客服和电商应用及其操作。

### 一个商家的 Agent 会看到另一个商家的邮件吗？

不会。每个 Connection 都属于一个 externalUserId，也就是商家在你系统里的 ID，运行时只使用这个商家的 Connection。

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

每次成功运行 $0.0003，搜索收件箱、读取会话和查订单加起来，每个咨询约 $0.0009。连接账号免费。

## 相关任务

- [搭建 Shopify AI Agent](https://aisa.one/zh/solutions/shopify-ai-agent.md)：商家连接一次店铺，你的 Agent 就能通过 AIsa Connect 读取订单和库存，并给订单加标签。适合：Agent 开发者和跨境卖家
- [自动生成电商报表](https://aisa.one/zh/solutions/ecommerce-reporting.md)：每周拉取每个商家的订单和邮件营销活动，把报表写进他们的 Notion。适合：Agent 开发者和营销代理商
