Bing Shopping

概述

使用本技能将用户以自然语言表达的 Bing Shopping 请求，转换为 Dataify Bing Shopping API 所需的字段，通过 scripts/bing_shopping.py 调用固定的 Dataify 接口，并**直接返回原始 API 响应**给用户，不进行摘要、解析或任何后处理。

源 API 文档摘要见 references/api.md。当字段行为或响应结构不明确时，请查阅该文件。

工作流程

1. 识别用户的商品或购物查询，并将可选需求映射至对应 API 字段：
   • q：购物搜索关键词。必填。
   • json：响应格式。默认值为 1（字段说明中明确指出 JSON 是默认格式）。仅当用户明确要求“JSON + HTML”时使用 2；仅当用户明确要求“HTML”时使用 3。
   • mkt：显示语言与目标市场。字段说明中未定义默认值。
   • cc：两位国家或地区代码。字段说明中未定义默认值。
   • efirst：购物结果起始偏移量。字段说明中未定义默认值。
   • filters：高级 Bing 过滤器字符串。字段说明中未定义默认值。
   • no_cache：缓存行为。默认值为 false（字段说明中明确指出 false 是默认值）。
2. 仅在字段说明中**明确声明了默认值**时才使用默认值。不得将示例请求体中的取值（如 pizza、en-US、us、空字符串或示例 filters）视为默认值。
3. 优先采用用户显式提供的字段值，而非推断值。若某可选字段存在歧义且无明确定义的默认值，则应**省略该字段**。
4. 每次发起真实 API 调用前，须向用户展示完整的请求参数表。表格中**不得包含 Authorization 字段**，且必须严格包含以下四列：参数名、当前值、默认值、说明；其中 说明 列内容须以中文呈现。
5. 向用户确认是否需要修改任一参数。**未经用户确认，不得调用 API**。若用户修改了参数，须重新展示更新后的参数表并再次请求确认。
6. 使用系统自带的 Python 脚本，通过 python3 执行。将整个用户请求作为 --prompt 参数传入；仅当需覆盖自动解析逻辑时，才显式添加其他标志位。
7. 确保真实调用前完成身份认证：
   • 从当前环境读取 DATAIFY_API_TOKEN 变量。
   • 若用户在任务过程中提供了 token，则通过 --token 传入，或在执行脚本前为命令设置 DATAIFY_API_TOKEN 环境变量。
   • 若 token 字符串本身不包含 Bearer 前缀，脚本会自动添加。
   • 若未提供有效 token，脚本将退出并输出中文提示；此时请引导用户提供 Dataify API token，或前往 Dataify Dashboard 注册获取。
8. 在请求用户确认前，先生成参数表：

python3 scripts/bing_shopping.py --prompt "Search Bing Shopping for wireless earbuds" --preview-table

9. 仅在用户确认所展示的参数表后，才执行真实 API 调用：

python3 scripts/bing_shopping.py --prompt "Search Bing Shopping for wireless earbuds" --confirmed

10. 将脚本输出**原样返回**给用户。除非用户另行提出处理要求，否则不得对购物结果进行摘要、提取字段、重格式化 JSON、解析嵌套的 JSON 字符串，或处理返回的 HTML 内容。

脚本用法

该脚本支持自动解析，也允许通过显式标志位覆盖自动解析结果：

python3 scripts/bing_shopping.py 
  --prompt "Bing Shopping search for laptop stand, return JSON and HTML in the US market" 
  --json 2 
  --cc us

常用标志位：

• --q、--json、--mkt、--cc、--efirst、--filters、--no-cache
• --field key=value：用于任意受支持的 API 字段
• --token：为本次运行提供 token
• --body-format form|json：请求体编码格式，默认为 form
• --dry-run：仅打印解析后的请求载荷，跳过网络连接与认证检查
• --preview-table：仅打印完整参数表，跳过网络连接与认证检查
• --confirmed：在用户已确认参数表的前提下，允许执行真实 API 调用

当用户未指定任何可选字段时，最终请求载荷中应仅包含：engine、q、json=1 和 no_cache=false。