用途:调用 Amazon 店面 Alexa 购物助手,用自然语言提问获取购物建议、推荐商品分组(含 ASIN、标题、链接、封面、价格、评分、评论数)以及 Alexa 提供的后续追问问题。
主要能力:单次调用提交一个问题并返回一个回答;支持 markdown(可读报告)与 json(结构化数组,含 prompt、content、products、followUpQuestions、screenshot)两种输出;可选 url 参数将对话锚定到具体 Amazon 页面(分类页、搜索结果页或商品详情页)。
使用方式:API 端点 POST /amazon/alexaSearch;脚本调用 python scripts/amazon_alexa_search.py '<JSON params>' [--inline]。需设置 NEXSCOPE_API_KEY 环境变量。prompts 数组每次只允许 1 个元素。追问需在新调用中把上一轮要点摘要与新问题拼接为 prompts[0],因为每次调用都是全新会话,不保留跨调用上下文。url 仅在需要锚定具体页面时传入,不要传 https://www.amazon.com/ 这类首页。
输出与成本:脚本默认将完整响应写入 <cwd>/nexscope/<日期>/<session>/data/ 下的 JSON 文件;响应体超过 8 KB 时仅打印摘要,可用 --inline 强制完整输出。工具消耗额度,同一会话与参数组合默认只调用一次并带 24 小时本地缓存;失败或空结果时不要自动更换关键词、翻页或邮编重试,需先告知用户额外消耗。resultsNum 为实际回答轮数,0 表示未产生可用回复。
适用场景:Amazon 上的自然语言对话式选品、目标加约束加预算的问答、基于某页面的追问、对 Alexa 推荐结果做比较、获取后续追问建议。
限制:结果由 Alexa 驱动,非确定性,同一问题不同调用可能不同;无跨调用记忆;每次仅一个问题;主要基于 amazon.com,其他站点取决于 Alexa 覆盖;输出为对话式回答加少量精选商品,不能替代整页搜索结果抓取、历史搜索词分析、指定 ASIN 详情、评论情感分析或图片相似商品发现。非 200 状态码表示业务错误,应展示 msg/errmsg 并建议用更简单的问题重试。