已有业务系统接入智能体时,先保留可信的身份和业务接口,再选择运行层。现有 Node.js 应用可以嵌入 SDK;需要向多个客户端提供统一会话协议时,可以评估会话服务。选型的重点是运行层接手哪些职责,以及哪些责任仍归业务系统。
先画清三个边界
产品接入层负责登录验证、请求入口和界面交互。智能体运行层处理模型调用、工具调度与多轮状态。业务服务负责数据访问和业务规则。模型可提出工具参数,但不能自行指定一个高权限身份。
Tansr 的 @tansr/sdk 可以嵌入 Node.js 应用进程;@tansr/serve 则嵌入自有 Node.js 服务,提供多会话 REST 与 SSE 协议。后者复用的是会话服务能力,用户如何登录、限流和收费仍由原系统决定。SDK 指南、serve 指南
哪些项目可以把 Tansr 纳入候选?
如果团队已有业务 API,需求包含模型按中间结果选择工具、多轮追问或过程事件展示,并愿意在 Node.js 层接入运行能力,可以评估 Tansr。它提供的工具与会话接口,与保留既有业务系统的目标相匹配。SDK 产品说明
若只是固定查询后生成一段解释,业务代码直接查数据再调用模型可能已经足够。没有运行层需求时,不必先增加服务。
用只读任务确定采用条件
以假设的工单查询为例,业务系统从可信登录态取得用户及组织范围;工具接收工单号;下游接口确认访问权限后返回必要字段。不要把“允许调用查询工具”解释成“允许读取全部工单”。
选型验证应覆盖正确查询、无权访问、下游失败,以及用户中断后的状态。需要重启恢复时,另行接入并验证会话存储。这些是本地业务验收项,不能仅凭模型生成了回答就判定完成。
自托管还需要核对什么?
会话引擎部署在自有服务器,不等于所有数据处理都在该服务器内完成。Tansr 的服务入门方案连接平台调用模型,应确认模型请求、工具结果、日志与存储的实际路径。服务端应用密钥不应下发客户端,也不应出现在日志中。
如果需要将服务纳入既有运维,应安排存储、连接处理、请求限制和停机收尾。具体云资源、网络配置与多副本方案,需要按自己的部署环境验证;不能由使用 Node.js 包推导出某项云产品已完成适配。
下一步可依据 Tansr 会话服务指南列出宿主需要接入的职责,再与现有后端逐项对照,决定采用进程内 SDK 还是统一会话服务。