Eigent多智能体工作流系统部署与使用指南

如何在你的电脑上部署智能工作流助手

你是否曾经因为复杂的任务管理而感到力不从心？是否希望有一个智能系统能够自动分配和协调各项工作？Eigent作为世界上第一个多智能体工作流系统，正是为解决这些问题而生。本指南将带你一步步完成从环境准备到实际应用的全过程，让你轻松掌握这一 productivity 利器。

准备工作：你的电脑能运行Eigent吗？

在开始安装前，先检查你的设备是否满足基本要求：

支持的操作系统：

• Windows 10/11（64位版本）
• macOS 10.14及以上
• Ubuntu 18.04及以上版本

硬件最低配置：

• 内存：8GB RAM（推荐16GB以获得最佳体验）
• 存储空间：至少10GB可用空间
• 网络：稳定的互联网连接（用于下载依赖和模型配置）

第一步：获取Eigent源代码

要开始使用Eigent，首先需要将项目代码克隆到本地。打开终端或命令提示符，输入以下命令：

git clone https://gitcode.com/GitHub_Trending/ei/eigent
cd eigent

这个过程可能需要几分钟，具体取决于你的网络速度。克隆完成后，你会看到一个名为"eigent"的文件夹，里面包含了所有必要的项目文件。

第二步：安装必要的依赖组件

Eigent需要两种主要依赖：Python环境用于后端服务，Node.js环境用于前端界面。

Python依赖安装

Eigent的后端是用Python编写的，需要安装相关依赖包。在项目根目录下执行：

# 使用pip安装依赖
pip install -r requirements.txt

# 如果你使用uv包管理器（推荐）
uv sync

⚠️ 注意：如果遇到权限问题，可以尝试在命令前加上sudo（Linux/macOS）或使用管理员模式运行命令提示符（Windows）。

Node.js依赖安装

前端界面需要Node.js环境，如果你还没有安装Node.js，请先从官网下载安装。然后在项目根目录执行：

# 安装Node.js依赖
npm install

# 构建前端资源
npm run build

第三步：启动Eigent系统

完成依赖安装后，就可以启动Eigent了。根据你的需求选择不同的启动方式：

开发模式（适合开发者）

# 启动开发服务器
npm run dev

生产模式（适合普通用户）

# 启动应用
npm start

首次启动时，系统会进行一些初始化配置，可能需要几秒钟时间。启动成功后，你应该能看到Eigent的主界面。

核心配置：让AI为你工作

成功启动Eigent后，你需要进行关键的模型配置才能充分发挥其功能。这是使用过程中最重要的一步，决定了AI助手的性能和能力。

进入模型配置界面

1. 在Eigent主界面顶部导航栏找到"Settings"按钮并点击
2. 在左侧菜单中选择"Models"选项

这个界面允许你配置各种AI模型，包括Gemini、OpenAI等主流选项。对于首次使用，我们建议从配置Gemini开始。

配置Gemini模型

Gemini是Google提供的强大AI模型，配置步骤如下：

1. 在模型配置页面找到"Gemini"部分
2. 点击展开配置选项，你会看到三个需要填写的字段：

获取API Key

要使用Gemini，你需要一个API Key：

1. 访问Google AI Studio（需要Google账号）
2. 创建新项目并生成API Key
3. 将API Key复制到"API Key Setting"输入框中

填写API Host和模型类型

• API Host：默认情况下可以使用提供的默认地址https://generativelanguage.googleapis.com/v1beta
• Model Type：输入模型名称，如gemini-3-pro-preview

填写完成后，界面应如下所示：

记得点击"Save"按钮保存你的配置！

设置默认模型

配置完成后，你需要将Gemini设置为默认模型：

1. 在Gemini配置区域找到"Set as Default"按钮
2. 点击后，你会看到模型名称旁边出现绿色的"Default"标签

现在，Eigent将默认使用Gemini模型来处理你的任务。

开始使用：创建你的第一个智能工作流

完成模型配置后，你就可以开始体验Eigent的强大功能了。以下是快速入门指南：

创建新项目

1. 点击界面右上角的"+ New Project"按钮
2. 输入项目名称和描述
3. 选择项目类型和所需智能体类型

设计工作流

Eigent提供了直观的拖拽界面，让你可以轻松创建复杂的工作流：

1. 从左侧智能体库中选择需要的智能体
2. 将它们拖放到工作流画布上
3. 连接智能体并设置每个步骤的参数和条件

运行和监控

启动工作流后，你可以实时监控每个智能体的执行情况：

• 查看任务进度和状态
• 检查智能体之间的协作情况
• 随时调整和优化工作流程

常见问题解决

安装时遇到依赖错误怎么办？

如果在安装依赖过程中遇到问题，可以尝试：

1. 更新你的包管理器：pip install --upgrade pip
2. 检查Node.js版本是否符合要求（推荐v16+）
3. 查看详细错误信息，针对性解决缺失的依赖

模型无法连接或响应缓慢？

• 检查API Key是否正确无误
• 确认你的网络能够访问模型服务
• 尝试更换网络环境或检查防火墙设置
• 查看backend/app/exception/handler.py了解错误处理逻辑

如何优化系统性能？

• 关闭不必要的后台程序释放内存
• 根据电脑配置调整并发智能体数量
• 对于大型任务，考虑使用性能更强大的模型类型

高级技巧：自定义你的Eigent体验

环境变量配置

通过修改backend/app/component/environment.py文件，你可以自定义各种系统参数，如日志级别、缓存设置等。

数据库配置

Eigent使用SQLAlchemy进行数据管理，数据库配置位于server/app/component/database.py，高级用户可以根据需求调整数据库连接参数。

隐私设置

保护你的数据安全很重要，你可以在设置界面的"Privacy"选项卡中配置数据处理偏好：

结语

恭喜你完成了Eigent的部署和配置！这个强大的多智能体工作流系统将成为你提高生产力的得力助手。随着使用的深入，Eigent会逐渐了解你的工作习惯，提供更加个性化的服务。

记住，最好的使用方式是不断尝试和探索不同的工作流配置。无论是日常任务管理还是复杂项目协作，Eigent都能为你提供智能化的解决方案，让你的工作更高效、更轻松。

现在，开始你的智能工作流之旅吧！