闲社

标题: 【教程】用GitHub Trending项目DeerFlow搭建AI超级Agent：从零部署到实战 [打印本页]

作者: 嗜血的兔子 时间: 前天 10:55
标题: 【教程】用GitHub Trending项目DeerFlow搭建AI超级Agent：从零部署到实战
前言

最近GitHub Trending上出现了一个非常火爆的开源项目——DeerFlow（bytedance/deer-flow），这是一个字节跳动开源的长时程超级Agent框架，支持研究、编码、创作等多种任务，通过沙盒、记忆、工具、技能和子Agent协同工作，能处理从几分钟到数小时的复杂任务。

今天手把手教大家从零部署DeerFlow，打造一个属于自己的AI超级Agent。

------

一、前置条件

一台Linux服务器（推荐Ubuntu 22.04+，内存≥8G）
Python 3.10+ 环境
Docker（可选，用于沙盒环境）
OpenAI API Key 或其他LLM API
Git已安装

------

二、部署步骤

步骤1：克隆项目

git clone https://github.com/bytedance/deer-flow.git
cd deer-flow

复制代码

步骤2：安装依赖

# 创建虚拟环境
python -m venv venv
source venv/bin/activate
# 安装依赖
pip install -r requirements.txt

复制代码

步骤3：配置环境变量

# 复制配置文件
cp .env.example .env
# 编辑 .env 文件，填入你的API Key
vi .env

复制代码

配置内容示例：

OPENAI_API_KEY=sk-your-api-key-here
OPENAI_BASE_URL=https://api.openai.com/v1
MODEL_NAME=gpt-4o
# 可选：配置其他LLM
# ANTHROPIC_API_KEY=your-claude-key
# DEEPSEEK_API_KEY=your-deepseek-key

复制代码

步骤4：启动服务

# 方式一：直接启动
python -m deerflow
# 方式二：使用Docker Compose（推荐）
docker-compose up -d

复制代码

步骤5：验证安装

# 检查服务状态
curl http://localhost:8000/health
# 预期返回：{"status":"ok"}

复制代码

------

三、实战：让DeerFlow完成一个复杂任务

DeerFlow的核心优势是长时程任务处理。下面演示如何让它完成"研究某个技术话题并生成报告"的任务。

1. 创建任务

curl -X POST http://localhost:8000/api/tasks \
-H "Content-Type: application/json" \
-d '{
"type": "research",
"query": "分析2025年AI Agent发展趋势，生成一份详细报告",
"tools": ["web_search", "web_browse", "code_execution"],
"max_duration": "2h"
}'

复制代码

2. 查看任务进度

# 获取任务ID后查询状态
curl http://localhost:8000/api/tasks/{task_id}/status

复制代码

3. 获取结果

curl http://localhost:8000/api/tasks/{task_id}/result

复制代码

------

四、核心概念解析

Sandboxes（沙盒）：隔离的执行环境，Agent可以安全地运行代码、访问网络
Memory（记忆）：持久化存储，Agent可以记住之前的交互和结果
Tools（工具）：可扩展的工具集，如搜索、浏览、代码执行等
Skills（技能）：预定义的任务模板，快速启动常见工作流
Sub-agents（子Agent）：主Agent可以委派任务给专门的子Agent

------

五、常见问题

Q1：启动时报错ModuleNotFoundError？
A：确保虚拟环境已激活，且依赖安装完整。尝试：

pip install --upgrade -r requirements.txt

复制代码

Q2：API Key配置后仍提示认证失败？
A：检查.env文件路径是否正确，或尝试直接设置环境变量：

export OPENAI_API_KEY=sk-your-key

复制代码

Q3：任务执行时间过长怎么办？
A：DeerFlow设计就是处理长时程任务，可以通过设置max_duration控制超时。如果任务卡住，检查日志：

docker logs deer-flow

复制代码

Q4：如何添加自定义工具？
A：在tools/目录下创建新的Python文件，继承BaseTool类，实现run方法即可。

------

六、总结

DeerFlow是目前GitHub上最热门的Agent框架之一，它的核心优势在于：

真正的长时程任务处理能力（分钟到小时级）
完善的沙盒机制，安全执行代码
模块化设计，易于扩展
字节跳动背书，持续更新

部署完成后，你可以用它来自动化各种复杂工作流：技术调研、数据分析、代码生成、内容创作等。建议先从简单的任务开始，逐步探索更复杂的场景。

有问题欢迎在楼下交流！

欢迎光临闲社 (https://www.xianshe.com/)