SuperAPI AI 工具集

prava-shopping

智能体与模型

查看项目

更新于 10-16 03:47

技能介绍

用途:当用户希望智能体代为寻找并购买实体商品(如“帮我买个X”“下单这个”“结算我的购物车”),且未指定商店时,使用本技能通过 Prava CLI 端到端购物。若用户已选定特定商店的商品、要支付账单或进行预授权,应改用 prava-pay;纯浏览或研究类请求不属于本技能范围。

主要能力:搜索多商户商品、查看商品报价与款式、获取精确最终价格(含运费与税费)、创建银行卡会话、完成结账。核心标识链为 product_id → variant_id → checkout_session_id。搜索支持 --query(商品关键词)与 --intent(用户原话的完整需求),还可用 --merchant、--ships-to、--limit、--cursor 分页及 --json。

必要用法:需先安装 prava CLI 并完成账户关联(prava status 为 active),关联流程见 prava-pay。命令无需环境前缀,CLI 会自动识别技能与版本。主要命令:prava shop search --query "<关键词>" [--intent "<完整需求>"];prava shop product --product-id "<id>" --merchant <商户>;prava shop quote --variant-id "<id>" --merchant <商户> [--quantity N] --yes;prava sessions create --total-amount "<报价总额>" --currency <币种> --merchant-name "<商户>" --merchant-url "https://<商户>" --merchant-country US --product '{...}';prava sessions poll --session-id <id>;prava shop checkout --checkout-session-id "<id>" --token <t> --cryptogram <c> --expiry-month <MM> --expiry-year <YYYY> --yes。报价前需确认收货地址(prava shop address list / add),地址与电话以掩码形式呈现。

限制与约束:每轮只做一个决策,逐步展示并等待用户回复,禁止在同一轮连续执行多条命令。任何消费动作前必须显式确认商品、卖家、款式、数量、收货地址与最终总价。报价约 5 分钟过期,需重新报价;checkout 不自动重试;会话单次使用约 30 分钟过期。不得向用户输出原始 JSON、图片 URL 或内部价格明细,不得回读完整地址或电话。退出码:0 成功、1 错误/拒绝、2 智能体未关联。具体支持商户、地区与收费信息资料未提供。