TypeSafe AI怎么用？API Key和三种问题这样配置

TypeSafe AI 可以先在 Playground 里试，再通过 API 或官方 SDK 接入。最短流程是：登录控制台取得 API Key，把待判断内容放入 state，选择 jev-latest，然后在 questions 中定义 Noul、Choice 或 Score。密钥只放在服务端环境变量，不要写进网页代码或提交到仓库。

先用 Playground 验证问题写法

把一条客服消息粘贴为 state，再添加“是否紧急”的 Noul 问题。接着增加一个部门 Choice 和情绪 Score，观察概率分布。若结果不稳，先改清楚 instructions 和 criteria，而不是立即堆更多背景。

API 请求需要哪些字段

{ "state": "付款连续失败三天，请尽快处理", "model": "jev-latest", "questions": { "department": { "type": "choice", "instructions": "应由哪个团队处理？", "criteria": { "billing": "支付、账单或退款", "technical": "故障、接口或集成" } }, "is_urgent": { "type": "noul", "instructions": "消息是否明确表达紧急性？" } } }

请求发送到 POST /v1/systemone，用 Bearer Token 鉴权。回答会沿用问题 ID，例如读取 answers.department.choice 和各候选概率。生产环境还应记录响应里的实际模型版本，便于升级后排查结果变化。

Python和JavaScript怎么选

Python SDK 要求 Python 3.10 及以上，可安装 typesafe-sdk；JavaScript 可使用官方 @typesafe-ai/sdk。两者都会从 TYPESAFE_API_KEY 环境变量读取密钥，并默认调用 jev-latest。已经有后端框架时，选择团队现用语言即可，不必为 TypeSafe 单独换技术栈。

第一次接入别直接自动执行

1. 准备一组包含正常、模糊和极端情况的真实脱敏样本。
2. 每个问题只判断一件事，把金额计算、日期比较留给代码。
3. 先记录结果和 confidence，不触发真实业务动作。
4. 根据误判样本调整标准，再设置自动通过与人工复核阈值。
5. 固定模型版本做回归测试，验证后再切换新版别名。

如果遇到 401，优先检查密钥和 Authorization 头；遇到 429，则按响应中的重试时间退避。把失败请求无限立即重试，只会让限流持续更久。