category
披露:我是 PRAXO-CORE 维护者。本文基于 2.10.0 公开范围;不是生产、安全或平台兼容性认证。
在电信、消息、金融、游戏、IoT 和分布式平台里,Erlang/OTP 的强项是并发、隔离和失败处理。
这些团队已经有一套进程、监督树、重启策略和运维模型。把 Agent 放进一个外部 Python 服务,可能隔离了新运行时,但也把策略、审批、审计和凭证推到了进程边界之外。
PRAXO-CORE 的 Erlang SDK 提供第三条路:保留 Erlang 服务,把受治理的 Agent 循环放进进程里。
但必须先把最重要的一句话放在前面:它不是 OTP 应用,也不是监督树。
一、核心结论
Erlang SDK 是原生 Erlang/OTP 29 Core 实现,不是桥接,也不是 Python 包装。
当前公开验证:
- 11 组共享向量全部通过(OTP 29);
- 原生回归测试;
- API 快照和 parity 清单;
- 远程
erlang-conformanceCI; - 源码 tag
erlang/v0.9.0,目标SPEC_VERSION 0.2.0; - Hex 包
praxo_core_erlang0.9.0,OTP application 名为praxo_core; - JSON 使用 OTP
json模块; - MIT 许可;OTP 是独立工具链。
三个明确的 partial 面:
- tool registry:覆盖常见路径和向量行为,但不是每个可选 Go hook;
- stream part:有 stream kind 表示,但不是异步 streaming runtime;
- JSON Schema:覆盖向量定义行为,但不是完整 JSON Schema。
不要把它说成“完整 Go parity”。
二、最重要的边界:不是 OTP 应用
SDK 不创建进程、邮箱、supervisor 或重启策略。
它是一个同步 Core 循环,调用方把它放进自己的进程和监督模型里。并发、重试、backoff、回调异常处理,都由调用方拥有。
这是刻意的设计。Erlang 团队对进程设计和失败行为有强观点;一个库如果悄悄创建一套平行运行时,会是负债。
真正的问题是:当模型在凌晨三点出错时,谁负责监督? 答案是调用方,不是 SDK。
三、原生 Erlang/OTP 29 是什么
SDK 由一组原生 Erlang module 组成:
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。
核心调用:
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)]).
四、同步、串行:不是 streaming runtime
Core 循环是同步的,工具串行执行。
这不是缺陷,而是边界。如果你需要高并发流式处理,Erlang 很擅长并发,但这个 SDK 不是 streaming runtime。它是一个受控循环,可以放进你已经监督的进程里。
调用方提供 model 和 tool callback。callback 异常不会自动转换成契约错误;调用方必须决定怎么处理。这是另一个刻意边界:SDK 不把 Erlang 的失败语义藏在一个通用错误类型后面。
五、两个 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。
六、治理与失败
电信或消息服务不需要一个会聊 Erlang 的 Agent。它需要的是:Agent 能参与运维流程,同时不绕过流程周围的控件。
这意味着:
- 策略检查能看到最终工具参数;
- 工具授权是显式的;
- 检查点支持恢复;
- 事件是结构化的,能用于审计和遥测;
- 人类审批发生在正确边界;
- 框架清楚说明自己不负责什么。
如果循环就在 Erlang 进程里,服务状态、凭证和策略决策可以靠得更近。这减少了一种边界穿越,但不自动等于安全、合规或容错。
监督问题仍然是你的。
七、我们不宣称什么
- 不是 OTP 应用,不是监督树;
- 不是 streaming runtime;
- provider adapter 已存在;
- 没有 plugin host;
- 没有持久 session store;
- 不是完整 Go parity;tool registry、JSON Schema 是 partial;stream part 是 parity;
- 不是操作系统级路径隔离;
- 不是通用 PII 合规;
- 不宣称生产可用或安全认证;
- 不宣称“Erlang 是新的 AI 语言”。
八、如何安装和验证
在 Hex 中:
{deps, [{praxo_core_erlang, "0.9.0"}]}.
本地验证:
python language/erlang/run-tests.py
python language/erlang/api-snapshot.py --check
需要 Erlang/OTP 29+。ERLC 和 ERL 可以选择编译器和运行时。Python runner 只启动 erlc、erl 和 API 检查;实现和测试都是 Erlang。
然后:
- 读
spec/languages.md的 Erlang 行; - 读
language/erlang/README.md的 Current Limits; - 读
spec/parity/erlang.md的两个 partial 面; - 检查同步/串行边界是否适合你的进程设计;
- 测试 callback 异常、策略拒绝、取消、路径处理;
- 再决定原生循环、桥接还是 sidecar。
仓库:https://github.com/axisvela/praxo-core
Erlang 文档:https://axisvela.github.io/praxo-core/languages/erlang/
Erlang 源码:https://github.com/axisvela/praxo-core/tree/main/language/erlang
语言矩阵:https://github.com/axisvela/praxo-core/blob/main/spec/languages.md
九、结语
Erlang 不需要变成 Python,才能用 Agent。
它需要的是一个能在原进程里受治理地运行、失败行为清楚、边界明确的 Agent 循环。
11 组向量、原生测试、两个 partial 面、同步串行、调用方监督——这些限制不是缺点清单,而是可信度的一部分。
对不愿把服务状态和凭证搬到 sidecar、但又需要 Agent 能力的团队,这是一条值得评估的第三条路。
- 登录 发表评论
- 1次浏览