用途:驱动亚马逊前台 Alexa 购物助手,用自然语言提问获取导购回答、精选商品分组(含 ASIN、链接、价格、评分等)以及 Alexa 提供的后续追问问题。
主要能力:单次调用发送一个问题并返回一个回答;输出支持 markdown(可读报告)与 json(结构化数组,含 prompt、content、products、followUpQuestions、screenshot)两种格式;resultsNum 表示实际回答轮数,为 0 表示未产生可用回复。
使用方式:prompts 为必填数组但仅允许 1 个元素;format 可选,默认 markdown;url 可选,仅在需要锚定具体亚马逊页面(分类页、搜索结果页或商品详情页)时传入,不要传 https://www.amazon.com/ 这类纯首页。追问时需由 agent 总结上一轮要点(推荐、ASIN、相关上下文)并与新问题拼接为新的 prompts[0] 重新调用。可通过 scripts/amazon_alexa_search.py 命令行测试,调用约定见 references/api.md。
适用场景:亚马逊对话式选品、目标加约束加预算的问答、基于特定页面的推荐、对 Alexa 回复内推荐做对比、获取追问思路。
限制:Alexa 驱动、结果不确定,同一 prompt 多次调用可能不同;无跨调用记忆,每次都是全新会话;每次仅 1 条 prompt;主要基于 amazon.com,其他站点取决于 Alexa 覆盖;输出为对话式回答加少量精选商品,不能替代全量搜索结果抓取、历史搜索词分析、商品详情、评论情感分析或图片找同款。若 code/errcode 非 200,应展示 msg/errmsg 并建议简化 prompt 重试。响应较大时可先持久化到磁盘再按需读取字段,注意其中可能含 PII 或价格等敏感数据,不要提交到代码仓库。