启用市场技能

什么时候用

想快速获取平台提供的官方技能，而无需从零开发时--比如网页搜索、天气查询、代码执行等常用能力，直接从技能市场克隆即可使用。克隆后的技能归属于你的，可以按需修改描述、SKILL.md 内容，或关联自己的 MCP 工具。

技能需要绑定到智能体才能生效，绑定方式见「创建并配置智能体」第 3 步。

你需要准备

• 无需前置准备，技能市场是平台维护的官方资源，所有都可访问和克隆。
• 如果要给克隆后的技能绑定 MCP 工具，需先在「MCP 网关」中注册并同步工具（详见「注册上游 MCP Server」）。

操作步骤

第 1 步：进入技能中心

左侧菜单 -> 技能中心。

页面默认显示「我的技能」Tab，点击切换到「技能市场」Tab，查看平台提供的官方技能。

第 2 步：浏览技能市场

技能市场以卡片形式展示官方技能，每张卡片包含：

• 技能显示名称和内部标识
• 技能功能描述
• 「添加到我的技能」按钮

可以滚动浏览或搜索找到需要的技能。

第 3 步：克隆技能到我的技能

点击目标技能卡片上的「添加到我的技能」按钮，在确认对话框中点击「确定添加」。

成功后页面会自动切换到「我的技能」Tab，新克隆的技能出现在列表中。

第 4 步：（可选）编辑克隆的技能

在「我的技能」列表中，点击技能右侧的「编辑」按钮，可修改：

• 显示名称
• 技能描述
• 关联 MCP 工具
• SKILL.md 内容

技能标识（name）克隆后不可修改。

第 5 步：将技能绑定到智能体

技能克隆并配置完成后，需要绑定到智能体才能在对话中使用。绑定方式见「创建并配置智能体」第 3 步。

怎么验证成功了

1. 在「我的技能」列表中能看到刚克隆的技能
2. 点击「编辑」能查看和修改技能的完整配置
3. 在创建或编辑智能体的「选择技能」下拉中能搜索并选中该技能
4. 给智能体分配用户并创建 API Key，用 OpenAI SDK 调用，能观察到技能被 LLM 正确调用

常见问题

技能市场是空的怎么办

技能市场由平台管理员维护，可能暂时没有上架技能。稍后再来查看，或使用「创建自定义技能」开发自己的技能。

克隆后想改技能标识（name）

技能标识克隆后不可修改。如果确实需要不同的标识，删除当前技能，重新克隆后立即用不同标识创建自定义技能。

克隆的技能能删除吗

可以。克隆后的技能归属于你的，删除不影响技能市场和其他。但删除前建议检查「关联智能体」列，避免影响正在使用该技能的智能体。

克隆后的技能和市场技能是什么关系

克隆是复制操作，克隆后的技能独立于市场技能。市场技能后续更新不会自动同步到你的，如需更新可再次克隆（会创建新技能，不会覆盖原技能）。

深入

核心概念

技能字段

一个技能通常包含：

• name：内部标识，也是目录名语义
• display_name：展示名称
• description：描述
• is_public：是否通用技能
• status：状态
• skill_md：SKILL.md 内容，存数据库
• mcp_tool_ids：请求中传入的 Tool ID 数组
• mcp_tools：响应中的 Tool 列表
• agents：关联 Agent 列表

本租户技能与系统市场技能

列表接口会同时返回本租户技能和系统市场技能。

name 命名规则

name 只能包含：

• 英文字母
• 数字
• 下划线 _
• 横杠 -

空格、点号、斜杠、中文字符都会被拒绝。

通用技能与专用技能

is_public=true 表示通用技能。

is_public=false 表示专用技能。

该字段不突破租户隔离；系统市场共享依赖 tenant_id=0。

MCP Tool 绑定

技能与 MCP Tool 是多对多关系。

绑定规则：

• 技能必须属于当前租户
• MCP Tool 必须属于当前租户
• 重复绑定会跳过
• 解绑只删除关系，不删除 Tool

Local 技能与可执行代码

受控可执行文件集合为 {main.py}。SaaS 模式下普通租户 admin 不可编辑 main.py / Local 技能；Private 模式下租户 admin 可编辑；平台管理员始终有权限。

权限边界

常见坑

• 系统市场技能在列表中可见，但详情可能不存在，请先克隆
• name 包含空格、点号、斜杠会被拒绝
• 同租户 name 重复返回错误
• 普通租户传 target_tenant_id 不会生效
• 绑定其它租户 Tool 不会获得跨租户能力
• 可执行代码权限按部署模式控制

排错速查

• 想从零开发自己的技能？见「创建自定义技能」
• 想把技能绑定到智能体？见「创建并配置智能体」