category
披露:我是 PRAXO-CORE 维护者。本文基于 2.10.0 公开范围;不是生产、安全或平台兼容性认证。
在 COBOL 里实现 Agent 循环,听起来像是一个行为艺术。
COBOL 是面向事务的、过程式的、静态记录的语言。它没有动态内存分配,没有现代异步网络库,标准库也没有 JSON 解析器。把 ReAct 循环、工具调用、JSON Schema、检查点、事件、策略塞进去,听起来不合理。
但大型组织的核心系统就在那里。夜间批处理、对账、理赔、福利、预订,很多还在 COBOL 里跑。迁移可能是正确的长期决策,但它很少是小工程。
PRAXO-CORE 的 COBOL SDK 是一个工程实验:不重写 COBOL,不架 Python 桥接,而是在 COBOL 运行时里放一个受治理的 Agent 循环。
这篇文章拆三件事:架构、边界、代价。
一、入口:praxo-run
核心入口是一个 COBOL 程序:
call "praxo-run" using px-options px-session px-prompt
px-result px-user-data
px-options 指定模型、工具分发器、策略和事件程序。px-user-data 是调用方持有的 4096 字节回调上下文。
行为约定:
- 空回调状态表示成功;
- 模型/工具状态会传播;
- 非空策略状态表示拒绝;
- 输入 session 不会被修改;
- 每次 run 使用本地历史;
px-max-steps为零或负数时选择 8 步;- token budget 非正数时表示不限制。
它不是“模型 API 的 COBOL 包装”。它是一个有状态机、有工具分发、有策略检查、有事件回调的循环。
二、JSON:有界解析,不是通用解析器
COBOL 没有现代 JSON 标准库,所以 SDK 自己实现:
praxo-json-parsepraxo-json-generatepraxo-json-stringpraxo-json-quotepraxo-json-slicepraxo-utf8
关键设计是“有界”:
- 输入最大 32,768 字节;
- 最多 512 个节点;
- 最多 64 层嵌套;
- 生成 JSON 最大 16,384 字节;
- 非法 UTF-8、孤立代理项、畸形数字、尾随数据会被拒绝;
- 重复对象键保留,查找使用最后一个值;
- JSON 工具返回本地
JSON_INVALID/JSON_CAPACITY状态,不新增 wire 错误码。
这不是“任意 JSON”解析器。它是有明确容量和失败状态的解析基础设施。对固定记录的 COBOL 来说,这比“尽量解析”更安全。
三、Schema:校验声明的子集
praxo-jsonschema 负责对象/数组 schema 校验,内部使用 praxo-schema-scalar 和 praxo-schema-visit。
它覆盖向量定义的对象、数组、字符串、数字、整数、布尔、枚举、长度、模式、数值边界等行为。
这里有一个容易误解的点:它校验的是声明的 JSON Schema 子集,不是任意 COBOL DATA DIVISION 定义。不要把它说成“AI 返回的 JSON 完全符合 COBOL 数据节”。
模式匹配也有限制:支持字面量、点、字符类/范围、锚点、*、+、?;分组、交替、计数重复、Unicode 模式匹配和不支持的转义会返回 SCHEMA_PATTERN_UNSUPPORTED,不会静默接受。
四、工具调用:多种格式,统一解析
praxo-toolcall 支持:
- JSON
- XML 风格
- 点号标签(dotted-tag)
- 纯文本
还包括 ParseInputJSON 和 StripToolCallMarkup 对应的操作。
为什么需要这么多种?因为不同模型、不同 provider、不同 prompt 约定会产生不同形状的工具调用。COBOL 侧不能假设只有一种格式。
五、中间件:步数、选择、fallback、结构化输出、邮箱抹除
praxo-middleware 提供:
- 调用步数限制,防止循环耗尽 token;
- 工具选择;
- fallback;
- structured output;
- 邮箱抹除。
邮箱抹除必须精确描述:它只覆盖邮箱地址,不是通用 PII 控制,不能替代合规脱敏、数据分类或审计策略。
六、记忆、检查点、上下文、事件、策略
praxo-memory:内存内会话记录和检索,使用 ASCII 大小写折叠和规范 UTC 时间戳词法排序。不是持久化数据库。praxo-checkpoint:注册 payload 类型的 JSON 信封,不实例化任意原生类型。praxo-context:token 估算和上下文压缩。praxo-event:filter 和多 sink 事件投递。praxo-policy/praxo-path-normalize:词法路径授权和规范化。不是操作系统级隔离。praxo-plugin:严格 manifest 解析和校验。不执行插件、不验证签名。praxo-stream:stream-kind 常量。不是异步运行时。
七、代价:为什么要公开这些限制
多语言 Agent 框架最容易犯的错,是把“能跑”说成“完整”。
COBOL SDK 的当前范围:
- 63 条规范向量、11 组通过;
- 原生 agent、JSON、契约边界、工具和 API 声明检查通过;
- 远程
cobol-conformanceCI 通过; - 源码 tag
cobol/v0.8.0; - 但 parity 清单仍有多行
partial,tool.Registry是partial; - provider adapters 需调用方提供传输;
- 没有完整 assistant 工具调用历史、stream parts、事件 session/run ID;
- 不是异步高吞吐运行时;
- 不宣称 IBM z/OS。
这些限制不是“以后再说”的借口,而是当前声明的一部分。公开它们,读者才能判断这个边界是否适合自己的场景。
八、什么时候不该用
- 你只需要一个 Python Agent demo;
- 你需要开箱即用的托管服务、向量数据库、完整图编排;
- 你需要 IBM z/OS 生产支持;
- 你需要高并发异步流式;
- 你的 payload 经常超过 32KB,且无法拆分;
- 你无法接受“原生循环 + 产品侧工具/策略”的集成工作量。
如果这些成立,桥接、sidecar 或迁移可能更合适。这不是失败,而是边界匹配问题。
九、结论
在 COBOL 里写 Agent 循环,不是为了证明“老语言也能时髦”。
它是在回答一个更具体的问题:当交易、数据和变更控制都在 COBOL 运行时里,Agent 的治理边界应该放在哪里?
PRAXO-CORE 的答案是:放在运行时里,用原生循环、明确边界和可检查的向量把它做实。
仓库:https://github.com/axisvela/praxo-core
COBOL 源码:https://github.com/axisvela/praxo-core/tree/main/language/cobol
COBOL 文档:https://axisvela.github.io/praxo-core/languages/cobol/
语言矩阵:https://github.com/axisvela/praxo-core/blob/main/spec/languages.md
- 登录 发表评论