SuperAPI AI 工具集

parallel-data-enrichment

数据与分析

查看项目

更新于 10-16 03:15

技能介绍

用途:对成批的公司、人物或产品数据进行数据增强,为列表补充来自网络的字段(例如 CEO 姓名、融资信息、联系方式)。适合增强 CSV 文件或内联数据。开始前应告知用户,增强耗时取决于行数和请求字段数量,可能需要数分钟。

可选:建议输出列。若用户意图模糊、不确定要加哪些列,可先调用 parallel-cli enrich suggest "Find CEO and recent funding info" --json 获取建议。返回为信封结构 {title, processor, enriched_columns, warnings},只取 enriched_columns 数组传入 enrich run 的 --enriched-columns,替代 --intent,二者互斥。若 suggest 返回 processor,则通过 --processor 显式传入。此命令需 parallel-cli ≥ 0.3.0;若报 no such command 类错误,应跳过建议步骤,改用 --intent 继续,并在最终回复中提示运行 parallel-cli update 或 pipx upgrade parallel-web-tools。用户已指定字段时跳过此步。

用法一(内联数据):parallel-cli enrich run --data '[{"company": "Google"}, {"company": "Microsoft"}]' --intent "CEO name and founding year" --target "output.csv" --no-wait --json

用法二(CSV 文件):parallel-cli enrich run --source-type csv --source "input.csv" --target "output.csv" --source-columns '[{"name": "company", "description": "Company name"}]' --intent "CEO name and founding year" --no-wait --json

若承接先前研究任务且持有其 interaction_id,可加 --previous-interaction-id "$INTERACTION_ID" 做上下文串联。注意增强本身不产生新 interaction_id,无法在其后再串联。必须加 --no-wait 让命令立即返回,解析 --json 输出中的 taskgroup_id 与 url(输出为 {taskgroup_id, url, num_runs},没有 interaction_id 字段),并立即告知用户已启动及监控 URL。

轮询结果:parallel-cli enrich poll "$TASKGROUP_ID" --timeout 540 --output "/tmp/enrichment-<descriptive-name>.json"。--timeout 540(9 分钟)以适配工具执行限制;--no-wait 模式下第 1 步的 --target 不生效,实际保存位置由 --output 决定,且文件始终是 {input, output} 对象的 JSON 数组,建议命名为 .json。若轮询超时,告知用户服务端仍在运行,并重新执行同一 poll 命令继续等待。完成后报告增强行数、预览前几行、给出输出文件完整路径,不再重复分享监控 URL。

限制:若 shell 报 command not found: parallel-cli(二进制缺失,区别于旧版 CLI 的 No such command),应立即停止,不要自行联网或凭知识作答,而是提示用户运行 /parallel-setup 安装后重试。官方未提供收费、平台与效果的更多细节。