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 帮得不多。门槛经常改、改的人不是写代码的人、模型会升级、每个决定都要有人负责的团队,才最需要它。