Jev 决策编程 · 第 4 章 快速开始

Jev 决策编程 · 第 4 章 快速开始

章节摘要：本章用五种方式跑通同一个决策——判断一条客服消息是否紧急。4.1 节用 curl 和 Python 原生 REST 裸调协议，看清 POST /v1/systemone 的请求与响应原貌（这是理解一切封装的基础，也是排障时的最后一层）；4.2 节换成官方 SDK（Python typesafe-sdk 与 Node @typesafe-ai/sdk），享受类型推断与内建的重试/超时选项；4.3 节接入两个框架：LangChain 的 TypeSafeClassifier 及其模型路由/工具护栏中间件，与 Vercel AI SDK 7 的 experimental_evaluate（注意命名映射：Noul 在此叫 boolean）。所有代码完整内嵌在本章各节中，拷出即用。

学习目标

阅读完本章，你应当能够：

1. 用 curl 或 Python 原生 REST 跑通第一个 Jev 调用并解读响应。
2. 用官方 SDK 写出类型安全的调用（Python 或 Node 任一）。
3. 在 LangChain / Vercel AI SDK 项目里接入 Jev，并知道两个框架各自的命名差异。
4. 按错误码表排障（401/422/429/529）。

核心概念速览

一句话金句：先用裸协议看懂一次请求，再用封装省掉九十九次重复。

子章节导航

4.1 第一个调用：curl 与 Python 原生 REST

协议原貌、完整 Python 脚本（01_hello_jev.py）、响应解读与分支逻辑。

4.2 官方 SDK：Python 与 Node

安装、类型推断、超时/重试选项；Node 完整脚本（hello_jev.mjs）。

4.3 框架集成：LangChain 与 Vercel AI SDK

TypeSafeClassifier、ModelRouterMiddleware、AutoModeMiddleware；Vercel 的 boolean 命名映射。

子章节之间的逻辑关系

4.1 裸协议（看清本质：请求长什么样、响应怎么读）
   │
   ▼
4.2 官方 SDK（日常写法：类型安全 + 内建重试）
   │
   ▼
4.3 框架集成（生态写法：中间件与工作流里的一环）
​

前置知识与后续延伸

前置知识：第 3 章三种问题类型（本章示例以 Noul 为主）；已按 0.2 节配好 TYPESAFE_API_KEY。

为后续奠定基础：本章的调用是第 5 章（扇出/置信度）、第 6~7 章（六大模式完整代码）的地基；错误码与幂等重试在第 8 章生产化中展开。