Levanto Sage — AI 文本分类与结构化决策 API

Levanto Sage 是什么，这个网站是干什么用的？

Levanto Sage 是 Levanto Labs 提供的 AI 文本分类与结构化决策 API。可以把它想成装在软件里的「分拣台」。例如，有客户留言说「同一笔订单扣了两次钱」，Sage 可以把这条消息归到付款问题，客服系统再把工单交给账务组。开发者可以在官网找到接入文档、打开控制台并创建 API 密钥。Sage 给出判断，实际要不要转单、交给谁处理，由你的程序决定。

按工单任务选择判断方式

• Choice 单选适合把一条工单分到一个队列，比如账务、物流或账号问题。
• Tags 标签逐项判断。客户一条留言同时提到收不到验证码和看不到账单时，可以分别判断两个标签。
• Yes/No 判断适合检查具体条件，比如「客户是否明确反馈重复扣费」。Scale 评分可以按你定义的等级判断紧急程度，Sort 排序可以按指定标准给一组待办排序。

先用团队已经标注过的工单核对模型结果。对一句话里混有多个问题的工单，优先验证标签是否分得开，再决定是否用单选结果自动分流。

从第一条工单开始接入

1. 在控制台打开 Decision model → API keys 创建密钥。在服务端保存密钥，调用时用 Bearer 认证。
2. 向 POST /decide 发送一条模拟工单。将原文放在 content，并给问题设置 ID、yesno 类型与明确指令，例如「这条消息是否提到了同一笔订单被重复扣费？」。
3. 读取 result.answer，对照你预先标注的结果。分别测试明确报告、完全无关和描述不清的消息。把不确定的结果、接口异常和额度耗尽分开处理，确认人工队列能收到待复核的工单后再连接生产流量。

把文本提取和流式判断接进业务

调用 POST /v1/extract 时提交文本和字段定义。比如从退款留言中提取明确写出的金额和日期，回看结果对应的原文位置后再写入系统。原文缺字段时可以返回空值，应用应保留这个状态，避免把缺失金额记成零。

客服对话还没结束时，可以连接 /v1/stream 的 WebSocket，先设定「这段对话是否需要升级给主管」，再追加新消息并读取更新的判断。流式会话只能追加文本，改动之前的消息要重开会话。官方文档列出的文本和问题合计上限为 16,384 个 token。

计费、额度和数据保留

2026 年 11 月 10 日核对的官网美元价目表提供每月免费额度和按月付费套餐。输入、输出 token 和实际执行的搜索都可能消耗额度。单次决策可用 POST /usage/estimate 预估用量，上线后可查看响应里的实际用量。 Sage 官方定价

常见问题

Sage 有免费额度吗？

有。Free 套餐每月提供使用额度，用完后调用会返回 HTTP 402，到下个周期或升级套餐后可继续调用。未用完的额度不会滚存。

提交给 Sage 的数据会用于模型训练吗？

Levanto 声明不会用 Sage 的输入或输出训练模型，也不会在普通推理结束后保留这些内容。失败或异常缓慢的请求有例外，完整请求和响应可能进入诊断日志，认证凭据会被遮盖，日志保留 30 天。 Levanto 隐私政策

返回 null 时该怎么办？

Yes/No 判断可能返回 null。给它安排单独的处理路径，例如交由人工复核。接口也会返回概率，业务如需更严格的阈值，可以先用自己标注的工单测试。

官方接入资源

• Sage API 快速入门 — 查看认证、决策和字段提取的完整请求示例。
• Levanto Labs 的 GitHub — 查看公开的示例项目和评测代码。