category
披露:我是 PRAXO-CORE 维护者。本文基于 2.10.0 公开范围;不是生产、安全或平台兼容性认证。
一台网络设备、一个游戏引擎、一个 IoT 控制面,或者一个带插件系统的应用,里面可能嵌着 Lua。
这些 Lua 扩展不拥有整个运行时,却握着宿主状态、配置、连接和业务钩子。它们不“独立”,但很关键。
现在,假设你想让一个 Agent 参与这些流程。不是做聊天机器人,而是让它读取宿主异常、调用工具、等待审批、写检查点、发出审计事件。
大多数 Agent 框架会默认你加一个 Python sidecar。但在嵌入式宿主里,sidecar 可能不存在、不被允许,或者太重。
PRAXO-CORE 的 Lua SDK 提供第三条路:保留宿主,把受治理的 Agent 循环放进 Lua 扩展所在的地方。
但最重要的边界必须先说:这是 Lua 5.4,不是“Lua 通用”。
一、默认答案:sidecar
默认答案是:Agent 住在外部 Python 服务里,Lua 扩展作为工具被调用。
这有时是正确选择。它隔离了新运行时,避免碰宿主。但它把策略、审批、审计和凭证推到了进程边界之外。在嵌入式环境里,这个边界可能根本不存在。
二、第三条路:循环进入宿主
PRAXO-CORE 的 Lua SDK 是原生 Lua 5.4 Core 实现,不是桥接,也不是 Python 包装。
Lua 扩展调用 run_agent,传入 options、session、prompt,拿回 result。模型、工具、策略、事件都在同一个宿主进程里。
核心调用很小:
local agent = require("praxo.agent")
local models = require("praxo.models")
local model = agent.static_model("hello")
local options = agent.agent_options(model)
local result = agent.run_agent(options, models.session({ id = "demo" }), "hello")
print(result.output)
三、最重要的边界:Lua 5.4
必须把这句话放在前面:
这是 Lua 5.4,不是“Lua 通用”。
- 不宣称 LuaJIT 兼容;
- 不宣称 Lua 5.1 / 5.3 兼容;
- 不宣称 OpenResty 兼容;
- 不宣称 Redis 兼容。
很多流行的 Lua 宿主使用 LuaJIT 或更老的 Lua 版本。公开材料如果只写“Lua”,会误导读者。更诚实的说法是:这是 Lua 5.4 的原生 Core 循环;如果你的宿主是别的 Lua 运行时,需要单独做移植评估。
四、原生 Lua 5.4 是什么
SDK 由一组原生 Lua module 组成:
agent:Agent 循环、options、tool registry、function tool;models:message、request、response、usage、session、event、decision、memory record、context budget、stream kinds;runtime:event sink、path checker、memory store、checkpoint allowlist、context budget、token estimate;toolcall:tool-call 解析、markup 移除;jsonschema:schema 校验;plugin:manifest 解析;middleware:call limit、fallback、PII 脱敏、structured output、tool selection。
验证结果:11 组向量全部通过,core tests,公共 API 快照,远程 lua-conformance CI。源码 tag lua/v0.8.0,目标 SPEC_VERSION 0.2.0。
五、依赖故事:标准库 only
Lua 宿主动辄关心 footprint。这个 SDK 刻意做小:
- 只依赖 Lua 标准库;
- 没有 Python host;
- 没有 provider SDK;
- 核心循环不需要编译扩展。
这不等于“绝对零依赖”,但它把依赖面做小、做可审计。在嵌入式宿主里,这经常是“能不能评估”和“能不能部署”的区别。
六、三个 partial 面
必须明确:
- event sink:覆盖向量行为和常见路径,但不是每个可选 Go hook;
- stream part:有 stream kind 表示,但不是异步运行时;
- JSON Schema:覆盖向量定义行为,但不是完整 JSON Schema。
其余声明范围内通过。provider adapter 需调用方提供传输、异步运行时、plugin host 或持久 session store。
七、治理与宿主状态
嵌入式宿主不需要一个会聊 Lua 的 Agent。它需要的是:Agent 能参与宿主工作流,同时不绕过工作流周围的控件。
这意味着:
- 策略检查能看到最终工具参数;
- 工具授权是显式的;
- 检查点支持恢复;
- 事件是结构化的,能用于审计和遥测;
- 人类审批发生在正确边界;
- 框架清楚说明自己不负责什么。
如果循环就在 Lua 宿主里,宿主状态、凭证和策略决策可以靠得更近。这减少了一种边界穿越,但不自动等于安全或合规。
八、我们没做什么
- 不宣称 LuaJIT、Lua 5.1/5.3、OpenResty 或 Redis 兼容;
- 不是完整 Go parity;event sink、stream part、JSON Schema 是 partial;
- 不是包注册表发布;
- provider adapter 需调用方提供传输;
- 不宣称异步运行时;
- 不是 plugin host;只解析 manifest;
- 不宣称持久 session store;
- 不是通用 PII 合规;
- 不宣称生产可用或安全认证。
九、邀请
Lua 不需要变成 Python,才能用 Agent。
它需要的是一个能在宿主进程里受治理地运行、依赖面小、边界清楚的 Agent 循环。
如果你运行 Lua 5.4 宿主,欢迎提出最难的问题:
- 你会把循环放进宿主进程,还是留在外部服务?
- Lua 5.4 边界对你是硬伤,还是已经满足?
- 哪些边界应该原生,哪些应该留在桥接后面?
- 你需要看到什么证据,才愿意让 Agent 从 Lua 调用宿主工具?
仓库:github.com/axisvela/praxo-core
Lua 文档:axisvela.github.io/praxo-core/languages/lua
如果答案是“我的宿主更适合外部 sidecar”,那也是一个有用的答案。目标不是让所有架构都一样,而是让集成边界变得诚实。
阅读原文: 如果公众号外链受限,可将“阅读原文”指向 Lua 文档或仓库镜像页。正文保留仓库名 axisvela/praxo-core,方便读者搜索。
- 登录 发表评论
- 1次浏览