7 分钟阅读

跨入口使用已安装插件

在 Workbench、CLI、HTTP API 与 SDK 中发现并调用同一账号可用的插件能力。

先发现实际能力#

在 Workbench 查看插件安装与启用状态。CLI 分别列出账户扩展和完整 Runtime 插件，再读取工具 schema：

终端

zioon extensions list
zioon extensions show LISTING_ID
zioon extensions list --host runtime
zioon extensions show dev.agent-device-cloud --host runtime
zioon api GET /v1/capabilities/tools

安装形式	CLI 参数	执行请求
账户代码 / MCP 扩展	默认宿主	metadata.extensionInvocation
完整 Runtime SDK 插件	--host runtime	metadata.pluginToolInvocation
Skill	安装后在 Agent 工作中使用	不是直接工具 call

在 Workbench 使用#

插件可提供侧栏、命令和对话工具。在对话中提出任务时，模型只能选择当前运行获准的工具。插件的连接或设置命令可以独立于会话运行；ADC“连接 ADC”用于完成它自己的 OAuth。

在终端直接调用#

终端

zioon extensions call LISTING_ID --tool hello --args '{"name":"Zioon"}'
zioon extensions call dev.agent-device-cloud --host runtime \
  --tool adc_status --args '{}'

命令通过 Run 提交，返回 Run ID、状态与工具输出。服务端检查工具是否属于所选插件、交互配置是否允许调用，并记录执行回执。若默认交互配置未授权该工具，使用你有权限且允许该工具的真实 --profile。

通过 API 调用完整插件#

先获取工具目录，再构造请求。以下是已安装 ADC 插件的状态工具示例；保存为 plugin-run.json，使用真实允许该工具的交互配置：

plugin-run.json

{
  "prompt": "Read ADC connection status",
  "interactionProfileId": "YOUR_ALLOWED_PROFILE_ID",
  "policy": { "preset": "read-only", "allowedTools": ["adc_status"] },
  "metadata": {
    "pluginToolInvocation": {
      "pluginId": "dev.agent-device-cloud",
      "tool": "adc_status",
      "arguments": {}
    }
  }
}

终端

zioon api POST /v1/runs --data-file plugin-run.json
zioon attach RUN_ID --jsonl

账户扩展使用 snapshot 中真实的 listing ID、executionEpoch 和执行配置，由 SDK 的 extensionRunRequest 构造请求。完整插件使用 runtimePluginToolRequest，避免把两种请求混在一起。

相同授权与回执#

CLI、API、SDK 和 Workbench 复用服务端 Run 与工具执行路径。插件安装不绕过账户、项目和设备权限；超时或取消后收到 execution_outcome_unknown 时，先检查实际结果。

adc_status 返回 connected: false 说明尚未连接；Run 完成只证明状态查询完成，不能推断设备任务已经执行成功。

最后核对：2026-10-28 · 能力以实际部署与账号权限为准