category
披露:我是 PRAXO-CORE 维护者。本文基于 2.10.0 公开范围;不是生产、安全或平台兼容性认证。
在 Erlang 里实现 Agent 循环,最危险的做法不是“写不出来”,而是“假装它是一个 OTP 应用”。
Erlang 团队已经有进程、监督树、重启策略和失败语义。一个库如果悄悄创建自己的 supervisor、邮箱和运行时,会成为运维负债。
PRAXO-CORE 的 Erlang SDK 选择相反的边界:它只提供一个同步 Core 循环,调用方把它放进自己的进程和监督模型里。
这篇文章拆三件事:模块、同步/串行、监督边界。
一、入口:run_agent
从 Hex 安装:
{deps, [{praxo_core_erlang, "0.9.0"}]}.
核心调用:
Model = praxo_agent:static_model(<<"hello">>),
Options = praxo_agent:new_agent_options(Model),
{ok, Result, _Options} =
praxo_agent:run_agent(Options, praxo_models:session(<<"demo">>), <<"hello">>),
io:format("~s~n", [maps:get(output, Result)]).
接口很小,但背后包含:options、model、session、tool callback、policy、event sink、checkpoint、context budget、middleware。
二、模块:用 Erlang 的方式表达 Agent
| Module | Surface |
|---|---|
praxo_agent |
Agent 循环、options、tool helper、fallback model |
praxo_models |
message、request、response、usage、session、event、decision、context budget、stream kinds |
praxo_sink |
event sink |
praxo_memory |
memory store |
praxo_checkpoint |
checkpoint allowlist |
praxo_runtime |
path checker、token estimate |
praxo_toolcall |
tool-call 解析、markup 移除 |
praxo_jsonschema |
schema 校验 |
praxo_plugin |
manifest 解析 |
praxo_middleware |
PII 脱敏、structured output、call limit、tool selection |
Erlang 没有 Python 的动态对象系统,所以数据用 map 和 tuple 表达;model 和 tool 用调用方提供的函数表达;event sink 是独立模块;失败通过返回值/异常传播,而不是隐藏成通用错误。
三、同步、串行:边界不是缺陷
Core 循环是同步的,工具串行执行。
这不是“Erlang 不擅长并发”,而是 SDK 的边界:
- 它不创建进程;
- 它不创建 supervisor;
- 它不创建邮箱;
- 它不提供 streaming runtime;
- 它不替你决定重试和 backoff。
调用方把循环放进已有的监督进程里,自己拥有并发和失败处理。
如果你需要高并发流式处理,应该用 Erlang 的并发能力自己设计,或者把 Agent 放到 sidecar。这个 SDK 不是那把锤子。
四、两个 partial 面
必须明确:
- tool registry:覆盖常见路径和向量行为,但不是每个可选 Go hook;
- stream part:有 stream kind 表示,但不是异步 streaming runtime;
- JSON Schema:覆盖向量定义行为,但不是完整 JSON Schema。
其余声明范围内通过。PII 脱敏、structured output、per-run call limit 和 tool
selection 是已集成到循环的 opt-in 中间件;支持 fallback model。没有 provider
adapter、streaming runtime、plugin host 或持久 session store。
五、回调异常:不要假设 SDK 会归一化
Model 和 tool callback 由调用方提供。callback 异常不会自动转换成契约错误;调用方必须决定怎么处理。
这是 Erlang 的失败语义问题。SDK 不把异常藏在一个通用错误类型后面,因为那会让监督和重试策略失真。
六、治理与状态
如果 Agent 住在 Python 服务里,策略、工具授权、检查点、审计事件、人工审批都要跨进程重新建立,服务状态和凭证也可能要复制或委托。
如果循环就在 Erlang 进程里,服务状态、凭证和策略决策可以靠得更近。这减少了一种边界穿越,但不自动等于安全、合规或容错。
监督问题仍然是你的。
七、代价与不适用场景
Erlang SDK 的当前范围:
- 11 组向量通过(OTP 29);
- 原生回归测试;
- API 快照和 parity 清单;
- 远程
erlang-conformanceCI; - 源码 tag
erlang/v0.9.0,Hex 包praxo_core_erlang0.9.0; - opt-in 中间件已集成:PII 脱敏、structured output、call limit、tool selection;
- 两个 partial 面;
- 同步串行;
- provider adapter 已存在、streaming runtime、plugin host、持久 session store;
- 不宣称生产可用。
如果你需要 OTP 应用/监督树开箱即用、异步 streaming、provider adapter、plugin host
或持久 session store,这个 SDK 不是答案。
八、结论
Erlang 不需要变成 Python,才能用 Agent。
它需要的是一个能在原进程里受治理地运行、失败行为清楚、边界明确的 Agent 循环。
PRAXO-CORE 的答案是:原生模块、调用方监督、同步串行、明确 partial、把限制写进 parity 清单。
仓库:https://github.com/axisvela/praxo-core
Erlang 源码:https://github.com/axisvela/praxo-core/tree/main/language/erlang
Erlang 文档:https://axisvela.github.io/praxo-core/languages/erlang/
语言矩阵:https://github.com/axisvela/praxo-core/blob/main/spec/languages.md
- 登录 发表评论
- 1次浏览