跳转到主要内容
Chinese, Simplified

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-parse
  • praxo-json-generate
  • praxo-json-string
  • praxo-json-quote
  • praxo-json-slice
  • praxo-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-conformance CI 通过;
  • 源码 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

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