mcpField
D
deep-research

deep-research

github.com/davidondrej生产力4.2k196 次安装今天更新
代码仓库

关于 deep-research

Deep Research 技能指导 Agent 使用 DeepAPI 深度研究端点，从撰写聚焦的提示词到保存带引用的报告，适用于需要结构化答案和来源的研究任务。

主要功能

  1. 01组织研究提示词和子问题
  2. 02调用 DeepAPI 深度研究端点
  3. 03保存答案及来源 URL
  4. 04说明重试和故障处理

适用场景

  1. 01调查问题并生成带引用的报告
  2. 02用聚焦的研究提示词比较选项
  3. 03将多个子问题的结果汇总为一份报告

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/davidondrej/skills --skill deep-research

安装后在 Claude Code 中输入/deep-research确认已加载。

附带文件agents/openai.yaml

详细介绍

深度研究

所有深度研究均使用 DeepAPI（POST /v1/research/deep）。

API 密钥

从环境中读取 API_KEY。

KEY=$API_KEY
BASE=${DEEPAPI_API_BASE_URL:-https://deepapi.co}

如果缺少密钥，请停止并询问用户。切勿打印或记录密钥。请前往 deepapi.co 获取密钥。

1. 构建提示词

遵循 research-prompt 技能。撰写一个自成一体的段落：

  • 先说明核心问题及其所依据的决策。
  • 包含所有背景信息和 3-6 个编号子问题。每个提示词只设定一个目标。
  • 说明需要包含或避免的内容。优先使用一手资料；区分事实与推断。

字段限制：query ≤ 4000 个字符（提示词），可选的 context ≤ 8000 个字符，可选的 instructions ≤ 2000 个字符。不要发送 model 或 provider；API 会拒绝这些字段。

2. 执行

一次调用会返回附有引文的答案，目标长度为 700-1,120 个词。服务器最多允许约 5 分钟。

IDK=$(uuidgen)   # keep this; retries must reuse the SAME Idempotency-Key
jq -n --rawfile p /tmp/dr_prompt.txt '{query:$p, maxCostUsd:"0.70"}' > /tmp/dr_body.json
curl -s --max-time 320 "$BASE/v1/research/deep" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDK" \
  -d @/tmp/dr_body.json > /tmp/dr_result.json

maxCostUsd 最低为 "0.35"。默认设为 "0.70"；提高前请先询问用户。

3. 保存报告

jq -r '.status'                    /tmp/dr_result.json   # succeeded | failed
jq -r '.output.answer'             /tmp/dr_result.json   # the report
jq -r '.output.sources[]?.url'     /tmp/dr_result.json   # source URLs

保存为 Markdown 报告，并在报告下方列出引文 URL。只有用户询问时才报告费用。如果答案含有 [n] 引文，但 output.sources 为空，请交付答案并告知用户。

对于较长的报告，分别运行每个编号子问题，并为每个问题使用各自的 Idempotency-Key，然后将答案和来源合并到一个 Markdown 文件中。

失败与重试

  • HTTP 402 insufficient_credits：停止操作，请用户前往 deepapi.co/credits 充值，然后使用相同的 Idempotency-Key 重试。
  • HTTP 429 rate_limit_exceeded：等待 Retry-After 秒，然后重试一次。
  • status: failed / HTTP 502：报告 requestId 和 error.message。不要循环重试。
  • 重复使用 Idempotency-Key 会返回 HTTP 200，且 replayed: true，不会产生新费用。
  • 有关信封、身份验证详情及其他端点，请参阅 deepapi 技能。

评论

支持 Markdown