Type Safe
返回集成目录
社区示例需要复核可用2026-09-28

Jev 与 Spring AI

在 Spring AI 应用旁消费已校验 Jev 决策的静态 Java 边界方案，不宣称存在原生提供商支持。

准备事项

  • Java 17 或更高版本的应用
  • 通过独立路径取得并完成校验的 Jev 决策
  • 经过校准的置信度阈值
  • 人工复核处理流程

接入步骤

  1. 1通过应用边界接收已校验的 Jev 决策。
  2. 2调用策略前检查选择结果非空、置信度有效且阈值在有效范围内。
  3. 3应用纯 Java 决策策略。
  4. 4将低置信度结果交给人工复核。
  5. 5把通过的动作传入外围 Spring AI 工作流。
  6. 6将提供商专用的传输逻辑留在此示例之外。
服务端示例
public record JevDecision(String choice, double confidence) {}

public enum RouteAction { ACCEPT, HUMAN_REVIEW }

public final class JevDecisionPolicy {
    private JevDecisionPolicy() {}

    public static RouteAction route(JevDecision decision, double threshold) {
        if (decision == null) {
            throw new IllegalArgumentException("decision is required");
        }
        if (decision.choice() == null || decision.choice().isBlank()) {
            throw new IllegalArgumentException("choice is required");
        }
        if (!Double.isFinite(decision.confidence()) ||
            decision.confidence() < 0.0 || decision.confidence() > 1.0) {
            throw new IllegalArgumentException("confidence must be between 0 and 1");
        }
        if (!Double.isFinite(threshold) || threshold < 0.0 || threshold > 1.0) {
            throw new IllegalArgumentException("threshold must be between 0 and 1");
        }
        return decision.confidence() < threshold
            ? RouteAction.HUMAN_REVIEW
            : RouteAction.ACCEPT;
    }
}

生产检查

  • Spring AI 的 OpenAI 兼容配置不代表与 TypeSafe 兼容。
  • 如果以后实现 TypeSafe 传输层，应将其放在专用适配器中。
  • 校验决策，为下游操作设置幂等保护，并保留审计记录。
  • 固定 Java 和 Spring AI 版本，上线前核实行为。
  • 不要在日志中记录敏感输入或决策数据。

限制与核实说明

Spring AI 文档介绍了 OpenAI 兼容的聊天配置，而 TypeSafe System One 使用自己的决策 API。Spring AI 尚无文档化的 TypeSafe 原生提供商，因此本页展示应用边界方案，不能直接当作即插即用的提供商集成。

来源

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