INTERACTIVE WASM API V2 / MODELS

配置模型服务

models.configure：通过带 request id 的 API v2 命令请求宿主服务，再由 result 事件取得对应结果。

方法概览

方法

API v2 command

models.configure

执行边界

命令由 TradingAI 宿主校验并执行。Guest 输出命令后不会同步等待结果；宿主在后续 result 事件中用相同的 id 返回结果或错误。

参数

按下列字段准备参数。表格概括参考摘要，具体类型、值域和运行时检查请展开完整说明。

参数字段说明
字段	用途	摘要中的要求
`provider`	模型服务提供方；当前摘要指定 typesafe。	必填
`enabled`	启用或停用。	可选
`model`	模型标识。	可选
`clear_api_key`	是否请求清除宿主管理的模型凭据。	可选

查看完整参数摘要

参数来源摘要

{provider:"typesafe",enabled?,model?,clear_api_key?}

该摘要来自源码参考文本，不是独立的 JSON Schema。最终输入由目标宿主校验。

结果摘要

返回模型设置。凭据输入由宿主对话框处理。

宿主通过 result 事件返回结果，事件中的 id 与命令一致。请用这个标识关联请求，处理成功数据或错误。

查看结果字段与完整约束

结果来源摘要

settings; host owns secret entry dialog

Capability 权限

必需能力

使用模型服务（languageModel）

条件能力

使用宿主管理的凭据（secrets）：此命令还要求 secrets 通过宿主的实际授权校验。扩展清单中的声明本身不构成授权。
查看源码判定
command.kind == InteractiveWasmCommandKind.modelsConfigure && !capabilities.contains(ExtensionCapability.secrets)

API v2 命令信封

命令放在 api_version: 2 输出 envelope 的 commands 数组中，每条请求使用唯一 id。以下只包含当前方法，不会一次调用所有方法。

需补参数的协议骨架

{
  "api_version": 2,
  "views": {},
  "commands": [
    {
      "id": "request-1",
      "method": "models.configure",
      "params": { /* TODO: 按下方源码参数摘要填写 */ }
    }
  ]
}

参数 TODO 尚未填写，因此此块是说明性 JSONC 骨架，不是可提交的 JSON。按方法参数和 capability 完成配置后，宿主才会处理该请求。

完整 SDK 契约与高级说明

下载完整 SDK reference JSON · 阅读运行时高级参考与 29 个方法总览 · 查看契约快照与版本

此页反映仓库内的 SDK reference 快照，并不证明每种宿主、客户端版本或扩展都已实际接入此方法。部署可用性应在目标客户端和服务中核验。