跳转到主要内容
Chinese, Simplified

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-conformance CI;
  • 源码 tag erlang/v0.9.0,目标 SPEC_VERSION 0.2.0;
  • Hex 包 praxo_core_erlang 0.9.0,OTP application 名为 praxo_core;
  • JSON 使用 OTP json 模块;
  • MIT 许可;OTP 是独立工具链。

三个明确的 partial 面:

  1. tool registry:覆盖常见路径和向量行为,但不是每个可选 Go hook;
  2. stream part:有 stream kind 表示,但不是异步 streaming runtime;
  3. 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 面

必须明确:

  1. tool registry:覆盖常见路径和向量行为,但不是每个可选 Go hook;
  2. stream part:有 stream kind 表示,但不是异步 streaming runtime;
  3. 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。

然后:

  1. 读 spec/languages.md 的 Erlang 行;
  2. 读 language/erlang/README.md 的 Current Limits;
  3. 读 spec/parity/erlang.md 的两个 partial 面;
  4. 检查同步/串行边界是否适合你的进程设计;
  5. 测试 callback 异常、策略拒绝、取消、路径处理;
  6. 再决定原生循环、桥接还是 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 能力的团队,这是一条值得评估的第三条路。

本文地址
最后修改
星期六, 十一月 21, 2026 - 17:54
Article
↑