返回资讯中心
外部精选
软件工程
#开发者实时流

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 中,确保生成代码与运行时不会脱节。

Hacker News 最新mavster262026/11/5 · 12 天前14 分钟阅读

以下正文由 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 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →