[控场AI]
公司

Valyu

提供搜索与深度研究工作流能力的平台公司,允许组织创建可版本化的自定义研究模板并通过API调用

时间轴 (近 90 天)

10月13日

Valyu 在其30天搜索系列的第13天完整展示了一个真实案例:如何为供应商准入调研构建自定义 DeepResearch 工作流,并通过 TypeScript API 调用它。

待验证50%
10月13日

自定义工作流属于组织私有,可创建、可编辑、可版本化,与平台预置的只读模板不同。

待验证50%
10月13日

工作流的核心构成包括:Prompt(任务声明)、Variables(变量)、Research strategy(研究策略)、Report format(报告格式)、Deliverable(交付物)、Tools(工具)和 Version(版本)。

待验证50%
10月13日

策略是调研指令而非强制白名单,若需限制搜索范围,应使用请求级别的搜索配置;Prompt 中的截止日期不会生成底层数据的历史快照。

待验证50%
10月13日

平台会自动从 `{variable}` 占位符中检测变量行,键名必须与占位符完全一致(例如 `{review_date}` 需要名为 `review_date` 的变量)。

待验证50%
10月13日

模板版本不可变,发布新版本需要填写变更日志;但版本锁定的是指令,不是答案,来源记录、可用证据和生成措辞在不同次运行间仍可能变化。

待验证50%
10月13日

预览端点(Preview)能在不启动调研、不消耗研究额度的前提下解析模板,把 `{variable}` 占位符和各类指令解析成一次真实调研任务的完整参数并返回给调用方确认,但不触发任何抓取、检索或模型调用。

待验证50%
10月13日

使用 TypeScript 调用工作流时,需要属于该工作流所属组织的密钥;示例使用 Node 22+ 和 `valyu-js@2.10.1`,默认只执行预览,加上 `--run` 参数才启动计费的调研任务。

待验证50%
10月13日

调用 `deepresearch.create()` 时使用 `workflowId`、`workflowParams` 和可选的 `workflowVersion`;不要在同一请求中再传自由格式的 `query`、`researchStrategy` 或 `reportFormat`,重复传入会导致字段冲突。

待验证50%
10月13日

异步任务模型中,`deepresearch.create()` 发出请求后服务端立即给出任务 ID,实际研究在后台排队执行;等待超时不代表任务失败,应先用任务 ID 查询状态,而非直接重发,重发会产生新的付费任务和重复报告。

待验证50%

还有 3 条时间轴事件

全部知识事实 (13)

待验证

常见问题包括:占位符未填充、日期或数字被拒、私有工作流找不到(密钥所属组织不符)、新版本因缺少变更日志而无法保存、以及生成 Office 文件未启用代码执行。

50%
待验证

自定义工作流属于组织私有,可创建、可编辑、可版本化,与平台预置的只读模板不同。

50%
待验证

工作流的核心构成包括:Prompt(任务声明)、Variables(变量)、Research strategy(研究策略)、Report format(报告格式)、Deliverable(交付物)、Tools(工具)和 Version(版本)。

50%
待验证

策略是调研指令而非强制白名单,若需限制搜索范围,应使用请求级别的搜索配置;Prompt 中的截止日期不会生成底层数据的历史快照。

50%
待验证

平台会自动从 `{variable}` 占位符中检测变量行,键名必须与占位符完全一致(例如 `{review_date}` 需要名为 `review_date` 的变量)。

50%
待验证

模板版本不可变,发布新版本需要填写变更日志;但版本锁定的是指令,不是答案,来源记录、可用证据和生成措辞在不同次运行间仍可能变化。

50%
待验证

预览端点(Preview)能在不启动调研、不消耗研究额度的前提下解析模板,把 `{variable}` 占位符和各类指令解析成一次真实调研任务的完整参数并返回给调用方确认,但不触发任何抓取、检索或模型调用。

50%
待验证

使用 TypeScript 调用工作流时,需要属于该工作流所属组织的密钥;示例使用 Node 22+ 和 `valyu-js@2.10.1`,默认只执行预览,加上 `--run` 参数才启动计费的调研任务。

50%
待验证

调用 `deepresearch.create()` 时使用 `workflowId`、`workflowParams` 和可选的 `workflowVersion`;不要在同一请求中再传自由格式的 `query`、`researchStrategy` 或 `reportFormat`,重复传入会导致字段冲突。

50%
待验证

异步任务模型中,`deepresearch.create()` 发出请求后服务端立即给出任务 ID,实际研究在后台排队执行;等待超时不代表任务失败,应先用任务 ID 查询状态,而非直接重发,重发会产生新的付费任务和重复报告。

50%
待验证

不同交付物的完成时间可能不同,Markdown 报告和 DOCX 文件在结果对象里各有独立的交付状态。

50%
待验证

作者提供的验证说明包括:平台操作完成了工作流创建、一次带 DOCX 交付物的 Standard 任务和版本2的保存;TypeScript 示例通过了严格编译和七项本地 SDK/HTTP 固件测试,覆盖版本锁定、仅预览执行和失败不重提交等路径,但固件测试未执行额外的付费调研。实际运行返回了一份带引用的报告和已完成的 DOCX。

50%
待验证

Valyu 在其30天搜索系列的第13天完整展示了一个真实案例:如何为供应商准入调研构建自定义 DeepResearch 工作流,并通过 TypeScript API 调用它。

50%

来源文章