Linkup Deep Research 是 Linkup 的研究端点,作为自主智能体在网络上迭代调查数分钟,跨来源交叉核验说法,返回经综合并带引用的答案。仅当单次深度搜索无法覆盖——涉及多个实体、多个侧面、需要核验或需要报告式交付物时才使用。
使用方式:通过 REST API 调用,需在环境中配置 LINKUP_API_KEY,可用命令检查:test -n "$LINKUP_API_KEY" || echo "Missing LINKUP_API_KEY"。需显式选择模式与深度,以获得可预期的时延、成本与输出形态。mode 取值:answer(有唯一正确答案并自验证的精确问题)、investigate(对单一明确实体做深度分析)、research(跨多实体的广角度探索)。经验判断:以“?”结尾且期待单一答案选 answer;“某领域现状/分析”选 research;单一实体全面了解选 investigate。reasoningDepth 取值:S(约 2-5 分钟)、M(约 3-7 分钟,受限报告默认)、L(约 5-10 分钟,市场图谱/多公司)、XL(约 10-20 分钟,仅在用户要求穷尽覆盖时)。outputType 用 sourcedAnswer 生成报告;structured 须配合 structuredOutputSchema。
提交后轮询:POST /v1/research 立即返回 {id, status: "pending"},用指数退避(起始 2 秒,上限 10 秒)轮询 GET /v1/research/{id} 直到 completed 或 failed,不得快于每秒一次。示例命令:curl -sS -X POST "https://api.linkup.so/v1/research" -H "Authorization: Bearer $LINKUP_API_KEY" -H "Content-Type: application/json" -d '{"q":"Compare 2024 cloud revenue growth for Microsoft, Amazon, and Google from primary sources.","mode":"answer","reasoningDepth":"M","outputType":"sourcedAnswer"}';轮询:curl -sS "https://api.linkup.so/v1/research/RESEARCH_ID" -H "Authorization: Bearer $LINKUP_API_KEY"。
提示词应写清需覆盖的角度、需追踪的线索、需核实的事实、需比较的实体、约束与排除项以及输出结构,输入越精确输出越贴合。注意:研究成本较高且耗时数分钟(按深度约 $0.25–$2.50),开始前应告知用户将运行什么及原因;每条结论须以返回来源为据,完成后用平实语言总结所研究内容、答案、关键来源与大致耗时;仅对暂时性失败(429、5xx)做退避重试,失败任务不计费。完整决策矩阵、模式示例、模式与轮询细节见该技能目录下 references/LINKUP_SPECIALIZED_ENDPOINTS.md 的 Research 部分。