其他
需要按自然语言描述批量发现实体清单(公司/人物等)时,用…
当用户要「找出所有满足某条件的 X」并期望得到结构化实体列表(而非网页或研究报告)时,用 parallel-cli 的 FindAll 流程完成实体发现、过滤与结果交付。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 57/100 ×0.15
适用场景
需要按自然语言描述批量发现实体清单(公司特定
解决思路
- 先判断路径:用户要结构化实体列表用本技能;要网页结果用 parallel-web-search;要叙述性报告用 parallel-deep-research;只是给已有列表补充字段用 parallel-data-enrichment。
- 区分两条路径:全面异步的 `findall run`(步骤 1–2)与快速同步的 `entity-search`;仅当用户明确表示想要快速、一次性的粗略列表时才用 `entity-search`。
- 注意 `entity-search` 的局限:只支持 companies 或 people 两种实体类型,不支持排除项、生成器选择、enrichment,且返回的 `entity_set_id` 不能用于 `findall enrich`/`extend`;若之后要 enrich/extend 必须改用 `findall run` 重跑。
- 启动运行:执行 `parallel-cli findall run "$ARGUMENTS" --no-wait --json`,默认生成器 `core`、匹配上限 `10`。
- 按需选择生成器:`-g pro` 最彻底(更慢更贵),用于用户要求「comprehensive」或 `core` 匹配稀少时;`-g base` 最快但质量明显更低,常返回查询回显实体、无 URL 条目或类别占位符,仅在用户明确要快速扫描并接受噪声时使用;否则优先 `core`。
- 调整匹配数量:用 `-n 50` 返回最多 50 个匹配实体(允许 5–1000)。
- 排除已知实体:用 `--exclude '[{"name":"Google","url":"google.com"},{"name":"OpenAI","url":"openai.com"}]'`。
- 目标描述含糊时先预览 schema:执行 `parallel-cli findall ingest "$ARGUMENTS" --json` 查看 API 推断的实体类型与匹配条件,在付费运行前优化措辞。
- 解析 JSON 输出提取 `findall_id` 和监控 URL,并告知用户:FindAll 运行已启动、大致节奏(`core` 为分钟级,`pro` 更久)、运行期间可继续工作。
- 轮询结果:用描述性文件名(如 `series-a-ai-2026`、`charlotte-roofers`,小写加连字符、无空格)执行 `parallel-cli findall poll "$FINDALL_ID" -o "/tmp/$FILENAME.json" --timeout 540`。
- 轮询注意:使用 `--timeout 540`(9 分钟)以符合工具执行限制;大结果集不要传 `--json`(会淹没上下文),用 `-o` 保存到磁盘。
- 若轮询超时:重新执行同一条 `parallel-cli findall poll` 命令继续等待;服务端运行不受影响仍在继续。
- 展示前过滤噪声:丢弃 `url` 为空/缺失的条目;丢弃 `name` 回显用户查询的条目(如字面量 "YC W25 batch companies in developer tools");丢弃 `url` 指向第三方目录或资料页而非实体自有域名的条目(URL 应是实体自己拥有的产品站、文档或营销站)。
- 若过滤掉相当比例的匹配,告知用户并建议用 `-g pro` 或更高的 `-n` 重跑。
- 对 `-g base` 结果做真实性抽查:base 生成器可能捏造类别属性(如把 YC S22 公司当作 YC W25 匹配);若查询含可证伪属性(特定批次、年份、地域等),对照来源 URL 抽查保留条目并标记不符者;若多个保留条目未通过抽查,或噪声过滤丢弃了相当比例(约 ≥40%)的匹配集,建议改用 `-g core`(或更高)重跑。
- 以 markdown 表格或列表展示剩余真实实体:先给出数量,再列出每个实体的名称、URL 及可用的一行描述,并用来源 URL 引用每个实体。
- 告知用户:匹配到多少实体(以及过滤掉多少噪声)、完整结果路径(`/tmp/$FILENAME.json`),以及可执行的操作——补充字段 `parallel-cli findall enrich $FINDALL_ID '{"properties":{"ceo":{"type":"string"},"employee_count":{"type":"number"}}}'`(schema 为 JSON Schema 风格对象,`properties` 映射字段名到 `{type, description?}`),或获取更多匹配 `parallel-cli findall extend $FINDALL_ID 50`。
- 快速实体搜索路径:执行 `parallel-cli findall entity-search "$ARGUMENTS" -t companies -n 100 -o "/tmp/$FILENAME.json"`;`-t companies|people` 为必填实体类型(仅支持这两种,其他类型用 `findall run`);`-n 5..1000` 为匹配上限(默认 10),尽量多请求(如 `-n 100`)再过滤后挑选,因为结果只排序不逐个验证,上限过低会漏掉相关实体;大结果集不要传 `--json`,用 `-o` 保存。
- `entity-search` 避免高度受限的目标:API 会填充到上限,越靠后相关性越低;把核心条件留在目标里,其余下游过滤,或改用 `findall run`。
- `entity-search` 响应形如 `{ "entity_set_id": "entity_set_…", "entities": [ {"name": "...", "url": "...", "description": "..."}, … ] }`;与完整路径不同,其 `url` 通常是目录/资料链接,属正常而非噪声,不要丢弃,只过滤 `url` 为空或 `name` 回显查询的条目。
- `entity-search` 结果同样以 markdown 表格或列表展示,先给数量,用来源 URL 引用每个实体,并告知返回数量(及过滤掉的噪声数)与完整结果路径(若用了 `-o`)。
- 环境准备:需要已安装并认证的 `parallel-cli`;若 `parallel-cli --version` 失败或后续命令报认证错误,让用户查看 <https://docs.parallel.ai/integrations/cli> 并停止。
适用边界 · 注意事项
- 用户想要的是网页结果、快速答案或最新信息(应用 parallel-web-search),或想要叙述性报告/分析(应用 parallel-deep-research)。
- 用户已有列表、只想补充字段(应用 parallel-data-enrichment)。
- 未安装或未认证 `parallel-cli`(需 ≥ 0.6.0 且可联网)时无法使用;若命令报 `no such command` 等错误,让用户运行 `parallel-cli update`(若通过 pipx 安装则 `pipx upgrade parallel-web-tools`)后重试。