文档中心/ 百度搭子/ 企业版使用指南/ 管理平台/ 能力扩展管理/ 套件管理

套件管理


套件管理用于统一管理企业可用的百度搭子套件。套件是面向垂直场景的能力包,通常由入口智能体、多个技能和可选的连接应用依赖组成。

点击左侧导航栏的 AI 能力管理 > 套件管理,进入套件管理页面。

image.png

页面支持搜索、筛选待推送套件,以及刷新套件列表。还可以按可见位置筛选,并按创建时间排序。点击套件名称可以查看套件详情。页签名称后显示当前套件数量。

页签 说明
企业创建 企业管理员通过上传套件压缩包创建的套件。
官方预置 由百度搭子官方统一维护和分发的套件。“官方预置”页签展示当前面向企业提供的官方套件。

创建企业套件

在企业创建页签中,点击页面右上方的创建套件。若当前暂无企业自建套件,也可以点击空状态中的安装套件进入创建弹窗。

创建套件包括文件上传与解析、套件信息配置两个阶段。

image.png

文件上传

  1. 在创建套件弹窗中,点击上传区域选择文件,或将套件文件拖拽到上传区域。
要求 说明
文件格式 仅支持 .zip 格式。
文件数量 仅支持单个文件。
文件大小 不超过 30 MB。
包内容 套件目录和配置文件需符合搭子套件开发指南的要求,系统会在解析阶段校验套件格式。
  1. 上传完成后点击解析。如需更换文件,请先移除当前文件,再重新选择。

image.png

  1. 解析成功后,进入创建套件配置弹窗。解析失败时,请根据页面提示检查套件压缩包并重试。
字段 要求
套件名称 必填,最多 100 个字符。系统默认使用套件包中的名称或上传文件名填充,输入框右侧显示当前字符数和上限。
套件描述 必填,最多 2,000 个字符。系统默认使用套件包中的描述填充,输入框下方显示当前字符数和上限。
图标 可选。仅支持 JPG、PNG、JPEG、SVG、GIF、ICO 格式,单个文件大小不超过 2 MB,建议尺寸为 72 × 72 px。未上传时使用默认图标;上传图标后可以恢复默认图标。

image.png

  1. 确认信息无误后点击确定创建套件。创建成功后,套件会出现在企业创建列表中。

image.png


查看套件详情

在列表中点击套件名称,打开套件详情弹窗。详情包括:

image.png

  • 套件图标、名称和描述。描述较长时,可以点击展开或收起。
  • 包含技能:以卡片形式展示套件内技能的名称和描述。
  • 点击技能卡片可以查看技能说明。系统展示 SKILL.md 的正文,不展示 YAML Front Matter。

如果套件不包含技能,详情区域显示暂无技能。内容加载失败时,可以点击重新加载。


配置可见位置

套件创建或同步到企业后,管理员可以在列表的可见位置列设置套件在企业客户端中的展示范围。

image.png

可见位置 说明
不可见 不在企业客户端中向成员展示。企业自建套件只有处于此位置时才支持删除。
套件广场 在企业客户端的能力扩展 > 套件中展示,成员可以按需浏览和使用。
企业内置 作为企业默认提供的套件提供给成员,在 能力扩展 > 我的 > 我的套件 中展示。

配置可见部门

管理员可为套件配置可见范围,控制哪些企业成员可以在百度搭子客户端引用该套件。

在套件列表的可见部门列,点击目标套件的编辑按钮。在编辑可见范围弹窗中选择按部门,勾选一个或多个部门(也可通过搜索部门查找),确认右侧已选择列表无误后点击确定保存配置。

image.png

配置成功后,点击推送变更,使配置同步到客户端,对应部门用户可在百度搭子客户端引用该套件。


批量操作

如需批量调整可见位置,可勾选一个或多个目标套件,点击批量操作,选择批量设为企业内置、批量上架套件广场或批量设为不可见。

image.png


批量推送变更

调整可见位置后,变更仅保存在管理平台中,套件会进入待推送状态。请点击操作列的推送变更,或使用页面右上方的批量推送变更或批量推送选中套件变更,将配置同步到百度搭子客户端。

image.png

注意:套件处于推送中时不可修改可见位置,请等待当前操作完成后再调整配置。


同步官方预置套件

在官方预置页签中,可以查看百度搭子官方提供的套件,配置官方套件在本企业中的可见位置,并处理官方发布的新增、更新或下架变更。

入口 说明
恢复默认配置 将官方套件的可见位置恢复为百度搭子官方默认配置。恢复后如产生待推送变更,仍需推送后才会在成员侧生效。
批量推送变更 将当前待推送的官方套件变更批量同步到百度搭子客户端。
同步官方更新 查看并处理官方发布的套件更新。按钮上的数量表示待处理的更新数量。

处理官方更新

  1. 在官方预置页签中,点击同步官方更新。
  2. 在右侧抽屉中查看官方更新记录。记录按处理状态分为待处理、已处理和自动同步。

image.png

页签 说明
待处理(n) 需要管理员决定是否采用的官方更新,可选择忽略或应用到本企业。
已处理 管理员已经手动应用或忽略的官方更新记录。
自动同步 开启自动同步后,由系统自动应用且不需要管理员介入的更新记录。
  1. 对待处理中的更新,按需选择:

    • 点击应用到本企业,将该更新应用到本企业的套件配置。如果套件进入待推送状态,还需在官方预置列表中点击推送变更,变更才会在客户端生效。
    • 点击忽略,本次更新不应用到当前企业。

常见变更类型包括:

类型 说明
新增 官方新增了可用套件,管理员可以决定是否应用到本企业。
更新 官方对套件内容、描述或配置进行了调整。
下架 官方下架或计划下线套件,管理员可以根据企业使用情况处理。

自动同步官方更新

在同步官方更新抽屉中,可以开启自动同步。开启后,百度搭子会将不需要管理员介入的官方更新自动应用到本企业;需要管理员决定是否采用的更新,仍会展示在待处理列表中。

image.png

自动同步只影响官方更新是否自动应用到本企业。若套件列表出现已变更,待推送或已下架,待推送状态,仍需执行推送变更后才会在客户端生效。


推送变更

当套件状态显示已变更,待推送或已下架,待推送,或者页面右上方的批量推送变更按钮显示待推送数量时,说明套件配置尚未同步到百度搭子客户端。

套件在推送过程中可能显示以下状态:

状态 说明
推送中 变更正在同步。请等待操作完成后再调整套件配置。
推送失败,请重试 本次推送未完成,可以重新发起推送。

image.png


推送单个变更

在目标套件的操作列点击推送变更。确认弹窗会列出套件名称和待推送内容,例如上架或下架套件广场、设为或取消企业内置、新增套件或套件更新。确认无误后点击推送。

image.png

批量推送变更

页面右上方的批量推送变更(n)按钮会显示当前待推送的套件数量。点击按钮右侧的下拉箭头,可按以下范围推送变更:

推送方式 说明
批量推送全部变更 推送当前页签中全部待推送的套件变更,无需提前勾选套件。
批量推送选中套件变更 仅推送已勾选套件中的待推送变更;未勾选套件或所选套件没有变更时不可用。

如需批量推送指定套件,请先勾选一个或多个套件,再选择批量推送选中套件变更。如需一次性处理当前页签中的全部待推送内容,选择批量推送全部变更。

image.png

推送完成后,套件的待推送状态会更新,成员侧的可见位置和已推送的套件配置才会生效。推送失败时,状态显示为推送失败,请重试,可以重新发起推送。

注意:

  • 推送变更可能影响企业成员在客户端看到的套件范围。对于下架、隐藏或改为企业内置等影响范围较大的变更,建议确认后再推送。
  • 成员侧浏览和使用套件的操作,请参见 能力扩展。