Type Safe
返回集成目录
社区示例已核实可用2026-10-08

langgraph-jev 0.1.0 集成

一个社区维护的 LangGraph 与 LangChain 软件包，把 Jev 封装为类型化决策节点，支持状态范围、置信度策略和确定性路由。

安装

pip install langgraph-jev

服务端环境变量

TYPESAFE_API_KEY

准备事项

  • Python 3.11 或更高版本
  • 在应用中固定并测试 langgraph-jev 0.1.0
  • 保存在服务端环境中的 TypeSafe API Key
  • 用于处理低置信度结果的人工审核节点

接入步骤

  1. 1安装并固定社区软件包版本。
  2. 2创建包含类型化问题和可选置信度阈值的 JevNode。
  3. 3只需要发送或更新部分图状态时，设置 state_key 和 output_key。
  4. 4从 allow、human_review 和 error 中选择低置信度处理策略。
  5. 5把节点加入 LangGraph，并由应用代码根据类型化决策执行路由。
  6. 6接入 LangChain 时，通过 JevRunnable 使用 invoke 或 ainvoke。
服务端示例
from langgraph_jev import JevNode, choice, route_by_decision

jev = JevNode(
    state_key="structured_request",
    output_key="decision",
    questions={
        "work_type": choice(["bug", "support", "documentation"]),
    },
    thresholds={"work_type": 0.85},
    low_confidence="human_review",
)

def route_work(state):
    decision = state["decision"]
    if decision.requires_review:
        return "human_review"
    return route_by_decision(
        decision,
        field="work_type",
        routes={
            "bug": "coding_agent",
            "support": "support_agent",
            "documentation": "documentation_agent",
        },
        fallback="human_review",
    )

生产检查

  • 这是社区软件包，不属于 TypeSafe 或 LangChain 官方集成。
  • 应用关闭时需要释放长期使用的 JevClient 资源。
  • TYPESAFE_API_KEY 只保存在服务端，并排除决策不需要的状态字段。
  • 使用有代表性的工作流数据校准每个置信度阈值。
  • 保持下游路由确定性，并为有副作用的操作增加幂等保护。

限制与核实说明

langgraph-jev 0.1.0 是社区维护的适配器，会调用托管式 Jev API。软件包、TypeSafe API 和 LangGraph 的行为可能分别变化，因此需要固定版本并对三处边界进行回归测试。

相关页面

来源

这份指南由 Type Safe 独立整理。使用前请核对提供方的当前文档、版本和条款。