发布渠道 | LanSphere 使用手册

发布渠道

本篇介绍蓝域(LanSphere)应用的发布机制:应用从创建到上线的四态生命周期,网页链接、API 访问、蓝信 AI 助理三种系统预设发布渠道的配置方法,以及发布到应用广场、发布为组件和版本管理。适合需要将应用交付给终端用户或外部系统的开发人员与管理员阅读。

应用四态生命周期

应用从创建到对外服务经历四个状态:

  1. 创建:新建应用后尚未保存;
  2. 保存(草稿):保存后成为草稿,仅你本人可见;
  3. 发布:发布到应用广场、发布为组件或发布到蓝信,三个渠道相互独立;
  4. WebApp 上线:通过网页链接上线为 WebApp 线上应用,可与三个发布渠道共存。

各渠道相互独立意味着:你可以只发布到蓝信供终端用户使用,也可以同时通过网页链接与 API 访问对外开放,各渠道的发布与更新互不影响。

如何选择发布方式,可参考下表:

发布方式 适用场景
发布到应用广场 面向平台内全体成员(含阅览成员)开放使用
发布为组件 将工作流沉淀为可复用组件,供其他应用调用
网页链接(WebApp) 通过链接向指定范围用户提供独立访问页面
API 访问 将应用能力集成到自有系统或第三方系统
蓝信 AI 助理 面向蓝信终端用户提供对话式服务

「保存」按钮

在应用开发页面,「保存」按钮悬浮下拉固定提供三项:

选项 说明
保存 保存当前编辑内容为草稿
发布到应用广场 将最新内容发布到应用广场,平台内全员可见可用
发布为组件 仅工作流类型可见,将工作流发布为可复用组件

注意:草稿不可发布到应用广场,请先保存最新内容再发布。「发布为组件」与「发布到应用广场」互斥,同一应用只能选择其中一种方式。

发布渠道页签

应用详情页的「发布渠道」页签提供三个系统预设渠道:网页链接、API 访问、蓝信 AI 助理。

网页链接

将应用上线为 WebApp,通过链接对外提供服务。链接可见性分为三档,选择后即时生效:

可见性 说明
平台内部分成员(系统默认) 仅指定成员可用;发布者本人权限固定不可取消,可额外指定成员
平台内所有成员 平台内全部成员可用
所有人 无身份限制,获得链接即可使用

其他操作:

  • 去使用:在新标签页打开 WebApp;
  • 复制链接:将链接复制到剪贴板,便于分发。

API 访问

通过 API 将应用能力集成到你自有的系统中:

  • 复制 API 链接:复制应用的 API 访问链接;
  • 创建密钥:一键创建调用密钥。同一应用仅支持单密钥,密钥以掩码形式展示;
  • 复制 / 删除密钥:删除后密钥立即失效,可随时重新创建。

注意:API 密钥是调用应用的凭证,请妥善保管,不要泄露给无关人员。如怀疑泄露,请立即删除并重新创建。

蓝信 AI 助理

将应用发布为蓝信 AI 助理,终端用户在蓝信客户端即可直接使用。

提示:仅对话流、智能体类型支持发布到蓝信 AI 助理,工作流不支持。

发布流程

  1. 在「发布渠道」页签选择蓝信 AI 助理渠道,发起发布;
  2. 根据账号绑定状态,流程略有差异:
    • 已绑定蓝信:弹出确认弹窗,确认后直接发布;
    • 未绑定蓝信:弹窗引导跳转蓝信授权认证中心,扫码认证通过后自动执行发布;
  3. 助理标题默认继承应用名称(不超过 10 字),描述默认继承应用说明(不超过 20 字),可按需调整;
  4. 发布完成后,按钮变为「已发布」并置灰,不可重复发布。

发布后效果

  • 系统自动在蓝信侧创建应用与机器人实例,并上架蓝信客户端「AI 助理市场」;
  • 终端用户可在 AI 助理市场看到助理的头像、标题与描述,点击即可使用。

终端用户首次使用的数据授权

  • 终端用户首次使用助理时,系统推送数据授权卡片,同意授权后方可开始对话;
  • 若用户拒绝授权,则无法使用该助理;之后每次触发使用,系统都会重新推送授权卡片;
  • 授权按「用户-应用」单独绑定,不同用户、不同助理之间的授权互不影响。

发布后的更新:平台侧更新应用后,应用的基本信息会自动同步到蓝信侧。

删除:已发布到蓝信的应用支持删除,但仅删除平台侧数据,蓝信侧数据需另行处理。

发布到应用广场

通过「保存」按钮下拉选择「发布到应用广场」,保存最新内容后上架:

  • 上架后,平台内全员(含阅览成员)可见可用;
  • 草稿状态不可发布,请先保存;
  • 与「发布为组件」互斥,二者只能选择其一。

发布为组件

仅工作流类型支持「发布为组件」:

  1. 保存最新内容后,通过「保存」按钮下拉选择「发布为组件」;
  2. 按页面提示配置组件信息;
  3. 发布后,工作流成为组件,自动同步到「协作组件 → 工作流」标签页,供平台内其他应用调用。

注意:通过该入口发布的组件不会上架应用广场。

版本管理

版本管理记录应用每次已发布的版本,包括版本说明、发布人与发布时间。你可以回溯查看历史版本,掌握应用的发布过程与变更情况。