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

插件

收藏
我的收藏

插件介绍

插件是一组可安装、可复用、可发布的能力包,将提示词、技能、工具、模型、知识库、Hooks 及项目文件统一封装,供 AI 工作台在创作、问答助手或特定业务入口中调用

核心特点

类别
说明
备注
完整能力封装
    •将提示词、技能、工具、模型、知识库、Hooks 及项目文件统一封装为能力包,随插件一起被调用
    •支持对插件内多个资源进行组合与版本管理
工具解决一个动作,Skill 解决一段流程,插件解决一个业务场景。
场景化解决
    •面向业务场景的完整解决方案,如数据分析专家、内容创作专家、自然语言生成 Skill 等
可在 AI 创作、问答助手、特定业务入口中调用
版本化管理
    •保存会形成可追踪变更,发布会生成可消费版本
    •支持 PPE 预发验证与发布审核
/

资源定位

类型
定位
适合场景
工具
最小原子能力,负责单一输入输出
查询、调用接口、处理单个动作
Skill
可复用的执行逻辑或工作流
固定流程、工具组合、任务处理规范
插件
完整能力包,可组合多个资源并进行版本管理
面向业务场景的完整解决方案

插件分类

平台上的插件主要分为四大类:
    •空间插件:该团队空间下用户自创建的工具,仅在用户所在的空间下可被添加
    •个人插件:在该空间下用户自创建的插件,仅在该用户自行创建的产物下被添加
    •精选插件:由运营/平台侧配置上架的插件,在指定空间下被添加
    •定制体裁插件:指定业务空间的定制入口,作为新增项目下的定制体裁入口,不一定在项目库透出

插件创建

创建插件方式

方式
适合情况
操作要点
上传本地文件
已有插件文件包,或希望用代码/文件方式灵活配置
上传 plugin.zip,至少包含 plugin.json 和 README.md,可包含 Skills、工具说明、Hooks、知识文件等
自然语言生成
只有自然语言需求,希望平台自动生成项目文件和配置
在对话区描述目标,必要时 @ 引用已有工具、技能、知识库,也可上传附件辅助生成

创建插件流程

步骤
详情描述
示意图
Step1:进入创建入口
    •进入插件管理页,点击【创建插件】,选择一种创建方式
Step2:填写基础配置
    •插件名称:简短描述核心能力,不超过平台限制
    •插件描述:说明解决什么问题,避免泛化
    •封面描述:面向用户说明适用场景和收益
    •展示范围:可仅展示 README,普通用户建议不开文件目录
    •是否允许下载:内部复用可开启,敏感配置建议关闭
    •记忆开关:需要跨会话沉淀偏好或上下文时开启
Step3:配置项目文件
    •plugin.json:必需,插件的核心调用与执行说明,与平台基础配置双向回写
    •README.md:必需,插件使用说明,影响详情页展示与用户理解
    •system_prompt.md:可选,用于定制体裁入口或固定行为约束
    •skills/、tools/、hooks/settings.json:可选,复杂 Hooks 建议通过文件上传路径承载
​
Step4:配置资源
    •Skills:封装可复用流程或专业能力,避免堆叠无关能力
    •工具:提供搜索、查询、生成、调用接口等原子能力,确保描述清楚、输入输出稳定
    •模型:按输出体裁选择;文本生成模型通常配置一个,图片/视频模型可按场景配置多个
    •知识库:提供业务知识、规范、资料来源,适合客服、业务问答、专业资料检索场景
/
Step5:配置 Hooks
(可选)
    •Hooks 可在 Agent 会话不同阶段触发,用于拦截、补充上下文、调用命令或 HTTP 服务
    •常见事件:UserPromptSubmit(补充上下文、校验输入)、PreToolUse(拦截高风险调用、修改参数)、PostToolUse(检查结果、记录日志)、Stop(阻断停止、收尾动作)、失败类事件(兜底与告警)
    •配置前确认触发范围、外部请求地址、环境变量和数据访问边界
​
Step6:调试与预览
    •输入典型用户问题或上传测试文件,观察输出是否符合 README、system prompt 与资源配置预期
    •建议至少准备标准输入、边界输入、异常输入三类样例
    •结果不符时,按 Prompt → 资源 → 工具 → 知识库 → Hooks 顺序排查
    •需要验证线上前环境时,可选择 PPE 版本部署运行
/
Step7:保存并发布
    •点击保存,确认当前编辑内容已落盘
    •进入变更管理/发布管理,查看本次变更 Diff,确认文件、配置、资源引用符合预期
    •选择发布类型(个人/空间/广场/定制体裁)与可见范围,提交发布
    •等待审核结果

审核状态与处理方式

状态
含义
用户操作
审核中
正在进行治理审核或安全审核
等待结果;若已有线上版本,通常继续消费上一个已发布版本
审核通过
审核完成并发布成功
可在可见范围内使用最新版本
审核未通过
存在内容或安全问题
查看检查清单,定位问题文件或代码行,修改后重新发布
审核主要覆盖两类问题:治理审核检查文本、图片、资源文件等内容是否合规;安全审核检查脚本、工具链式调用、内网资源访问等风险。

插件使用

选择插件后,插件内置的 Skills、工具、模型、知识库等资源会自动参与本次任务。插件内置模型与 Vibe 右下角的模型选择不是同一配置项,二者在运行时不冲突;手动剔除插件内置资源可能取消插件的选中状态,Hooks 等能力也可能不再生效。
步骤
详情描述
第一步:进入问答助手
    •进入 AI 创作 → 问答助手
第二步:打开插件面板
    •点击输入框附近的【扩展】,切换到「插件」分类
第三步:选择插件
    •选择需要使用的插件,一次对话通常只选择 1 个;再选择另一个插件会替换当前已选插件
第四步:描述任务
    •在输入框描述任务目标,例如“帮我基于这份数据生成异常诊断报告”
第五步:查看输出
    •查看输出结果,如需调整可继续补充要求

四、常见问题

问题
原因
处理方式
发布时报 plugin.json 或 README.md 缺失
必需文件不存在或为空
在项目文件区补齐文件并重新保存发布
选择插件后效果不符合预期
Prompt 不明确、资源配置不匹配或知识库未命中
先在调试区复现,再逐项检查 Prompt、工具、Skill、知识库和 Hooks
手动剔除资源后插件失效
剔除了插件的关键内置资源
重新选择插件,或确认是否需要保留该资源
审核未通过
内容治理或安全审核发现问题
查看检查清单,按文件或代码行修改后重新提交
不知道如何描述自然语言生成插件需求
目标、输入、输出或资源不清晰
按“我要创建一个……用于……输入……输出……需要调用……”格式描述

附录

    1.发布前检查清单

    •插件名称、描述、封面描述能准确说明用途
    •README.md 已说明适用场景、输入、输出、使用步骤和注意事项
    •plugin.json 存在且内容非空
    •system prompt 如有使用,已写清角色、边界和输出格式
    •Skills、工具、模型、知识库只保留必要资源
    •Hooks 如有配置,已确认触发时机、请求地址和安全边界
    •已完成标准样例、边界样例和异常样例调试
    •已查看变更 Diff,确认没有误改文件或配置
    •已选择正确的发布类型和可见范围

    2.推荐的 README.md 模板

# 插件名称 ## 适用场景 说明这个插件适合解决什么问题,不适合什么问题。 ## 输入要求 - 需要用户提供哪些信息 - 是否支持附件 - 是否需要指定数据源或业务背景 ## 使用步骤 1. 在问答助手中选择该插件 2. 输入任务目标 3. 补充必要材料 4. 查看输出并继续追问 ## 输出结果 说明插件会输出哪些内容、格式是什么。 ## 注意事项 说明限制、风险、数据口径、安全边界等。 ## 示例 Prompt 给出 1-3 个可直接复制的使用示例。

    3.示例 Prompt

创建一个“数据异常诊断”插件,用于帮助运营分析指标波动。输入包括指标名称、当前数值、对比基准、变化幅度、业务背景和数据切片;输出包括异常结论、异常类型、可能原因排序、建议排查路径、需要补充的数据和临时应对建议。要求不要把相关性直接当因果,并对每个原因给出高/中/低置信度。
创建一个“周报/月报生成”插件,用于根据工作进展、数据结果、风险问题和下期计划生成正式汇报。输出要包含本期总结、关键进展、数据表现、问题风险、解决动作、下期计划和需要协同的事项,语言简洁正式,突出结果。
如需进一步完善本文,可补充真实页面截图、具体入口路径截图、插件文件包模板下载地址和线上示例插件链接。