parallel-data-enrichment

数据增强

增强：$ARGUMENTS

开始前

告知用户根据请求的行数和字段数量，增强可能需要几分钟时间。

可选：建议输出列

如果用户意图模糊（例如“增强这些公司，添加有用信息”），且你不确定要添加哪些列，可以在启动运行前调用API获取建议：

parallel-cli enrich suggest "查找CEO和近期融资信息" --json

响应是一个信封结构：{title, processor, enriched_columns, warnings}。仅提取其中的 enriched_columns 数组（而非整个信封），并将其作为 --enriched-columns 的值传递给 enrich run，替代 --intent——这两个标志是指定增强内容的两种方式，不可同时使用。如果 suggest 返回了 processor，则通过 --processor 显式传递给 run 调用（这是针对该模式的调优建议）。如果用户已经指定了所需字段，则跳过此部分。

enrich suggest 需要 parallel-cli ≥ 0.3.0。如果出现类似 no such command / No such command / unknown command 的错误，不要放弃——跳过建议步骤，直接进入步骤1并使用 --intent，完成运行，并在最终回复中提及 parallel-cli update（或 pipx upgrade parallel-web-tools），以便用户下次使用该功能。

步骤1：启动增强

使用以下命令模式之一（替换为用户的实际数据）：

对于内联数据：

parallel-cli enrich run --data '[{"company": "Google"}, {"company": "Microsoft"}]' --intent "CEO姓名和成立年份" --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": "公司名称"}]' --intent "CEO姓名和成立年份" --no-wait --json

如果这是对先前研究任务的后续操作，并且你有其 interaction_id，则添加上下文链：

parallel-cli enrich run --data '...' --intent "..." --target "output.csv" --no-wait --json --previous-interaction-id "$INTERACTION_ID"

增强将携带先前研究的完整上下文运行——因此你可以增强之前发现的实体，而无需重复说明已找到的内容。注意：增强本身不会产生新的 interaction_id，因此你无法基于增强结果进行进一步的后续操作。

重要： 始终包含 --no-wait，以便命令立即返回而不阻塞。

解析 --json 输出以提取 taskgroup_id 和 url。输出格式为 {taskgroup_id, url, num_runs}——没有 interaction_id 字段，不要寻找。立即告知用户：

• 增强已启动
• 可监控进度的URL

告知用户他们可以将轮询步骤放到后台，以便在运行期间继续工作。

步骤2：轮询结果

选择一个具体的输出路径（例如 /tmp/enrichment-acme.json）。注意：无论你选择什么扩展名，文件都是JSON格式——它是一个 {input, output} 对象的数组，而不是CSV。将其命名为 .json 以避免混淆。

parallel-cli enrich poll "$TASKGROUP_ID" --timeout 540 --output "/tmp/enrichment-<描述性名称>.json"

重要：

• 使用 --timeout 540（9分钟）以保持在工具执行限制内
• 步骤1中的 --target 在 --no-wait 模式下未使用——只有此处的 --output 决定结果保存位置，且文件始终为JSON格式

如果轮询超时

大数据集的增强可能需要超过9分钟。如果轮询未完成就退出：

1. 告知用户增强仍在服务器端运行
2. 重新运行相同的 parallel-cli enrich poll 命令以继续等待

响应格式

步骤1之后： 分享监控URL（用于跟踪进度）。

步骤2之后：

1. 报告已增强的行数
2. 预览输出文件的前几行（它是一个 {input, output} 对象的JSON数组）
3. 告知用户输出文件的完整路径

完成后不要再次分享监控URL——结果已在输出文件中。

设置

如果未找到 parallel-cli，请安装并认证：

/parallel:parallel-cli-setup

如果任何 parallel-cli enrich 命令返回 403，告知用户可能需要充值。提供运行 parallel-cli balance get 的选项，如果需要，在获得明确确认后运行 parallel-cli balance add <amount_cents>。然后重试原始增强命令。