对话相关 JS API 使用与权限声明
卡片、页面或 Worker 可以通过 @doubao-dev/framework/api 调用宿主开放能力。下表同时标注当前已公开能力和正在建设的能力;建设中的能力不可按现有 SDK API 使用。
核心 API 一览
选型建议
- 需要直接调用 MCP 工具:规划使用
callTool;该能力仍在建设中,当前 SDK 仓库尚未公开导出,不能在现有业务代码中调用。 - 需要继续会话、请求宿主发起 API 调用或引导模型响应:使用
sendFollowUpMessage。content是消息数组,支持text、api/call和responseHint三种内容。 - 只需要补充 Agent 后续推理所需的业务状态:使用
updateModelContext。content必填,taskId和entityId可选。
调用示例
权限与运行环境
updateModelContext和updateWidget的公开契约标明:Android、iOS 无需预先申请应用 scope 或系统权限;PC、HarmonyOS 暂未提供实现。sendFollowUpMessage可在 Widget、应用插件页面或 Worker 中调用。宿主会根据调用位置关联对应会话;当前源码没有声明额外的权限契约,不应据此推断其他平台支持情况。