
Ergon 发布:用代码或画布构建 AI agent,画布可生成 Python
来源标题:Show HN: Ergon – build AI agents in code or on a canvas that generates Python
Ergon 是一个构建 AI agent harness 的工具包,包含 Python SDK 引擎和拖拽式可视化 Studio。Studio 生成的 Python 代码直接对接 SDK,SDK 的桥接层也能无界面运行 Studio 设计的 harness。两者放在同一 monorepo 中,确保生成代码与运行时不会脱节。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
构建 AI agent harness 的工具包——一个 Python SDK(引擎)和一个拖拽式可视化 Studio(构建器),后者会生成调用该 SDK 的代码。这是一个 monorepo:两部分都放在这里,因为它们同步演进。Studio 为 SDK 生成 Python 代码,SDK 的 bridge 可以无头运行由 Studio 设计的 harness,而且大多数功能(浏览器控制、花费预算、自定义工具……)会同时落到两边。把它们放在同一个仓库里,意味着一次提交就能覆盖跨领域改动,因此生成的代码和运行时永远不会彼此脱节。
ergon/ ├── sdk/ Python SDK——agent harness 引擎(pip install ./sdk) ├── studio/ Vite + React 可视化构建器 + Node 代理(npm --prefix studio) ├── examples/ 共享的 harness JSON、评测数据集、示例 ├── docs/ 生成的静态文档站点(scripts/build-docs.mjs) └── scripts/ 仓库级辅助脚本(引导两套工具链、构建文档)
这里有什么 路径 是什么 工具链 sdk/ ergon Python 包:agent 循环、工具、审批、压缩、流式输出、provider、统一路由、评测、浏览器控制 Python ≥3.9,pip studio/ 可视化 harness 构建器——画布、检查器、实时预览、代码生成、可选账户 Node ≥18,npm examples/ 与 provider 无关的 harness 图 + 评测数据集,可导入 Studio 或通过 SDK bridge 运行 —
两部分各有独立的工具链——不存在同时完成两者的单一构建。可以用 bootstrap 脚本,也可以分别单独设置(见下文)。
一条命令即可同时设置两部分并启动 Studio:
export ANTHROPIC_API_KEY=sk-ant-... # 默认 provider——或使用约 15 个中的任意一个(见 Providers) ./scripts/bootstrap.sh # 如有需要则安装,然后启动(http://localhost:5173)
bootstrap.sh 是唯一入口——它会读取根目录下的 .env(如果存在),并接受子命令:
./scripts/bootstrap.sh # dev:设置 + 启动 Studio(默认) ./scripts/bootstrap.sh docker # 生产栈(应用 + Postgres + Valkey) ./scripts/bootstrap.sh serve harness.json --port 8900 # 提供 harness 服务(REST + SSE) ./scripts/bootstrap.sh test # 运行两套测试 ./scripts/bootstrap.sh setup # 仅安装依赖 ./scripts/bootstrap.sh help
……或者自己分别驱动两边:
pip install -e ./sdk # SDK npm --prefix studio install && npm --prefix studio run dev # Studio(代理 + Vite) python sdk/examples/quickstart.py # 通过 SDK 运行一个 agent
Providers
Ergon 并非只支持 Anthropic——Anthropic 只是默认项,所以 quickstart 只展示了一个 key。统一路由器可访问约 15 个 provider,每个 agent 各自选择。只需设置你使用的 key,通过环境变量或在 Studio 中设置(Settings → Keys,加密存储):
OpenAI 兼容路径覆盖 Azure OpenAI、DeepSeek、Fireworks、Groq、Mistral、NVIDIA、OpenRouter、Perplexity、Together、vLLM 和 xAI(每个也都有代理能识别的专用 *_API_KEY)。在 Studio 中设置的 key 优先于环境变量,且永远不会离开服务器;每个 agent 的 Provider 下拉框控制某个 block 使用哪一个。
在 Studio 中设计 → 导出 Python。在画布上构建 harness,点击「Python SDK code」,得到针对 ergon 的可运行脚本。
无头运行 Studio harness。ergon.load_harness("graph.json", tools={...}) 会在你自己的进程中运行 Studio 生成的完全相同图。
各子项目的 README 有更深入的说明: SDK README · Studio README。
Agents 与流程——带审批、重试、流式输出、压缩和成本核算的工具调用循环;chain / route / parallel / branch / loop 控制流;统一 provider 路由器(Anthropic、OpenAI 兼容、Ollama、Gemini、Bedrock),支持 fallback 和成本注册表。 检索与工具——pgvector RAG、MCP 客户端、浏览器控制、自定义和内置工具、skills。 服务——把任意 harness 变成 REST + SSE HTTP 端点(ergon serve),支持 Docker 化。 观测与评估——OpenTelemetry trace、带 trace 查看器的每次运行历史,以及带 scorer 和 CI 回归门禁的评测 harness。 运营(Studio 协作层)——账户、组织 + RBAC、只追加审计日志、SSO(OIDC)、服务账户 API key、按组织预算与配额、托管控制平面(把 harness 发布到多租户网关之后),以及按组织数据导出 + 擦除。
项目 CHANGELOG.md——按阶段记录已发布内容。 CONTRIBUTING.md——开发设置、测试、PR 流程、发布。 SECURITY.md——报告 + 安全属性。 SUPPORT.md——在哪里寻求帮助。 行为准则。 治理:SOC 2 控制矩阵 · 数据治理。
文档
所有 README 也会发布为一个带导航和标题页内搜索的单一静态文档站点——无需构建工具链或依赖:
node scripts/build-docs.mjs # 从 README 重新生成 docs/index.html
直接打开 docs/index.html,或把 docs/ 托管到任意静态服务器(GitHub Pages、S3、nginx)。Markdown 嵌入在页面中(因此从 file:// 也能用);只有 Markdown 渲染器从 CDN 加载,并带原始文本回退。编辑任何 README 后重新运行该命令以刷新站点。
生产栈(应用 + Postgres/pgvector + Redis)通过 Docker:
docker compose up --build # 先在 .env 中设置 ANTHROPIC_API_KEY
内置健康检查(/healthz、/readyz)、优雅关闭和自动运行 schema 迁移——见 studio/README.md。
SDK 和 Studio 共享同一个版本并一起发布——一次改动通常同时涉及两者,因此同步发布能让生成的代码和运行时保持同步。Tag 为仓库根目录的 vMAJOR.MINOR.PATCH。
Ergon 是开源的,并且公开构建。最有价值的支持不是钱——而是表明项目被使用、值得维护的信号:
参与即表示你同意行为准则。
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。