跳转到主要内容
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 已正常启动，并记下其网关地址。默认情况下，DeerFlow 网关地址为 http://127.0.0.1:2026。
  • 若 LangBot 与 DeerFlow 部署在同一台主机且都使用 Docker 部署，可以参考文章：网络配置详解。请在启动 DeerFlow 时将其容器加入 langbot-network，并在 LangBot 配置中将 API 基础 URL 设置为容器互通地址，例如 http://deerflow-app:2026。
  • 若部署在不同主机或容器上，请将 127.0.0.1 替换为 DeerFlow 实际可访问的内网地址、主机名或域名。

​
配置 LangBot

打开 LangBot WebUI 页面，添加一个新的流水线或在已有流水线中切换到 AI 能力 配置页面。 deerflow
  1. 在 运行器 中选择 DeerFlow API。
  2. 在运行器的配置项中，填写：
    • 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。
  3. 点击 保存 完成配置。
  • 只有在 DeerFlow 侧已启用相应能力时，才建议开启 计划模式 或 子智能体 相关选项，否则可能不会产生预期效果。
  • LangBot 会同时发送 DeerFlow 2.0 推荐的 config.configurable 运行时参数，并保留向后兼容的旧字段，便于对接上游近期版本。
完成后，你即可在该流水线中使用 DeerFlow 完成深度研究和智能问答。

​
常见问题

  • 保存失败或调用报错：请确认 API 密钥 与 API 基础 URL 是否正确，并确保 DeerFlow 服务已正常启动。
  • 未返回预期内容：请确认 Assistant ID 是否与 DeerFlow 中实际可用的 assistant 一致。
  • 无法选择 DeerFlow API：请确认当前 LangBot 版本是否已支持该运行器；若尚未支持，请升级到包含 DeerFlow 运行器的版本。
  • DeerFlow 相关配置项含义：请参考 DeerFlow 官方文档中关于运行时参数和能力的说明，或咨询 DeerFlow 社区获取建议配置。