分页
列表类工具返回一页结果和下一页的令牌。再次调用是 AI 的一步——或你代码循环里的一步。
亚马逊的长列表是一页一页返回的,封装这些列表的 SellerSheet 工具也一样。返回结果从不告诉 AI “再调用一次”——工具描述里写明了如何翻页,由 AI 决定是否需要下一页。
怎么用
- 不带令牌调用工具——得到第一页;如果还有更多,
data里会带一个令牌(用亚马逊自己的名称,例如nextToken)。 - 用同样的参数加上这个令牌再调用一次——得到下一页。
- 结果里没有令牌,说明已经是最后一页。
接收令牌的参数名写在每个工具的参考页里——通常是 pagination_token 或 next_token,有时沿用厂商自己的拼写。大多数列表工具还接受每页数量,例如 page_size。
在 AI 客户端中(MCP)
{
"name": "orders_searchOrders",
"arguments": {
"store": "myStore-US",
"created_after": "2026-10-01T00:00:00Z",
"pagination_token": "<data.nextToken from the previous call>"
}
}在代码中(Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/orders_searchOrders \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US","created_after":"2026-10-01T00:00:00Z","pagination_token":"<data.nextToken from the previous call>"}'抢先体验 — 如需 Tool API 访问,请 联系我们.
好习惯
- “没有令牌”传
null,不要传空字符串。 每个可选参数都接受显式的null,所以 AI 可以从pagination_token: null开始。 - 翻页时其他参数保持不变;令牌属于它所在的查询。
- 历史数据查仓库。 “上季度的所有订单”是对同步数据表的一次
query_report_data调用(配合limit和offset),而不是向亚马逊翻几百页——而且完全不消耗亚马逊的频率限额。见同步报表。 - 边取边写。 要把整个目录写进表格时,AI 每取一页就先追加到表格,再取下一页,长流程不必把所有数据都留在手里。