它能帮你做什么
这是 TypeSafe 提供的 JavaScript、TypeScript 官方客户端。你用它定义问题、发送上下文，再读取模型选择的类别或评分。在 TypeScript 中，回答类型可以随问题定义推断，开发时更容易发现字段使用不一致的问题。
在网站里，这次调用通常应放在服务端：用户提交表单，服务器请求 Jev，页面再展示建议结果。API Key 留在服务器环境中，不应跟着前端代码发给每位访客。
什么情况下适合用
如果网站已经有 JavaScript 后端，只想增加线索分类、工单分流这样一个具体功能，这是一条直接的路线。如果项目本身已经大量使用 AI SDK，也可以比较其接入方式，沿用团队熟悉的约定往往更方便。没有必要仅为一次简单判断，把现有架构全部换掉。
放到实际工作里看
网站收到一条咨询，可能是客户问价格，也可能是有人提出合作。服务端可以先让 Jev 建议分给哪个队列，处理人员打开后台时，同时看到原文和建议类别，并能手动修改。
用户连续点两次提交，要靠自己的请求编号防止重复入库；模型回答不会解决这个问题。同样，“很着急”的判断也不应该自动获得发送邮件或修改账号的权限，后续动作仍要经过业务规则。
第一次可以这样开始
- 核对当前运行时要求，在服务端项目安装 @typesafe-ai/sdk。
- 从部署环境读取 API Key，确认前端打包文件不会包含密钥。
- 定义少量边界清楚的类别，用一条样本检查返回结果。
- 为服务暂时不可用、分类不确定等情况准备可见的处理状态。
- 测试从表单提交到后台复核的完整过程，再连接后续自动操作。
选择前，想清楚这几件事
类型提示能发现字段写错，却发现不了类别定义不合理。结果即使完全符合类型，也可能把客户问题分给错误的团队。评估时应包含表达含糊、夹杂错别字、同时提出多个诉求的来信，以及客户实际使用的语言。
也别让用户一直等着页面转圈。如果分类不能及时完成，可以先保存咨询，再由后台补做判断。是否采用这种方式，要看你的产品流程；它不是安装 SDK 后自动获得的能力。
账号与使用成本
SDK 提供接入方式，不附带免费的模型调用额度。模型费用与网站托管费用分开考虑，估算时看每次发送的内容长度和实际调用次数。页面刷新、表单重试不应反复处理没有变化的内容，已有分类也应记录对应的问题和模型版本。