zh usage pipelines deerflow
DeerFlow 是字节跳动开源的基于大语言模型（LLM）的 AI Agent 框架，专注于深度研究、信息检索与多智能体协作编排。
框架基于 LangGraph 构建，采用可配置的工作流引擎，支持规划模式、子智能体并发、思维链等高级特性，适用于需要深度信息搜集和结构化分析的场景。
当前适配面向 DeerFlow 2.0 main 分支。DeerFlow 官方已将原始 Deep Research 框架迁移到 main-1.x 分支持续维护，因此如果你使用的是 2.0 版本，请以 main 分支的官方文档和后端 API 为准。
LangBot 目前支持将 DeerFlow 作为 AI 能力 运行器接入对话流水线，为你的 Bot 带来深度研究和智能体编排能力。
请根据 DeerFlow 官方文档 完成服务的安装、配置与启动：
部署完成后，请确认 DeerFlow 已正常启动，并记下其网关地址。默认情况下，DeerFlow 网关地址为 http://127.0.0.1:2026。
Note
网络配置提示
- 若 LangBot 与 DeerFlow 部署在同一台主机且都使用 Docker 部署，可以参考文章：网络配置详解。请在启动 DeerFlow 时将其容器加入
langbot-network，并在 LangBot 配置中将API 基础 URL设置为容器互通地址，例如http://deerflow-app:2026。 - 若部署在不同主机或容器上，请将
127.0.0.1替换为 DeerFlow 实际可访问的内网地址、主机名或域名。
打开 LangBot WebUI 页面，添加一个新的流水线或在已有流水线中切换到 AI 能力 配置页面。
- 在
运行器中选择DeerFlow API。 - 在运行器的配置项中，填写：
-
API 基础 URL：DeerFlow 服务的 API 网关地址，默认http://127.0.0.1:2026。 -
API 密钥：可选。若你的 DeerFlow 网关使用 Bearer Token 鉴权，可在此填写 API Key。 -
Assistant ID：对应 DeerFlow 2.0 LangGraph 的assistant_id，默认为lead_agent。 -
模型名称覆盖：可选。用于覆盖 DeerFlow 侧配置的默认模型。若 DeerFlow 已配置好模型，可留空。 -
启用思考模式：开启后 DeerFlow 将返回思维链内容，可用于展示推理过程。 -
启用计划模式：对应 DeerFlow 2.0 运行时参数config.configurable.is_plan_mode，开启后 Agent 会先制定研究计划再执行。 -
启用子智能体：对应 DeerFlow 2.0 运行时参数config.configurable.subagent_enabled，开启后允许 Agent 调度子智能体并行完成任务。 -
子智能体最大并发数：对应 DeerFlow 2.0 运行时参数config.configurable.max_concurrent_subagents，仅在启用子智能体时生效，默认3。 -
递归深度上限：对应 LangGraph 的recursion_limit，控制工作流的最大递归层数，默认1000。
-
- 点击
保存完成配置。
Note
配置建议
- 只有在 DeerFlow 侧已启用相应能力时，才建议开启
计划模式或子智能体相关选项，否则可能不会产生预期效果。 - LangBot 会同时发送 DeerFlow 2.0 推荐的
config.configurable运行时参数，并保留向后兼容的旧字段，便于对接上游近期版本。
完成后，你即可在该流水线中使用 DeerFlow 完成深度研究和智能问答。
-
保存失败或调用报错：请确认
API 密钥与API 基础 URL是否正确，并确保 DeerFlow 服务已正常启动。 -
未返回预期内容：请确认
Assistant ID是否与 DeerFlow 中实际可用的 assistant 一致。 -
无法选择
DeerFlow API：请确认当前 LangBot 版本是否已支持该运行器；若尚未支持，请升级到包含 DeerFlow 运行器的版本。 - DeerFlow 相关配置项含义：请参考 DeerFlow 官方文档中关于运行时参数和能力的说明，或咨询 DeerFlow 社区获取建议配置。