分页

列表类工具返回一页结果和下一页的令牌。再次调用是 AI 的一步——或你代码循环里的一步。

亚马逊的长列表是一页一页返回的,封装这些列表的 SellerSheet 工具也一样。返回结果从不告诉 AI “再调用一次”——工具描述里写明了如何翻页,由 AI 决定是否需要下一页。

怎么用

  1. 不带令牌调用工具——得到第一页;如果还有更多,data 里会带一个令牌(用亚马逊自己的名称,例如 nextToken)。
  2. 用同样的参数加上这个令牌再调用一次——得到下一页。
  3. 结果里没有令牌,说明已经是最后一页。

接收令牌的参数名写在每个工具的参考页里——通常是 pagination_token 或 next_token,有时沿用厂商自己的拼写。大多数列表工具还接受每页数量,例如 page_size。

在 AI 客户端中(MCP)

tools/call
{
  "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 每取一页就先追加到表格,再取下一页,长流程不必把所有数据都留在手里。

本页内容

操作

查看 Markdown

询问助手

问 ChatGPT问 Claude