插件
插件介绍
插件是一组可安装、可复用、可发布的能力包,将提示词、技能、工具、模型、知识库、Hooks 及项目文件统一封装,供 AI 工作台在创作、问答助手或特定业务入口中调用
核心特点
类别 | 说明 | 备注 |
完整能力封装 |
|
|
场景化解决 |
| 可在 AI 创作、问答助手、特定业务入口中调用 |
版本化管理 |
| / |
资源定位
类型 | 定位 | 适合场景 |
工具 | 最小原子能力,负责单一输入输出 | 查询、调用接口、处理单个动作 |
Skill | 可复用的执行逻辑或工作流 | 固定流程、工具组合、任务处理规范 |
插件 | 完整能力包,可组合多个资源并进行版本管理 | 面向业务场景的完整解决方案 |
插件分类
平台上的插件主要分为四大类:
- •空间插件:该团队空间下用户自创建的工具,仅在用户所在的空间下可被添加
- •个人插件:在该空间下用户自创建的插件,仅在该用户自行创建的产物下被添加
- •精选插件:由运营/平台侧配置上架的插件,在指定空间下被添加
- •定制体裁插件:指定业务空间的定制入口,作为新增项目下的定制体裁入口,不一定在项目库透出
插件创建
创建插件方式
方式 | 适合情况 | 操作要点 |
上传本地文件 | 已有插件文件包,或希望 用代码/文件方式灵活配置 | 上传 plugin.zip,至少包含 plugin.json 和 README.md,可包含 Skills、工具说明、Hooks、知识文件等 |
自然语言生成 | 只有自然语言需求,希望平台自动生成项目文件和配置 | 在对话区描述目标,必要时 @ 引用已有工具、技能、知识库,也可上传附件辅助生成 |
创建插件流程
步骤 | 详情描述 | 示意图 |
Step1:进入创建入口 |
| |
Step2:填写基础配置 |
| |
Step3:配置项目文件 |
| |
Step4:配置资源 |
| / |
Step5:配置 Hooks (可选) |
| |
Step6:调试与预览 |
| / |
Step7:保存并发布 |
|
审核状态与处理方式
状态 | 含义 | 用户操作 |
审核中 | 正在进行治理审核或安全审核 | 等待结果;若已有线上版本,通常继续消费上一个已发布版本 |
审核通过 | 审核完成并发布成功 | 可在可见范围内使用最新版本 |
审核未通过 | 存在内容或安全问题 | 查看检查清单,定位问题文件或代码行,修改后重新发布 |
审核主要覆盖两类问题:治理审核检查文本、图片、资源文件等内容是否合规;安全审核检查脚本、工具链式调用、内网资源访问等风险。
插件使用
选择插件后,插件内置的 Skills、工具、模型、知识库等资源会自动参与本次任务。插件内置模型与 Vibe 右下角的模型选择不是同一配置项,二者在运行时不冲突;手动剔除插件内置资源可能取消插件的选中状态,Hooks 等能力也可能不再生效。
步骤 | 详情描述 |
第一步:进入问答助手 |
|
第二步:打开插件面板 |
|
第三步:选择插件 |
|
第四步:描述任务 |
|
第五步:查看输出 |
|
四、常见问题
问题 | 原因 | 处理方式 |
发布时报 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
创建一个“数据异常诊断”插件,用于帮助运营分析指标波动。输入包括指标名称、当前数值、对比基准、变化幅度、业务背景和数据切片;输出包括异常结论、异常类型、可能原因排序、建议排查路径、需要补充的数据和临时应对建议。要求不要把相关性直接当因果,并对每个原因给出高/中/低置信度。创建一个“周报/月报生成”插件,用于根据工作进展、数据结果、风险问题和下期计划生成正式汇报。输出要包含本期总结、关键进展、数据表现、问题风险、解决动作、下期计划和需要协同的事项,语言简洁正式,突出结果。如需进一步完善本文,可补充真实页面截图、具体入口路径截图、插件文件包模板下载地址和线上示例插件链接。
