Laya 实战：多语言轻量决策引擎与路由 · 第 8 章 生态集成

Laya 实战：多语言轻量决策引擎与路由 · 第 8 章 生态集成

章节摘要：前七章把 laya 从概念调到可信，本章让它融入你已有的工具链。集成面官方提供四件：MCP server（laya 作为 MCP server 暴露决策工具，装 mcp 扩展即起，8.1 节给启动方式、工具 schema 的写法示意与给 Agent 挂接的最小示例）；LangChain 与 LangGraph 挂接（langchain 扩展，8.2 节用两个节点示范：意图路由节点——把「该走哪条链」交给 laya 毫秒级判断；人工介入判断节点——低置信即打断自动流程转人工）；加上前半本已展开的 ONNX（第 4.3 节）与 CLI（第 3.3 节），本章末尾用一张表收拢五种集成形态的选型。贯穿的主题是「让 laya 出现在它该出现的位置」：Agent 的工具架上、编排图的节点里、shell 管道中——而不是再造一套调用体系。工具 schema 与代码均为写法示意，以官方文档为准。

学习目标

• 启动 laya 的 MCP server 并说明它暴露的决策工具（写法示意）。
• 给一个 MCP 客户端挂接 laya 决策工具并跑通最小调用。
• 在 LangChain 里用 laya 实现意图路由节点，替代 LLM 路由。
• 在 LangGraph 里用低置信判断实现人工介入节点。
• 按一张表在 SDK、CLI、serve、MCP、LangChain 五种形态间选型。

核心概念速览

laya 的五种集成形态与它们的座位

  你的工具链                          laya 的座位
┌────────────────────────────────────────────────────┐
│ Agent（MCP 客户端）── 8.1 ──▶ 工具架上的「决策工具」   │
│ LangChain 链       ── 8.2 ──▶ 路由节点（意图分流）    │
│ LangGraph 图       ── 8.2 ──▶ 条件边节点（人工介入）   │
│ shell 管道         ── 3.3 ──▶ Unix 过滤器（CLI）      │
│ 任意系统           ── 4.1 ──▶ HTTP 服务（laya-serve） │
│ 受限运行时         ── 4.3 ──▶ ONNX 工件              │
└────────────────────────────────────────────────────┘
​

一句话金句：好的集成不是把 laya 塞进系统，而是让系统里「需要判断的那一格」刚好被它坐上。

（文字流程图）装扩展 ──▶ 起 MCP server ──▶ Agent 工具架挂接 ──▶ 编排图里占路由与门控节点 ──▶ 五种形态按调用方选型。

子章节导航

• 第 8.1 节《MCP server》：server 启动、决策工具的 schema（写法示意）、Agent 侧最小挂接示例与工具面设计原则。
• 第 8.2 节《LangChain 与 LangGraph 挂接》：意图路由节点与人工介入判断节点的代码示意，以及把决策从提示词里搬出来的收益账。

两节分别面向两条生态线：8.1 给 Agent 与工具协议生态（laya 作为被调用的工具），8.2 给应用编排生态（laya 作为图里的节点）。都在讲同一件事：判断这一格，交给 laya。

子章节之间的逻辑关系

┌──────────────────┐   同一个决策能力的两种暴露    ┌──────────────────────┐
│ 8.1 MCP server   │                             │ 8.2 LangChain 与     │
│ 工具协议形态      │ ──────────────────────────▶ │ LangGraph 挂接       │
│                  │                             │ 编排节点形态          │
└────────┬─────────┘                             └──────────┬───────────┘
         │ 调用方：Agent（模型决定何时调用）                   │ 调用方：你的代码（图结构决定何时调用）
         ▼                                                   ▼
      工具面设计：schema 即文档                    节点设计：门控与路由的图表达
         └───────────────────┬─────────────────────────────┘
                             ▼
              与第 4 章 serve、第 3 章 SDK/CLI 合成集成选型全景
​

前置知识与后续延伸

• 前置：第 3 章的 predict 与 decide（两种集成形态封装的就是它们）；第 7 章的置信门控（8.2 的人工介入节点直接消费 min_confidence 的思想）。
• 后续：第 9 章《三向选型》——集成成本是六轴之一，「接进现有工具链的难易」直接影响选型结论。
• 延伸阅读：编排与门控的可靠性工程见《Jev 决策编程》第 08 章《工程化生产》；评测侧的对接见《Evals 实战：LLM 评测工程》第 07 章《概率系统评测》。