# LatenTX 文本客服 先完成用户现有应用中的文本多轮对话。沿用已有语言、UI、登录和后端,无需为接入而重建项目。 ## 契约 读取 https://api.latenth.com/docs/realtime-api.html;模型权限通过服务端 `GET https://api.latenth.com/v1/models` 确认。 浏览器连接伙伴自己的后端;后端用 `Authorization: Bearer ${LATENTX_API_KEY}` 连接 `wss://api.latenth.com/v1/realtime?model=实际型号`。长期 Key 不进入浏览器、URL、日志或代码仓库。平台 Key 的租户隔离不能替代伙伴应用内的终端用户和会话授权。 最小顺序: 1. 等待 `session.created`,发送 `session.update`,设置 `type: "realtime"`、`output_modalities: ["text"]`。仅在用户要覆盖默认提示词时传 `instructions`。 2. 等待 `session.updated` 后才允许发送消息。 3. 发送 `conversation.item.create`,item 为 `{type:"message",role:"user",content:[{type:"input_text",text:用户文本}]}`,随后发送 `response.create`。 4. 渲染 `response.output_text.delta`;以 `response.done.response.status` 区分 completed / cancelled / failed,保留 response ID 和服务端 usage。 5. 停止操作发送 `response.cancel`;等待终态再允许下一轮。处理 error、握手超时、响应超时和断线;保留已显示文字,不把失败视为成功。 一次上游连接承载同一业务会话,不跨用户复用。新连接不能直接当作恢复旧上下文;如需持久化,先设计伙伴的会话存储、恢复和消息幂等契约。断线不自动重发可能已经被计费的请求。 ## 首版交付 文本输入、增量回答、停止、清空并新建会话、状态和错误提示;输入法组词时 Enter 不发送。模型与业务提示词由后端约束。渲染文本时避免 HTML 注入;如使用 Markdown,关闭原始 HTML。 默认不实现图片、卡片、Function 或 MCP。它们不是完成文本聊天的前置条件。需要工具时重新读取官方工具生命周期:`response.done` 不必然意味着 MCP 完成;工具在后端执行并授权,不能把模型说“已办理”当作执行凭证。 需要完整参考工程时,使用 [Studio Partner](https://github.com/aibpo-labs/studio-partner),按仓库 README 和适用的工程内 Skill 选择复用范围。工程内已有 IM 实现时优先沿用;在现有应用接入时,无需引入参考工程。H5 组件演示不代表已接通真实服务;工程接口与平台协议分别核对。 ## 验收 使用已授权的测试范围验证连续三轮上下文、取消后继续、上游错误、断线和重复发送防护。没有 Key 时完成本地模拟和代理契约测试,明确标记“云端未验证”。报告实际验证范围;不因生成了界面就宣称真实客服已可用。 参考工程与独立验证脚本:[官方文档](https://api.latenth.com/docs/ai-skills.html#examples)。安装本 Skill 不下载或启动参考工程。