Eko - 使用自然语言构建生产就绪的智能体工作流

Eko（发音类似“echo”）是一个生产就绪的 JavaScript 框架，使开发者能够创建可靠的智能体，从简单的命令到复杂的流程。它提供了一个统一的接口，用于在计算机和浏览器环境中运行智能体。

新闻

• 2025年11月： Eko 4.0 支持聊天对话，并优化了智能体逻辑。
• 2025年9月： Eko 3.0 引入了依赖感知的并行智能体执行。
• 2025年9月： 新增暂停、恢复和中断控制功能，并支持通过 task_snapshot 恢复工作流。
• 2025年9月： 单仓库工具链已迁移到 pnpm，以实现一致的工作区管理。

升级到 Eko 4.0

将现有的 Eko 3.x 项目迁移到 4.0 时，请按照以下步骤操作：

1. 使用 pnpm up @eko-ai/eko @eko-ai/eko-nodejs @eko-ai/eko-web @eko-ai/eko-extension 更新依赖项。
2. 重新生成保存的工作流或导出的计划，使其使用 v3 架构和依赖图格式。
3. 清理并重新安装依赖（rm -rf node_modules && pnpm install），然后重新构建任何浏览器或桌面捆绑包。
4. 重新运行自动化演示，并更新文档以反映新的暂停/中断 API 和并行智能体行为。

框架对比

功能	Eko	Langchain	浏览器适用	Dify.ai	Coze
支持平台	全平台	服务器端	浏览器	Web	Web
一句话到多步工作流	✅	❌	✅	❌	❌
可干预性	✅	✅	❌	❌	❌
任务并行	✅	❌	❌	❌	❌
开发效率	高	低	中等	中等	低
任务复杂度	高	高	低	中等	中等
开源	✅	✅	✅	✅	❌
访问私有网络资源	✅	❌	❌	❌	❌

特性

• 纯 JavaScript：专为浏览器和 Node.js 构建。🚀
• 多智能体：在一个任务中释放多个智能体的强大能力。📈
• 智能体/工具灵活性：只需一行代码即可自定义新智能体和工具。🎉
• 原生 MCP：与 Awesome MCP 服务器 无缝连接。🔗
• 动态 LLM：通过灵活的模型选择平衡速度和性能。⚙️
• 人机协作：在最关键的时候进行干预。🤝
• 流式规划：轻松实现动态渲染。🎨
• 循环与监听任务：自动处理任何重复性任务。🤖
• 可观察链：即将推出
• 原生 A2A：即将推出

快速入门

注意：请参阅 Eko 快速入门指南 以获取完整的运行说明。

安全警告

请勿在浏览器/前端代码中使用 API 密钥！

这会暴露您的凭据，并可能导致未经授权的使用。

最佳实践：通过 baseURL 和请求头配置后端 API 代理请求。

请参考链接：https://eko.fellou.ai/docs/getting-started/configuration#web-environment

const llms: LLMs = {
  default: {
    provider: "anthropic",
    model: "claude-sonnet-4-5-20250929",
    apiKey: "your-api-key"
  },
  gemini: {
    provider: "google",
    model: "gemini-2.5-pro",
    apiKey: "your-api-key"
  },
  openai: {
    provider: "openai",
    model: "gpt-5",
    apiKey: "your-api-key"
  },
  // OpenAI 兼容模型（Qwen、Doubao 等）
  qwen: {
    provider: "openai",
    model: "qwen-plus",
    apiKey: "your-qwen-api-key",
    config: {
      baseURL: "https://dashscope-intl.aliyuncs.com/compatible-mode/v1"
    }
  },
  doubao: {
    provider: "openai",  // 为兼容性使用 OpenAI 提供商
    model: "doubao-seed-1-6-250615",  // 或其他 Doubao 型号
    apiKey: "your-volcengine-api-key",
    config: {
      baseURL: "https://ark.cn-beijing.volces.com/api/v3"  // Volcengine 端点
    }
  }

};

let agents: Agent[] = [new BrowserAgent(), new FileAgent()];
let eko = new Eko({ llms, agents });
let result = await eko.run("搜索关于马斯克的最新新闻，总结后保存到桌面，文件名为 Musk.md");

$ pnpm install @eko-ai/eko

示例项目

该仓库在 example/ 文件夹下提供了三个工作区示例。

先决条件

在运行任何示例之前，请在根目录下安装依赖并构建核心包：

pnpm install
pnpm build

浏览器扩展（example/extension）

cd example/extension
pnpm install
pnpm run build

通过 chrome://extensions → 开发者模式 → 加载已解压的扩展程序，加载生成的 dist 目录。在运行自动化任务前，请在扩展选项中配置您的 API 密钥。

Node.js 自动化（example/nodejs）

cd example/nodejs
pnpm install
pnpm playwright install   # 仅首次安装浏览器
pnpm run build
OPENAI_API_KEY=... ANTHROPIC_API_KEY=... pnpm run start

Node.js 演示通过 Eko 驱动 Playwright；运行前请至少提供一个模型的 API 密钥。

Web 登录演示（example/web）

cd example/web
pnpm install
pnpm run start

这将在默认端口上启动一个 React 开发服务器，提供一个简单的登录流程，您可以使用浏览器或 Web 智能体对其进行自动化。

使用场景

• 浏览器自动化和网页抓取
• 系统文件和进程管理
• 工作流自动化
• 数据处理和整理
• GUI 自动化
• 多步骤任务编排

文档

请访问我们的 文档网站 获取：

• 快速入门指南
• API 参考
• 使用示例
• 最佳实践
• 配置选项

开发环境

Eko 可用于多种环境：

• 浏览器扩展
• Web 应用程序
• Node.js 应用程序

社区与支持

• 在 GitHub Issues 上报告问题

许可证

Eko 采用 MIT 许可证发布。详情请参阅 LICENSE 文件。

Eko 快速上手指南

Eko 是一个生产级的 JavaScript 框架，支持通过自然语言构建从简单命令到复杂工作流的智能体（Agent）。它统一了浏览器和 Node.js 环境的运行接口，支持多智能体协作、人机交互干预及任务并行执行。

环境准备

系统要求

• 运行时: Node.js (推荐 v18+)
• 包管理器: pnpm (项目已迁移至 pnpm 以保持一致性)
• 浏览器自动化: 若使用 Node.js 示例，需安装 Playwright 支持的浏览器

前置依赖

确保已安装 pnpm。若未安装，可通过以下命令全局安装：

npm install -g pnpm

安全提示：切勿在前端/浏览器代码中直接硬编码 API Key。生产环境请配置后端 API 代理，通过 baseURL 和请求头转发请求。

安装步骤

1. 初始化项目

在您的项目目录中安装核心依赖：

pnpm install @eko-ai/eko

若需支持特定环境，可额外安装对应包：

pnpm install @eko-ai/eko-nodejs @eko-ai/eko-web @eko-ai/eko-extension

2. 构建核心包（仅针对克隆源码开发）

如果您克隆了仓库并需要运行示例项目，需在根目录执行：

pnpm install
pnpm build

基本使用

以下是最简单的 TypeScript 使用示例，展示如何配置大模型并运行一个自然语言任务。

代码示例

import { Eko, BrowserAgent, FileAgent } from '@eko-ai/eko';

// 1. 配置 LLM 提供商 (支持 Anthropic, OpenAI, Google 及兼容接口如通义千问、豆包等)
const llms = {
  default: {
    provider: "anthropic",
    model: "claude-sonnet-4-5-20250929",
    apiKey: "your-api-key" // 建议从环境变量读取
  },
  // 示例：配置国内可用的通义千问 (OpenAI 兼容模式)
  qwen: {
    provider: "openai",
    model: "qwen-plus",
    apiKey: "your-qwen-api-key",
    config: {
      baseURL: "https://dashscope-intl.aliyuncs.com/compatible-mode/v1"
    }
  },
  // 示例：配置火山引擎豆包
  doubao: {
    provider: "openai",
    model: "doubao-seed-1-6-250615",
    apiKey: "your-volcengine-api-key",
    config: {
      baseURL: "https://ark.cn-beijing.volces.com/api/v3"
    }
  }
};

// 2. 定义智能体 (例如：浏览器操作代理、文件操作代理)
const agents = [new BrowserAgent(), new FileAgent()];

// 3. 初始化 Eko 实例
const eko = new Eko({ llms, agents });

// 4. 执行自然语言任务
// 任务：搜索马斯克最新新闻，总结并保存为桌面文件
const result = await eko.run("Search for the latest news about Musk, summarize and save to the desktop as Musk.md");

console.log(result);

运行说明

1. 将上述代码保存为 .ts 文件。
2. 替换 apiKey 为您的真实密钥（或使用环境变量）。
3. 使用 tsx 或编译后通过 node 运行。

---

更多高级用法（如浏览器插件加载、多智能体并行、任务暂停/恢复）请参考官方文档或查看 example/ 目录下的完整示例项目。