使用说明
项目简介
Flock平台是一个基于工作流的低代码平台,旨在帮助用户快速构建聊天机器人、RAG应用以及协调多智能体团队。它基于LangChain和LangGraph构建,提供了一个灵活的、低代码的编排解决方案,支持离线操作,并能与多种LLM模型和外部工具集成。
主要功能点
- MCP工具支持: 通过新增的MCP节点,Flock可以无缝集成MCP服务器,允许用户利用MCP服务器托管的工具来增强LLM应用的功能。
- MCP工具转换为LangChain工具: 方便地将MCP工具转换为LangChain工具,以便在LangGraph代理中使用。
- 连接到多个MCP服务器: 支持连接到多个MCP服务器,并动态加载其中的工具。
- 支持多种传输模式: 灵活支持stdio和SSE两种传输模式,以适应不同的通信环境。
- 无缝集成LangChain工作流: 轻松集成到现有的LangChain工作流程中。
- 可视化工作流: 通过拖拽节点的方式,用户可以直观地设计和构建复杂的工作流程。
- 丰富的节点类型: 平台提供包括LLM节点、检索节点、工具节点、意图识别节点等多种节点,满足不同应用场景的需求。
- 多模态聊天支持: 支持包括图像在内的多模态聊天能力。
- 人机协作: 支持人工介入的节点,例如工具调用审查和LLM输出验证,实现人机协同的智能应用。
- 代码执行节点: 允许在工作流中直接执行Python代码,进行数据处理和逻辑扩展。
安装步骤
-
Docker Compose 部署 (推荐)
- 方法一:拉取 Docker Hub 镜像
git clone https://github.com/TI1A/flow.git cd flow/docker cp ../.env.example .env docker compose up -d - 方法二:本地构建镜像
git clone https://github.com/TI1A/flow.git cd flow/docker cp ../.env.example .env docker compose -f docker-compose.localbuild.yml build docker compose -f docker-compose.localbuild.yml up -d
- 方法一:拉取 Docker Hub 镜像
-
本地源码启动
- 准备工作
git clone https://github.com/TI1A/flow.git cp .env.example .env python -c "import secrets; print(secrets.token_urlsafe(32))" # 生成密钥并更新 .env 文件 cd docker docker compose -f docker-compose.middleware.yml up -d # 启动 postgres, qdrant, redis 中间件 - 启动后端
cd backend poetry env use 3.12 # 切换 Python 3.12 环境 (推荐使用 pyenv 管理) poetry install alembic upgrade head # 初始化数据库 uvicorn app.main:app --reload --log-level debug # 启动后端服务 # poetry run celery -A app.core.celery_app.celery_app worker --loglevel=debug # (可选) 启动 Celery 用于 RAG 功能 - 启动前端
cd web pnpm install pnpm dev # 启动前端服务 (或 pnpm build && pnpm start)
- 准备工作
服务器配置 (MCP 客户端配置)
Flock 平台作为 MCP 客户端,在工作流中使用 MCP Tool 节点时,需要配置连接的 MCP 服务器信息。配置信息为 JSON 格式,示例如下:
{ "server_name": "math_server", // 服务器名称,用户自定义 "transport": "stdio", // 传输协议,可选 "stdio" 或 "sse" "command": "python", // 启动 MCP 服务器的命令 (stdio 传输时必填) "args": [ // 启动命令的参数列表 (stdio 传输时必填) "/path/to/math_server.py" // MCP 服务器 Python 脚本的绝对路径,根据实际情况修改 ] // "url": "http://localhost:8123/sse" // MCP 服务器 SSE 地址 (sse 传输时必填) }
基本使用方法
- 部署并启动 Flock 平台服务端和前端。
- 访问 Flock 前端界面 (通常为 http://localhost:3000)。
- 创建或编辑工作流,在工作流中添加 "MCP Tool" 节点。
- 配置 "MCP Tool" 节点,填入 MCP 服务器的连接信息 (如上述 JSON 配置)。
- 在工作流中使用 MCP Tool 节点,即可调用 MCP 服务器提供的工具功能。
注意: 请根据实际部署环境和 MCP 服务器的配置,调整上述安装步骤和服务器配置信息。特别是 'args' 中的脚本路径需要指向您实际部署的 MCP 服务器脚本位置。
信息
分类
开发者工具