Skip to content

Ordo 是什么? ​

Ordo 是一个开源的决策引擎。你把业务规则写成 JSON 或 YAML 文件,Ordo 负责校验、测试、执行和追踪。名字来自拉丁语,意思是"秩序"。

它解决什么问题 ​

折扣怎么算、订单能不能过、工单派给谁,这类规则通常以 if/else 的形式散在各个服务里。时间一长会出现几个问题:

  • 没人说得清现在一共有哪些规则、各自在哪。
  • 改一个阈值也要改代码、走发版。
  • 很难单独测试一条规则,出了问题也不容易解释"为什么是这个结果"。

用 AI 写代码之后,这类分支长得更快,也更难 review。

Ordo 的做法是把这些规则从代码里拿出来,集中成规则文件。调用方只传入数据、拿回结果,规则本身可以单独修改、测试、审查和发布。

核心概念 ​

规则集(RuleSet) 是一个步骤图,从入口步骤开始执行,走到终止步骤结束。步骤有几种:

步骤作用
decision按顺序判断条件,走第一个满足的分支
decision_table决策表,按行匹配输入,给输出变量赋值
action设置变量、记录日志等,然后进入下一步
sub_rule调用一段可复用的子规则
terminal结束执行,返回结果码和输出

表达式 写在条件和输出里,例如 order.amount >= 1000 && user.tier == "gold"。表达式语言是有意做小的:没有循环,不能修改外部状态,执行时间可预期。见表达式。

输入校验 用 input_schema 声明规则需要的字段和类型,缺字段或类型不对时直接返回错误,不会悄悄走错分支。金额可以用 decimal 类型做精确计算。见规则结构。

怎么用 ​

同一份规则文件,可以用几种方式运行:

  • 命令行:ordo test、ordo trace、ordo impact,适合本地开发和 CI。见测试与影响。
  • 服务:ordo-server 提供 HTTP、gRPC 和 Unix Socket 接口,支持热更新、版本管理和多租户。见运行服务。
  • 嵌入:在 Rust 程序里直接用 ordo-core,或者在浏览器里用 WebAssembly 版本。见嵌入使用。

团队需要可视化编辑、审批和多环境发布时,可以再加上 Studio 与平台。不用平台也能完整使用引擎。

和决策模型一起用 ​

Jev 这类决策模型能读懂一段文字,回答"这是不是退款请求""客户有多急",并给出置信度。退不退款、要不要人工看,还要结合金额、期限、退款记录和你们的政策,这一步是决策,写在 Ordo 规则里。

模型的回答作为输入字段传给规则,比如 jev.intent.confidence。阈值写在规则文件里,带测试,改之前可以用 ordo impact 看会影响哪些决策。ordo-server 也可以作为网关放在模型前面。完整的例子见 jev-routing 规则包。

和 AI 一起用 ​

规则是结构化的文件,表达式语言又很小,所以 AI 写出来的规则可以先用 ordo validate 编译检查,再用 ordo test 跑测试,结果不对时用 ordo trace 看到底走了哪条路径。ordo mcp 可以把这些能力作为工具提供给编码 Agent,见 MCP 服务。

Ordo Guard 是另一个方向的例子:它用 Ordo 规则决定编码 Agent 的每一次工具调用是放行、拒绝还是询问。

适合与不适合 ​

适合:规则经常变、需要精确计算、需要解释和审计的判断逻辑,比如定价、优惠、风控、准入、审批、路由,以及决策模型给出判断之后怎么处理。

不太适合:需要长时间等待和人工节点的流程编排(那是工作流引擎的事),以及需要循环和复杂数据处理的通用计算。

也要看是谁在用。判断逻辑只有一个人写、一个人改,代码也有测试,Ordo 帮得不多。门槛经常改、改的人不是写代码的人、模型会升级、每个决定都要有人负责的团队,才最需要它。

下一步 ​

基于 MIT 许可发布。