用途:驱动亚马逊前台 Alexa 购物助手,用自然语言提问获取导购回答、精选商品分组(含 ASIN、链接、价格、评分等)以及 Alexa 提供的后续追问问题。
主要能力:单次调用发送一个问题并返回一个回答;支持 markdown(默认,可读报告)与 json(结构化数组,含 prompt、content、products、followUpQuestions、screenshot)两种输出;resultsNum 表示实际回答轮次,为 0 表示未产生可用回复。
使用方式:API 端点 POST /amazon/alexaSearch;脚本 python scripts/amazon_alexa_search.py '<JSON 参数>' [--inline]。参数 prompts 为必填字符串数组但仅允许 1 个元素;format 可选;url 可选,仅在需锚定具体分类页、搜索结果页或商品详情页时传入,不要传 https://www.amazon.com/ 这类首页。追问时须由 agent 总结上一轮要点(推荐、ASIN、上下文)并与新问题拼接为 prompts[0] 发起新调用,因为每次调用都是全新会话,不保留跨调用记忆。
适用场景:亚马逊对话式选品、目标+约束+预算式问答、基于特定页面的推荐、对 Alexa 回复内推荐做对比、获取追问思路。不适用于拉取完整 SERP、历史搜索词分析、指定 ASIN 详情、评论情感分析、图片找同款或对扁平商品列表做聚合统计。
限制:结果由 Alexa 驱动,非确定性,同一 prompt 不同调用可能给出不同答案;每次仅 1 条 prompt;无跨调用记忆;主要基于 amazon.com,其他站点取决于 Alexa 覆盖;输出为对话式回答加少量精选商品,不能替代全量搜索结果提取。计费按动态规则:消耗算力 = 对话轮次 × 12.6,可能一次性消耗大量算力,需提醒用户并由用户决定是否继续。未配置 API Key、返回 401/402 或提示余额不足时,按 references/onboarding.md 处理。脚本默认将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/ 下,响应体大于 8 KB 时 stdout 仅输出摘要,可用 --inline 强制全量打印。