Eko - 使用自然语言构建生产级 Agent 工作流

Eko（发音类似 'echo'）是一个生产级的 JavaScript 框架，旨在帮助开发者构建可靠的 Agent，从简单的指令到复杂的工作流均可覆盖。它提供了一个统一的接口，支持在计算机环境和浏览器环境中运行 Agent。

最新动态

• 2025-11: Eko 4.0 支持对话聊天功能，并优化了 Agent 逻辑。
• 2025-09: Eko 3.0 引入了具备依赖感知能力的并行 Agent 执行。
• 2025-09: 引入了通过 task_snapshot 实现工作流恢复的暂停、恢复及中断控制功能。
• 2025-09: Monorepo 工具链迁移至 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. 使用 pnpm 执行清理并重新安装（rm -rf node_modules && pnpm install），然后重新构建所有浏览器或桌面端的 bundle。
4. 重新运行自动演示程序，并更新文档以体现新的暂停/中断 API 及并行 Agent 行为。

框架对比

特性	Eko	Langchain	Browser-use	Dify.ai	Coze
支持平台	全平台	服务器端	浏览器	Web	Web
单句指令至多步工作流	✅	❌	✅	❌	❌
可干预性	✅	✅	❌	❌	❌
任务并行	✅	❌	❌	❌	❌
开发效率	高	低	中	中	低
任务复杂度	高	高	低	中	中
开源	✅	✅	✅	✅	❌
访问私有 Web 资源	✅	❌	❌	❌	❌

核心功能

• 纯 JavaScript：专为浏览器和 Node.js 构建。🚀
• 多 Agent：在一个任务中通过多个 Agent 释放生产力。📈
• Agent/工具灵活性：只需一行代码即可自定义新的 Agent 和工具。🎉
• 原生 MCP 支持：与 Awesome MCP Servers 无缝连接。🔗
• 动态 LLM：通过灵活的模型选择平衡速度与性能。⚙️
• 人机交互（Human-in-the-loop）：在最关键的时刻进行干预。🤝
• 流式规划（Stream Planning）：实现动态渲染，简单高效。🎨
• 循环与监听任务：自动化任何重复性任务。🤖
• 可观测链（Observable Chain）：即将推出
• 原生 A2A（Agent-to-Agent）：即将推出

快速开始

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

安全警告

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

这将导致凭据泄露，并可能导致未经授权的使用。

最佳实践：通过 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-compatible models (Qwen, Doubao, etc.)
  qwen: {
    provider: "openai",
    model: "qwen-plus",
    apiKey: "your-qwen-api-key",
    config: {
      baseURL: "https://dashscope-intl.aliyuncs.com/compatible-mode/v1"
    }
  },
  doubao: {
    provider: "openai",  // Use OpenAI provider for compatibility
    model: "doubao-seed-1-6-250615",  // or other Doubao model
    apiKey: "your-volcengine-api-key",
    config: {
      baseURL: "https://ark.cn-beijing.volces.com/api/v3"  // Volcengine endpoint
    }
  }

};

let agents: Agent[] = [new BrowserAgent(), new FileAgent()];
let eko = new Eko({ llms, agents });
let result = await eko.run("Search for the latest news about Musk, summarize and save to the desktop as Musk.md");

$ pnpm install @eko-ai/eko

示例项目

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

前置要求

在运行任何示例之前，请先安装依赖。