企业直播 Skills 封装了企业直播的核心能力，您可以通过自然语言对话的方式，轻松完成直播间管控、观看页集成等操作。本文介绍如何安装、配置并使用企业直播 Skills。

支持的 Skills #

byted-livesaas-master #

面向运营人员、直播管理者的直播间管控 Skill。该 Skill 可以调用企业直播服务端 OpenAPI，实现直播间的创建、配置等操作。常见场景有：

• 直播间搭建、配置与管控等全生命周期管理
• 直播数据分析
• 直播间观众管理，如禁言、踢出等
• 商品卡片等菜单的管理
• 互动工具配置
• 直播评论管理与分析

byted-livesaas-dev #

面向开发者的观看页集成 Skill。该 Skill 可结合开发业务场景，为您提供接入规划、示例代码生成、排障与代码扫描等能力，助您快速集成 Web、小程序等观播 SDK，显著提升开发效率。

前提条件 #

使用企业直播 Skills 之前，请确保：

• 您已开通尊享版套餐。详见计费说明。
• 您已拥有火山引擎子账号以用于调用 API。
• 子账号在企业直播控制台中，具有足够权限。例如，要使用子账号调用 ListActivityAPI 接口获取直播列表中所有直播间的基础信息，子账号必须具备我的直播 > 仅查看或可编辑权限。具体所需权限可在对应接口文档中查看。
• 您已安装 Node.js 和 npm。

安装与登录 #

方式一：通过命令安装 Skills 并登录 #

1. 安装 Skills：
   （推荐）直接安装所有 Skills

   通过 Skill CLI 安装 Skills

   1. 打开本地的命令行工具，运行以下命令：

      npx bytedlive-cli skills add
      

      2. 选择要安装技能的目标 Agents：
         1. 按 ↑ 或 ↓ 键，在各选项之间移动；
         2. 按 Space 键，选中或取消选中当前选项；
         3. 按 Enter 键，确认安装。
            
            安装成功后，命令行将输出已安装提示。之后 Agent 将根据用户输入自动调用对应的 Skill。
            

   1. 先全局安装企业直播 CLI 工具 bytedlive-cli，再安装 Skills：

      npm i -g bytedlive-cli
      bytedlive-cli skills add
      

      2. 选择要安装技能的目标 Agents：
         1. 按 ↑ 或 ↓ 键，在各选项之间移动；
         2. 按 Space 键，选中或取消选中当前选项；
         3. 按 Enter 键，确认安装。
            
            安装成功后，命令行将输出已安装提示。之后 Agent 将根据用户输入自动调用对应的 Skill。
            
2. 运行以下命令，验证是否成功安装：

   npx bytedlive-cli --version
   

   若成功安装，将返回当前安装的 bytedlive-cli 版本。您可前往 npm 包页面查看最新版本。如果您的本地环境中已安装了其他版本，请先运行以下命令卸载旧版本，然后返回步骤 1 重新安装 Skills：

   npm uninstall -g bytedlive-cli
   

3. 运行以下命令，使用浏览器 OAuth 登录火山引擎控制台。

   npx bytedlive-cli login --profile default --region cn-beijing
   

   若浏览器未自动打开，请点击返回的浏览器地址，然后登录。
   
   登录完成后，即可在 AI IDE 如 TRAE 中，与 agent 对话，完成直播间管控、观看端开发接入等操作。

方式二：通过豆包安装并登录 #

1. 登录豆包。
2. 在对话框中，将模式调整为办公任务模式。
   
3. 将以下信息发送至豆包：

   请帮我安装企业直播技能，我需要使用企业直播 Skill 和 CLI 来管理直播：
   https://www.npmjs.com/package/bytedlive-cli
   

4. 安装完成后，使用您的企业直播账号登录。推荐使用浏览器 OAuth 直接登录。您可将以下信息发送至豆包：

   使用浏览器 OAuth 登录：npx bytedlive-cli login --profile default --region cn-beijing
   

5. 豆包将打开或提供登录链接，您需在此页面登录火山引擎控制台。
   
   登录完成后，即可以与豆包继续对话的方式，完成直播间管控、观看端开发接入等操作。

方式三：下载压缩包安装 Skills #

1. 点击下载直播间管控和观看页集成 Skill 压缩包，并将其解压缩到本地目录。
   • 直播间管控 Skill：
     
     

     byted-livesaas-master-1.1.4.zip

     未知大小

     
   • 观看页集成 Skill：
     
     

     byted-livesaas-dev-1.3.3.zip

     未知大小

     
2. 参考您所使用的 AI IDE 的本地 Skill 导入说明，将解压后的 Skill 文件夹导入 IDE 并重启。
3. 导入完成后，即可在 AI IDE 如 TRAE 中，与 agent 对话，完成直播间管控、观看端开发接入等操作。如需使用 CLI 工具完成登录，请参考方式一或方式二。

使用建议 #

完成 Skills 配置后，您就可以直接与 AI Agent 交互，向其描述直播管理、开发接入或排查问题等任务。Skills 会帮助 AI Agent 选择合适的接入流程和执行规则，从而让操作更准确、开发更高效。为保障数据安全，请勿在与 AI Agent 的对话中输入密钥、密码等敏感凭证信息。

以下是一些对话建议：

• 在提示词中明确目标：
  • 如果您是直播运营，说明您要做什么操作（创建直播、配置互动、查看数据等）；
  • 如果您是开发集成者，请明确您的业务场景、目标功能和平台等；
  • 如果您在排查问题，尽量提供错误现象、复现场景、报错日志、错误码，便于 AI 更快缩小问题范围。
• 对于复杂开发任务，优先使用模型能力更强、功能支持更完整的 AI IDE，以获得更稳定的代码生成和问题分析效果。

交互示例 #

管理直播间 #

筛选直播间

用户输入提示词：

查看正在直播的直播间

AI 将自动调用直播间管控 Skill，返回符合该状态的直播间（下图为在豆包客户端中的使用示例）：

创建直播间

用户输入提示词：

帮我创建一个明天下午3点开始的直播间，名字叫"企业直播新功能发布"。

AI 将自动调用直播间管控 Skill，为您创建直播间（下图为在 TRAE IDE 中的使用示例）：

直播数据分析

用户输入提示词：

分析这个直播间的直播数据，并提供数据洞察和建议：https://console.volcengine.com/livesaas/liveManagement/1864890****8903/

AI 将自动调用直播间管控 Skill，为您生成直播间的数据分析报告，并提供洞察和建议（下图为在 TRAE IDE 中的使用示例）：

集成观看页 #

生成 Web 观播 SDK 集成代码

用户输入提示词：

帮我生成接入 Web 观播 SDK 完整的页面代码模板，鉴权模式使用 mode 1

AI 输出（下图为在 TRAE IDE 中的使用示例）：

• AI 向用户确认关键信息：
  
• AI 调用集成 Skill 输出代码示例模板和说明：
  

生成在微信小程序中直播的实现方案

用户输入提示词：

如果要实现在微信小程序中打开直播，技术上该怎么实现？

AI 输出（下图为在 TRAE IDE 中的使用示例）：

答疑与排障 #

• 用户描述问题现状：

  企业直播的Web观播SDK（移动端）功能相关问题。我使用https://shop.xxx.cn这个域名嵌入的sdk正常播放，换域名后报跨域。
  

  AI 输出问题诊断（下图为在 TRAE IDE 中的使用示例）：
  
• 用户输入：

  web_sdk被踢出观众，无法再次进入
  

  AI 输出解决方案（下图为在 TRAE IDE 中的使用示例）：
  
• 用户输入提示词：

  在商品跳转链接中我们配置了H5页面，通过直播页浮层展示内容，配置的页面中涉及跟原生的交互，我看没拉起，弹窗中是不是不支持跟原生的交互？
  

  AI 输出（下图为在 TRAE IDE 中的使用示例）：