跳转到主要内容
Chinese, Simplified

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 面

必须明确:

  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。

五、回调异常:不要假设 SDK 会归一化

Model 和 tool callback 由调用方提供。callback 异常不会自动转换成契约错误;调用方必须决定怎么处理。

这是 Erlang 的失败语义问题。SDK 不把异常藏在一个通用错误类型后面,因为那会让监督和重试策略失真。

六、治理与状态

如果 Agent 住在 Python 服务里,策略、工具授权、检查点、审计事件、人工审批都要跨进程重新建立,服务状态和凭证也可能要复制或委托。

如果循环就在 Erlang 进程里,服务状态、凭证和策略决策可以靠得更近。这减少了一种边界穿越,但不自动等于安全、合规或容错。

监督问题仍然是你的。

七、代价与不适用场景

Erlang SDK 的当前范围:

  • 11 组向量通过(OTP 29);
  • 原生回归测试;
  • API 快照和 parity 清单;
  • 远程 erlang-conformance CI;
  • 源码 tag erlang/v0.9.0,Hex 包 praxo_core_erlang 0.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

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