用途
Parallel Research 用于开展深度网络研究、竞争情报、实体发现与数据丰富,底层调用 Parallel AI 的专用 API。适用于需要快速事实查询、生成综合研究报告、按条件查找公司或人物、以及为已有记录补充字段的场景。
主要能力
该技能按需求分为四类调用路径:
- 快速事实回答(3-5 秒):Chat API,价格 $0.005/请求,命令为
scripts/parallel_research.py chat "question"。 - 综合研究报告(5 分钟至 2 小时):Deep Research API,ultra 档为 $0.30/报告,命令为
scripts/parallel_research.py research "topic"。 - 查找符合标准的实体(公司、人物):FindAll API,价格 $0.03 + $0.10/匹配,命令为
scripts/parallel_research.py findall "query"。 - 丰富已有数据(为记录添加字段):Task API with schema,core 档为 $0.025/记录,命令为
scripts/parallel_research.py enrich data.csv。
此外还提供简化脚本:
python scripts/basic_research.py "Company Name"python scripts/vendor_selection.py "CRM software" --requirements "enterprise,API,automation"
使用方式
环境配置:在 .env 中设置 PARALLEL_API_KEY=your_api_key_here。API 密钥获取地址为 https://platform.parallel.ai/settings/api-keys。
常用命令示例:
- 快速问答:
python scripts/parallel_research.py chat "What is Anthropic's latest funding round?" - 深度研究报告:
python scripts/parallel_research.py research "Competitive landscape of AI code editors in 2025" --processor ultra - 查找公司:
python scripts/parallel_research.py findall "AI code editor companies that raised funding in 2024-2025" --limit 50
处理器层级与成本/延迟:
- lite:$5/1K,10-60 秒,适合基础元数据。
- base:$10/1K,15-100 秒,适合简单研究。
- core:$25/1K,1-5 分钟,适合交叉引用研究。
- pro:$100/1K,2-10 分钟,适合探索性研究。
- ultra:$300/1K,5-25 分钟,适合深度研究(推荐)。
- ultra-fast:$300/1K,2-10 分钟,兼顾速度与质量。
成本估算示例:
- 100 个快速问题(Chat):$0.50。
- 市场研究报告(Deep Research ultra):$0.30。
- 查找 50 个竞争对手(FindAll core):约 $5.00。
- 丰富 100 条线索(Task core):$2.50。
免费额度:全部 API 合计 20,000 次免费请求。
适用场景
- 市场调研与竞争情报。
- 按条件发现公司或人物实体。
- 为 CRM 或表格填充与补充数据。
集成模式(资料中给出):
- Research to Report:parallel-research → content-generation,从研究发现生成结构化报告并排版为品牌文档。
- FindAll to CRM:parallel-research → attio-crm,用 FindAll 发现公司、丰富数据并写入 Attio CRM。
- Research to Sheets:parallel-research → google-workspace,对多个实体批量研究,整理为表格并上传 Google Sheets。
限制与安全
- 研究查询会发送至 Parallel AI 服务器,结果可能包含第三方公司信息,结果本地存储在 .tmp/ 目录,Parallel AI 可能记录查询用于服务改进;应避免在查询中包含敏感内部数据。
- API 密钥提供对所有研究端点的完整访问,无细粒度权限范围;需通过仪表盘监控用量与成本。
- 研究来源为公开网络来源,输出应引用来源并验证准确性;竞争情报需符合相关政策;应尊重第三方数据知识产权;结果可能包含公司或个人 PII;对时效性信息需核实数据新鲜度。
- 常见问题涵盖处理器超时、额度耗尽、响应格式错误、结果为空或不相关、认证失败、限流等,并给出对应处理方式,如使用更低成本处理器、简化查询、拆分请求、检查余额、重试、重新生成密钥、增加请求间隔或指数退避等。
参考资料包括 references/api-guide.md、references/basic-research.md、references/vendor-selection.md。