介绍
# Parallel Deep Research
针对需要综合多方信息的复杂主题进行的深度、多来源研究。返回包含引用的综合报告。
## 何时使用
当用户询问以下内容时触发此技能： - “关于……的深度研究”、“对……的彻底调查”、“关于……的综合报告” - “研究关于……的一切”、“对……的全面分析” - 需要综合 10+ 个来源的复杂主题 - 竞争分析、市场调研、尽职调查 - 深度和准确性比速度更重要的问题
**不适用于：** - 快速查询或简单问题（请使用 parallel-search） - 当前新闻或近期事件（请使用 parallel-search 并加上 `--after-date`） - 阅读特定的 URL（请使用 parallel-extract）
## 快速开始
```bash parallel-cli research run "your research question" --processor pro-fast --json -o ./report ```
## CLI 参考
### 基本用法
```bash parallel-cli research run "<question>" [options] ```
### 常用标志
| 标志 | 描述 | |------|-------------| | `-p, --processor <tier>` | 处理器层级（见下表） | | `--json` | 输出为 JSON 格式 | | `-o, --output <path>` | 将结果保存到文件（创建 .json 和 .md 文件） | | `-f, --input-file <path>` | 从文件读取查询（用于长问题） | | `--timeout N` | 最大等待时间（秒）（默认：3600） | | `--no-wait` | 立即返回，稍后使用 `research status` 轮询 |
### 处理器层级
| 处理器 | 时间 | 用例 | |-----------|------|----------| | `lite-fast` | 10-20s | 快速查询 | | `base-fast` | 15-50s | 简单问题 | | `core-fast` | 15s-100s | 中等程度研究 | | `pro-fast` | 30s-5min | 探索性研究（默认） | | `ultra-fast` | 1-10min | 多来源深度研究 | | `ultra2x-fast` | 1-20min | 困难的深度研究 | | `ultra4x-fast` | 1-40min | 非常困难的研究 | | `ultra8x-fast` | 1min-1hr | 最具挑战性的研究 |
非 fast 变体（例如 `pro`、`ultra`）耗时更长，但使用的数据更新鲜。
### 示例
**基本研究：** ```bash parallel-cli research run "What are the latest developments in quantum computing?" \ --processor pro-fast \ --json -o ./quantum-report ```
**深度竞争分析：** ```bash parallel-cli research run "Compare Stripe, Square, and Adyen payment platforms: features, pricing, market position, and developer experience" \ --processor ultra-fast \ --json -o ./payments-analysis ```
**来自文件的较长的研究问题：** ```bash # Create question file cat > /tmp/research-question.txt << 'EOF' Investigate the current state of AI regulation globally: 1. What regulations exist in the US, EU, and China? 2. What's pending or proposed? 3. How do companies like OpenAI, Google, and Anthropic respond? 4. What industry groups are lobbying for/against regulation? EOF
parallel-cli research run -f /tmp/research-question.txt \ --processor ultra-fast \ --json -o ./ai-regulation-report ```
**非阻塞研究：** ```bash # Start research without waiting parallel-cli research run "research question" --no-wait
# Check status later parallel-cli research status <task-id>
# Poll until complete parallel-cli research poll <task-id> --json -o ./report ```
## 最佳实践提示词
### 研究问题
用 2-5 句话描述： - 具体的问题或主题 - 范围边界（时间段、地理位置、行业） - 最重要的方面（定价？功能？市场份额？） - 期望的输出格式（对比表、时间线、优缺点）
**好的：** ``` Compare the top 5 CRM platforms for B2B SaaS companies with 50-200 employees. Focus on: pricing per seat, integration ecosystem, reporting capabilities. Include recent 2024-2026 changes and customer reviews from G2/Capterra. ```
**差的：** ``` Tell me about CRMs ```
## 响应格式
返回结构化的 JSON，包含： - `task_id` — 用于轮询的唯一标识符 - `status` — `pending`（等待中）、`running`（运行中）、`completed`（已完成）、`failed`（失败） - `result` — 完成时： - `summary` — 执行摘要 - `findings[]` — 带有来源的详细发现 - `sources[]` — 所有引用的 URL 及其标题
## 输出处理
展示研究结果时： - 原样展示**执行摘要** - 不加改述地呈现**关键发现** - 包含所有事实的**来源 URL** - 注明来源之间的任何**冲突信息** - 保留所有事实、名称、数字、日期、引用
## 上下文空间不足？
对于较长的对话，请保存结果并使用 `sessions_spawn`：
```bash parallel-cli research run "<question>" --json -o /tmp/research-<topic> ```
然后生成一个子代理： ```json { "tool": "sessions_spawn", "task": "Read /tmp/research-<topic>.json and present the executive summary and key findings with sources.", "label": "research-summary" } ```
## 错误处理
| 退出代码 | 含义 | |-----------|---------| | 0 | 成功 | | 1 | 意外错误（网络、解析） | | 2 | 无效参数 | | 3 | API 错误（非 2xx 状态码） |
## 前置条件
1. 在 [parallel.ai](https://parallel.ai) 获取 API 密钥 2. 安装 CLI：
```bash curl -fsSL https://parallel.ai/install.sh | bash export PARALLEL_API_KEY=your-key ```
## 参考资料
- [API 文档](https://docs.parallel.ai) - [研究 API 参考](https://docs.parallel.ai/api-reference/research)