主动交互指南 · JS / 浏览器
主动交互指南 · JS / 浏览器
⚠️ JS SDK 暂未提供主动交互（任务流）。 本文档如实说明现状。
现状
JS SDK（linksoul-agentsdk）当前没有主动交互实现：
AgentSdk（src/agent-sdk.ts）不含TaskFlowRequest/registerTaskFlow/unregisterTaskFlow；- 没有
startRequest/taskRequest/endRequest/interruptRequest与对应的FlowStart/Task/End/InterruptCallback； - 没有技能查询 / 状态查询 / 拉流 / 推流监听等主动接口。
主动交互（SDK 主动向机器人下发任务流）请使用 Java / Python / Android / iOS SDK。详见：
与「扩展技能（ExtSkill）」的关系
v1.5.0 JS SDK 提供的 扩展技能 ExtSkill 是 SD 向机器人主动下发的一条已落地能力，但它与「任务流」是两回事：
| 任务流（Task Flow） | 扩展技能（ExtSkill） | |
|---|---|---|
| 定位 | 编排多步任务（start/task/end） | 查询 / 触发单个机器人扩展技能 |
| JS SDK | 暂未提供 | ✅ 已提供（ExtSkillSession） |
| 回调模型 | 无（未实现） | sdk.on('message') 按 type 判读 |
如果你在 Web 端需要一个"主动下发动作"的出口，可先用 ExtSkill 承载；任务流编排能力仍需 Java / Python / Android / iOS SDK。
浏览器侧的替代路径
Web 端若需要任务流编排，建议：由服务端代理用 Java / Python SDK 的 TaskFlowRequest 下发任务流，浏览器经自定义通道驱动。详见 架构概述。