插件工具 SDK（agent-capability）

不要为纯对话 API 能力单独填 platform_plugins（会多出一套无用的 iframe / launch_token / 应用入口）。

来源 sdk/agent-capability/README.md

目录名：sdk/agent-capability 用途：在 消息里让工作区智能体调用你的业务能力（识脸、画图、查业务 API 等）——不注册 platform_plugins，无应用桌面 iframe 入口。

表述：用户在工作区对话中触发能力；你交付 HTTP/MCP 能力服务 + 工作区技能；Cadau 侧靠 联网能力包 与内置 http_request 执行。
与插件应用的区别：见 ../platform-plugin/README.md（应用桌面完整 Web + launch_token）。
与传软嵌入的区别：见 ../host-embed/README.md（宿主业务页挂嵌入助手）。
与 appsdk 的区别：见 ../appsdk/README.md（工作区内部轻量应用包，非第三方 HTTP 能力服务）。

文档版本：0.1（机制真值；专用代码包与脚手架待后续迭代）

1. 适用场景

| | 插件工具（本目录） | 插件应用 | |--|------------------------|--------------| | 用户从哪进 | 消息里对工作智能体说话 | 应用桌面 tile → iframe | | Cadau 侧 | 联网能力包 + 技能 + http_request | platform_plugins[]、launch_token、知识同步 | | 你的交付 | 能力 HTTP 服务（按 workspace_id 隔离）+ SKILL.md | Web UI + API + platform-plugin/go | | 注册 platform_plugins | 否 | 是 |

不要为纯对话 API 能力单独填 platform_plugins（会多出一套无用的 iframe / launch_token / 应用入口）。

2. 接入步骤（当前实现）

部署 能力 API（PostgreSQL/MySQL 等；业务表带 workspace_id 隔离）。
工作区管理员开通 联网请求 能力包（http_integration）。
编写 工作区技能（SKILL.md）：何时使用、http_request 如何调你的 API、鉴权与参数。
将技能 安装到工作区技能中心（区内智能体默认可召回；勿默认改写各智能体的「可用技能」收窄列表）。

Cadau 不会为每个业务 API 自动注册一个内置工具名；模型通过 技能说明 + http_request 调用你的服务。

3. 与插件应用组合

插件应用可同时具备：

能力	路径
界面与人工操作	`platform-plugin`
智能体了解插件背景	插件知识同步 → 工作区 `plugin-{module_id}/`
消息里按步骤做插件领域操作	插件仓库 `skills/{slug}/` → 技能中心（`platform-plugin` §7.5）
消息里调插件外 HTTP API	本目录 §2（技能 + 联网能力包）

4. 决策树

需要应用桌面里的完整 Web 界面？
  ├─ 否 → 插件工具：能力服务 + 技能 + 联网能力包（本目录）
  └─ 是 → 插件应用：platform-plugin
        ├─ 还要背景说明进对话？→ knowledge/ 同步
        ├─ 还要程序性操作手册？→ skills/ 随发 → 技能中心
        └─ 还要消息里调外部 HTTP API？→ 再加本目录 §2

5. 进一步阅读（机制真值）

文档	说明
工作区能力包.md	联网能力包、`http_request`
技能组成规范.md	`SKILL.md` 契约、触发说明
platform-plugin §7.5	插件随发技能 → 技能中心
sdk/README.md	四类 SDK 总览

6. 规划（未交付）

以下能力尚未形成独立代码包或脚手架，实施时仍以 §2 与机制文档为准：

[ ] 能力服务最小模板（HTTP + workspace_id 鉴权示例）
[ ] 技能包 starter（SKILL.md + references/）
[ ] MCP 适配层（若产品启用 MCP 路径）

并列 SDK：host-embed · platform-plugin · appsdk · 本目录。