跳转到主要内容
Chinese, Simplified

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 面

必须明确:

  1. event sink:覆盖向量行为和常见路径,但不是每个可选 Go hook;
  2. stream part:有 stream kind 表示,但不是异步运行时;
  3. 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,方便读者搜索。

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