默认工具配置

组织级默认工具配置,支持新建工作空间自动初始化和手动推送

默认工具配置

功能概述

组织管理员可以配置默认的 Plugin 和快捷命令,使新建工作空间能够开箱即用。同时支持手动将默认工具推送到已有工作空间。

权限说明:仅组织管理员可使用此功能。

默认工具

核心概念

继承机制

新建工作空间时,系统会自动根据组织级的默认工具配置进行初始化。仅标记为"新建空间默认添加"的工具会自动初始化,未标记的工具不会自动添加到新空间,但仍可手动推送。

幂等新增原则

  • 推送逻辑始终为"已存在则跳过,不存在则新增"
  • Plugin 按 pluginId 判重,QuickCommand 按 name 判重
  • 默认不会删除或修改工作空间已有的配置
  • 可开启"强制更新"模式,覆盖工作空间中已有的同名配置

推送与自动添加的区别

操作触发方式影响范围受"新建空间默认添加"开关控制
自动添加系统在创建工作空间时自动执行仅新建的工作空间
手动推送管理员主动选择工作空间并推送指定的已有工作空间否,所有配置均可推送

使用方法

1. 进入配置

组织详情页 → 默认工具 Tab

2. 添加默认 Plugin

  • 点击"添加 Plugin"从 Plugin 列表中选择
  • 可选择公开 Plugin 或本组织的内部 Plugin
  • 每个工具可通过开关控制是否在新建空间时自动添加
  • 支持删除操作

3. 添加默认快捷命令

  • 点击"添加快捷命令"创建新的默认命令
  • 填写名称、图标、分类、提示词模板、变量定义
  • 支持编辑、删除操作
  • 每个命令可通过开关控制是否在新建空间时自动添加
  • 支持通过 YAML 文件批量导入导出

YAML 导入导出

  • 导出:点击"导出"按钮,将当前所有默认快捷命令下载为 .yaml 文件
  • 导入:点击"导入"按钮,上传 .yaml 文件批量创建快捷命令
  • 导入时同名命令会自动跳过,并在结果中提示跳过的命令名称
  • YAML 格式示例:
quickCommands: - name: "生成 PPT" icon: "📊" category: "文档转换" description: "基于主题或知识库文件生成演示文稿" promptTemplate: "请使用 pagecraft 工具帮我生成一份 PPT..." variables: - name: "topic" label: "演示主题" type: "text" required: true isActive: false sortOrder: 100

4. 推送到工作空间

  • 点击"推送到工作空间"按钮
  • 可选择全部工具或指定工具进行推送
  • 目标范围仅限本组织下的工作空间
  • 最多同时选择 100 个工作空间
  • 支持按名称关键字和分类关键字筛选工作空间
  • 推送对话框中,未开启"新建空间默认添加"的工具会显示"非默认"标签,但仍可正常选择推送

推送默认工具

默认工具配置 | Knodo 文档