抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台

技能库

收藏
我的收藏

技能介绍

AI工作台的技能是一种强大的能力扩展机制,允许用户将自定义的执行逻辑、提示词、工具调用、流程与校验规则封装成可复用的组件,无缝被AI调用或被集成到AI应用中。通过技能,可以将复杂的任务自动化,达到节省token、提升处理效率的作用,并赋予AI应用超越基础模型的专业领域能力。

技能库分类

AI工作台提供「空间技能」、「个人技能」和「广场技能」、:
类型
名称
空间技能
用户自发创建的技能,当前平台支持本地开发上传、AI对话开发上传两种方式。
在该空间下的用户均可查看/使用,仅技能创建者和指定协作者能编辑
个人技能
用户自发创建的技能,当前平台支持本地开发上传、AI对话开发上传两种方式。
仅技能创建者和指定协作者可以查看/编辑/使用。
广场技能
由平台官方或三方上架提供的技能包,开放给全部用户调用,不可申请编辑。

技能创建

对话式创建

环节
说明
示例参考
AI开发与编辑技能
​
对话式创建。点击创建技能后,进入对话交互页面:
    •对话框通过自然语言描述技能需求
    ◦支持添加本地文件
    ◦支持在对话框输入@选择工具/知识库/其他技能资源
    •选择模型,默认⌈Auto⌋模型
    •点击箭头,进入AI生成技能
在技能配置页面,你可以进一步配置技能的基础信息,如封面、名称和描述,以及确认权限信息。
​
技能调试。页面中间泳道为调试区:
    •文件目录编辑:
    ◦支持文件夹/文件重命名、新建、删除、下载、上传
    ◦SKILL.md
    ▪只认技能文件包根目录下的SKILL.md
    ▪只认名称为“SKILL.md”的文件
    •文件目录上传文件格式支持:
    ◦.md、.txt、.json、.yaml、.yml、.py、.js、.jpg、.png
添加资源。
可持续通过对话框自然语言对话,补充调用资源和优化需求。
/
上传与配置技能
​
技能保存。
对话调试成功后,即可发布技能。
技能保存下来的版本会永久留存,支持用户回退至特定历史版本。
/
技能发布及查看。
点击右上角发布。
发布后,可在技能库-团队/个人技能中查看已发布的技能。
基于已有技能创建
​
查找已有的基础技能。
输入提示词,通过AI的方式二次编辑技能能力。
通过提示词修改技能能力。
调试和保存方式同上。

导入已有技能

环节
说明
示例参考
本地开发与打包
创建技能项目。在你的本地开发环境中,创建一个新的项目文件夹。
​
一个典型的技能包应包含以下结构:
my_douyin_Skill/ ├── Skill.md # 必需,Skill 的元数据和说明 ├── scripts/ # 可选,Skill的执行脚本 │ └── main.py └── references/ # 可选,脚本可能用到的资源文件 └── template.txt
编写SKILL.md元文件。SKILL.md是技能的“身份证”,必须放置在项目的根目录下。
❗注意:技能文件必须包含name和description字段;不出现非法字符,如下划线(_)、短横线(-)以外的符号;文件大小不超过50MB。以上要求会在上传环节校验。
元文件使用Markdown格式,包含以下关键字段:
# Skill.md 示例 name: "日报生成器" description: "根据指定的数据源生成每日业务分析报告。" version: "1.0.0" instructions: | 你是一个专业的报告生成助手。当用户要求“生成日报”时,请调用此 Skill。 获取到报告的数据源和日期范围参数后,执行 `scripts/main.py` 脚本,并将最终生成的报告文件路径返回给用户。 parameters: - name: "data_source" type: "string" description: "数据源的标识,例如 'sales_db' 或 'marketing_api'。" required: true - name: "date_range" type: "string" description: "报告的日期范围,格式为 'YYYY-MM-DD,YYYY-MM-DD'。" required: true
编写执行脚本。在scripts/目录下编写你的核心逻辑代码。
​
例如,main.py 可能如下所示:
# scripts/main.py import os import sys def generate_report(data_source, date_range): # 伪代码:根据参数连接数据源、查询数据、生成报告 print(f"正在根据数据源 {data_source} 生成日期范围为 {date_range} 的报告...") report_content = f"这是 {date_range} 的业务报告。\n数据来源:{data_source}。\n销售额:100万。" # 将报告保存到文件 report_path = "/tmp/daily_report.txt" with open(report_path, "w") as f: f.write(report_content) # Skill 的输出应符合平台规范,通常是将结果打印到 stdout print(f"报告已生成:{report_path}") return report_path if __name__ == "__main__": # 从命令行参数或环境变量中获取平台传入的参数 # 注意:实际的参数传递方式请参考平台最新文档 ds = os.getenv("Skill_PARAM_DATA_SOURCE", "default_source") dr = os.getenv("Skill_PARAM_DATE_RANGE", "today") generate_report(ds, dr)
打包技能。将整个项目文件夹(例如my_work_Skill/)压缩为一个.zip文件。确保SKILL.md文件位于压缩包的根目录。
/
上传与配置技能
在工作台左侧导航栏中,进入技能库页面。
​
单击页面右上角的+创建技能按钮。
在创建页面中,选择导入方式和发布范围。
    •上传本地技能压缩包:将你本地打包好的.zip或.Skill文件拖拽或点击上传
    •从Codebase导入:通过输入仓库URL进行识别
    •从AgentBuddy导入:通过选择获取方式快速呈现技能列表,选择目标技能导入
​
平台会自动对上传的压缩包进行校验。
    •校验成功:文件上传成功后,系统会自动读取SKILL.md中的name和description字段,并填充到表单中,你也可以在此基础上进行编辑。此时,一个草稿版的技能已创建完毕。
    •校验失败:如果缺少SKILL.md文件或必要的字段,系统会给出明确的错误提示,例如:“上传失败:缺少必需的SKILL.md文件”。
在技能配置页面,你可以进一步配置技能的基础信息,如封面、名称和描述,以及确认权限信息。
​
在预览页面,调试技能当前效果,确认无误可以点击右上角发布。
在发布配置页面,确认技能基础信息-名称、发布场景、权限范围以及发布版本,点击确认发布后完成上线。

技能库使用

方式
描述
示例参考
添加技能
​
    •智能编排下添加技能
    •AI Coding下添加技能
    ◦在人设编辑器中,允许使用@SkillName来引用一个已上传的技能
    ◦SkillName默认对应SKILL.md中的name

技能管理

环节
描述
示例参考
技能版本管理
​
版本管理与回滚。平台会记录你每次发布或保存的技能版本。在技能的变更管理页面,你可以:
    •查看所有历史版本,包括版本号、更新时间、发布状态等。
    •选择任意一个历史的变更版本,执行回滚操作,快速将线上服务恢复到该版本。
    •支持部署ppe进行测试
技能下线
​
删除。对于不再需要的技能,你可以执行删除操作。
    •为防止对线上应用造成影响,平台会进行引用关系校验。如果该技能正在被一个或多个智能体使用,系统会阻止删除,并提示你先解除引用关系。