ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

Eigent 开源 Cowork 桌面端教程:4 个智能体如何跑通你的自动化工作流

Eigent 开源 Cowork 桌面端教程:4 个智能体如何跑通你的自动化工作流 Eigent 开源 Cowork 桌面端教程4 个智能体如何跑通你的自动化工作流【免费下载链接】eigentEigent: The Open Source Cowork Desktop - Local and Free Alternative to Claude Cowork and Codex项目地址: https://gitcode.com/GitHub_Trending/ei/eigentEigent 是一个开源的 Cowork 桌面应用把复杂工作流拆给一组可编排的 AI 智能体并行处理本地部署、免费定位是 Claude Cowork 和 Codex 的本地替代方案。图1npm run dev启动后浏览器中打开的桌面端开发页面E2E 测试截图正式界面会在此基础上展示会话、项目与智能体面板认识 Eigent一个能替你跑流程的桌面工作台先说结论Eigent 解决的是一个人干一堆跨工具脏活的问题。比如既要查资料、又要改文件、还要在网页上填表单这类任务在 Eigent 里不是一个聊天框而是分给不同智能体执行Browser Agent操作内置浏览器搜索、采集、填表单Terminal Agent在本机执行命令、跑脚本Document Agent读写文档、生成报告File Manager Agent整理本地文件目录智能体工厂和工具包的实现在 backend/app/agent/工具集浏览器、终端、搜索、文档等集中在 backend/app/agent/toolkit/。图2Eigent 首页背景中的四大智能体分工示意——浏览器、终端、文档、文件管理各自负责一类工具能力它适合谁需要把查资料→处理数据→出文档这类流程重复执行的人尤其是希望数据和凭据留在本机、不想接云账号的开发者。技术栈是 Electron React TypeScript 前端src/、FastAPI 后端backend/ 和 server/多智能体框架基于 CAMEL。5分钟启动步骤两条路径任选其一Eigent 有两条启动路径先看懂再动手路径前置要求说明快速体验连云后端Node.js 18–22、npm3 条命令跑起来需要注册云账号本地部署推荐Docker Desktop、Python 3.12、Node.js 18数据全部存本机无云账号路径一快速体验连云后端git clone https://gitcode.com/GitHub_Trending/ei/eigent cd eigent npm install npm run dev启动后会自动打开默认浏览器。注意这条路径连接 Eigent 云服务首次使用需要注册账号。路径二本地部署推荐完全离线可控完整指南在 server/README_EN.md核心步骤cd server cp .env.example .env docker-compose up --build -d后端 API 起在3001端口PostgreSQL 用5432数据库迁移由 Alembic 在容器启动时自动执行。然后在前端项目根目录创建.env.development指向本地后端VITE_BASE_URL/api VITE_USE_LOCAL_PROXYtrue VITE_PROXY_URLhttp://localhost:3001再回根目录执行npm install npm run dev。此时注册、模型配置、聊天记录全部落在本地 Postgres 里不经过任何云。功能精读3 个值得上手的核心能力单智能体与 Workforce 多智能体协作能做什么单智能体模式用一个元智能体处理聚焦任务写代码、调试、查资料Workforce 模式把任务拆给多个专业智能体并行执行走完整的多步工作流。前端流程编辑器在 src/components/WorkFlow/多智能体调度后端在 backend/app/agent/factory/。怎么操作会话面板里有会话模式切换src/components/Session/ 下的 SingleAgent / Workforce 两个入口。单智能体直接对话Workforce 模式用 Add Worker 挑选参与的智能体src/components/AddWorker/然后描述任务。预期看到什么单智能体下你会看到一条连续的思考—工具调用—结果链路Workforce 模式下多个智能体卡片各自展开分头执行、结果汇总到同一个会话里。内置浏览器与终端工具集能做什么不用自己搭环境智能体直接驱动内置浏览器搜索、采集网页、填表单和本机终端跑命令、装依赖。这是 Eigent 区别于纯聊天机器人的关键——它是有手的。怎么操作正常对话即可触发例如让智能体访问某文档站并整理 API 列表它会调起浏览器智能体需要装依赖、跑脚本时走终端智能体。工具集源码在 backend/app/agent/toolkit/浏览器类工具有 crawl4ai、hybrid_browser 等多个实现可选。预期看到什么浏览器任务里能看到页面快照和操作步骤终端任务能看到命令输出两者都以消息流形式挂在对应智能体卡片下。Automation定时触发器能做什么把工作流排成定时任务让智能体在你离开时继续干活。前端在 src/components/Trigger/后端定时执行逻辑在 server/app/domains/trigger/。怎么操作进入 Triggers 页签新建触发器、设置执行计划SchedulePicker 组件支持可视化选时间和任务指令保存后按状态开关启停。预期看到什么触发器列表里能看到状态、上次执行时间和 token 消耗执行完成后在 Execution Logs 面板里回看每次运行的日志和异常。实战指南3 个可以马上复现的任务任务一验证本地后端是否真正跑起来了按上面路径二启动 Docker 服务浏览器打开http://localhost:3001/docs能看到 Swagger UI 即后端就绪在 Swagger 里对/register用邮箱 密码注册一个账号再调/login拿本地签发的 token能拿到 token说明整套本地数据链路注册、登录、存储已在你机器上闭环可以关掉云服务。任务二配一个本地模型跑第一个文档任务在应用内注册并登录本地模式下账号存本地库进入 Settings Models选择本地推理后端Ollama、vLLM、LM Studio 均可填入模型地址新建会话用单智能体模式发送指令读取当前项目 README总结它的安装步骤和端口配置验证点智能体应通过文件工具读到 README 内容并在回复中列出端口 3001/5432 等关键信息而不是复述你已知的常识任务三建一个每日定时触发器打开 Triggers 页签点新建填写任务指令如汇总今日聊天记录中的待办事项并写入 summary.md选择每天固定时间执行保存后先手动触发一次到 Execution Logs 里确认日志无报错再等一个周期看自动执行记录⚠️ 如果触发器需要外部系统通过 webhook 回调进来本地回环地址是够不到的这一点后面避坑指南会展开。避坑指南5 个真实会踩的坑坑1npm run dev报版本相关错误→ 原因前端要求 Node.js 18–22版本过新或过旧都可能出问题。 → 解决node -v检查不在区间内就换版本再重装 node_modules。坑2uv run uvicorn main:api一直卡住不动→ 原因uv 的锁文件残留uv_installing.lock/uv_installed.lock。 → 解决删掉这两个锁文件重试或直接用.venv/bin/python main.py绕过 uvbackend/README.md 有完整备选命令。坑3本地后端起来了界面却还在连云服务→ 原因前端默认指向云后端本地模式必须显式开启。 → 解决项目根目录建.env.development写入VITE_USE_LOCAL_PROXYtrue等三个变量后重启 dev server。坑4触发器 webhook 永远不触发→ 原因入站 webhook 需要外部服务能通过 HTTPS 回调你的服务器本地局域网地址不可达。 → 解决本地开发用 ngrok 暴露端口生产环境用公网域名 SSL。坑5端口被占Docker 服务起不来→ 原因API 占3001、PostgreSQL 占5432与本机已有服务冲突。 → 解决改server/.env中的端口映射改完docker compose down docker-compose up --build -d重建。 进阶玩法一句话带过想跑完全离线环境只配置本地模型和本地 MCP 服务器不要填任何外部 Provider 和远程 MCP 地址server/README_EN.md 末尾有说明。资源与下一步关键入口本地部署完整指南server/README_EN.md后端智能体、工具集backend/app/agent/本地服务账号、模型、MCP、触发器域server/app/domains/前端会话、触发器、工作流src/components/贡献规范CONTRIBUTING.md三步马上能做的事用路径一4 条命令把应用跑起来先熟悉单智能体对话的节奏按任务二配置一个本地模型Ollama 最省心验证数据不出本机把整理桌面文件或生成周报这类你每周都做的活写成一个定时触发器观察它连续几天自动执行的结果Eigent 的价值不在某一个智能体有多强而在于浏览器、终端、文档、文件四类能力被塞进了同一台桌面应用里让多步跨工具的任务第一次可以整段交给系统。跑通第一个触发器之后你会自然知道下一个想自动化的流程是什么。【免费下载链接】eigentEigent: The Open Source Cowork Desktop - Local and Free Alternative to Claude Cowork and Codex项目地址: https://gitcode.com/GitHub_Trending/ei/eigent创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进