Agent Skill 是一种标准化的 AI 能力封装格式，将您在 Viking AI 搜索平台上配置好的搜索、问答和推荐服务打包为可分发、可安装的 Skill 包。
发布 Skill 后，可以引导您的终端用户进行安装，这样终端用户就可通过个人的 AI 工具直接对话搜索和推荐您的物品，实现随时、随地皆可问，用户触达再无门槛。
核心价值：

• B 端价值：无需开发，通过控制台可视化配置即可一键发布 Skill，拓宽 C 端消费者触达渠道。Skill 封装的是 API 服务，没有调用不会产生额外成本。
• C 端价值：安装 Skill 后，可通过 ArkClaw、OpenClaw、Trae 等各类 AI Agent 产品，直接搜索商品、获取个性化推荐。

在发布 Skill 之前，请确保已完成以下准备工作：

• 已创建应用：在 Viking AI 搜索控制台中创建了至少一个应用。如尚未创建，请参考创建应用。
• 已导入数据：应用已绑定物品数据集、行为数据集。如尚未导入和关联数据，请参考创建物品数据集 - 图文数据、创建用户行为数据集
• 已创建 API Key：在 Viking AI 搜索控制台中创建了至少一个 API Key。如尚未创建，请参考管理API Key

步骤一：进入 Skill 配置页面 #

1. 登录 Viking AI 搜索控制台。
2. 在左侧导航栏选择目标应用，进入 体验配置 页面。
3. 在页面右上角中找到 Agent Skill 区域，点击 【发布 Skill】 按钮。

点击后将弹出 Skill 配置抽屉。
配置抽屉顶部有两个 Tab：搜索 & 问答 和 推荐，分别对应两类 Skill 能力。您可以根据需要选择其中一类 Skill 或同时配置和下载两种 Skill 。

步骤二：配置 Skill #

配置「搜索 & 问答」 #

1. 选择在 Skill 中生效的策略

点击「搜索」下拉框，从列表中选择一个搜索策略（Search Scene）。

• 下拉列表展示当前应用下已创建的所有搜索场景
• 选中的场景会将其完整的搜索策略配置（召回方式、排序规则、截断策略等）应用于 Skill 的搜索服务
• 默认选中该应用当前的默认搜索策略

2. 选择在 Skill 中生效的数据集

点击「数据集」下拉框，选择 Skill 关联的物品数据集。

• 该数据集中的物品将作为搜索和问答的候选内容池
• 下拉列表展示当前应用下已绑定的所有物品数据集

3. 配置物品详情页的跳转链接（可选）

在「物品详情页」输入框中填写商品或内容的跳转链接模板。配置后，终端用户在 Agent 中看到的搜索结果将附带可点击的跳转链接。

• 点击输入框右侧的 【+{{动态参数}}】 按钮，可从数据集字段中选择变量插入 URL
• 例如填写 https://www.example.com/product/{{item_id}}，系统会在展示搜索结果时将 {{item_id}} 替换为每条结果的实际物品 ID
• 支持拼接多个动态参数，如 https://www.example.com/{{category}}/{{item_id}}

4. 选择使用的 API Key，该 Key 将自动配置到 Skill 中（可选）

• 在 API Key 列表中找到要使用的 Key，点击该行右侧的 【选择使用】。
  • 列表展示当前应用下已创建的所有 API Key，包含名称、Key 值（脱敏显示）和创建时间
  • 被选中的 Key 将显示为选中状态
  • 选中的 API Key 将自动写入 Skill 包，终端用户安装 Skill 后即可直接使用，无需再单独配置鉴权
• 如尚未创建 API Key，点击列表下方的 【创建 API Key】 新建一个。
• 如不希望直接在 Skill 安装包中直接写入 API Key ，可以跳过该步骤，在 Skill 安装使用时再配置 API Key 环境变量。

5. 生成并下载 Skill 包

完成上述配置后，点击抽屉底部**【生成 Skill 包】** 按钮。
系统会自动校验配置完整性（必填项是否已选择、API Key 是否已关联等），校验通过后生成 Skill 压缩包并下载到本地。
下载完成后，将 ZIP 包发送给 AI Agent 或 Vibe Coding 工具（如 OpenClaw、Trae、Claude Code 等）即可安装使用。

配置「推荐」 #

点击 【推荐】 Tab 切换到推荐配置页面，依次完成以下配置：

1. 选择在 Skill 中生效的策略

点击「推荐」下拉框，从列表中选择一个推荐策略（Recommend Scene）。

• 下拉列表展示当前应用下已创建的所有推荐策略
• 选中的场景会将其完整的推荐策略配置应用于 Skill 的推荐服务
• 默认选中该应用当前的默认推荐策略

2. 配置物品详情页的跳转链接（可选）

在「物品详情页」输入框中填写商品或内容的跳转链接模板。配置后，终端用户在 Agent 中看到的推荐结果将附带可点击的跳转链接。

• 点击输入框右侧的 【+{{动态参数}}】 按钮，可从数据集字段中选择变量插入 URL
• 例如填写 https://www.example.com/product/{{item_id}}，系统会在展示推荐结果时将 {{item_id}} 替换为每条结果的实际物品 ID
• 支持拼接多个动态参数，如 https://www.example.com/{{category}}/{{item_id}}

3. 选择使用的 API Key，该 Key 将自动配置到 Skill 中（可选）

• 在 API Key 列表中找到要使用的 Key，点击该行右侧的 【选择使用】。
  • 列表展示当前应用下已创建的所有 API Key，包含名称、Key 值（脱敏显示）和创建时间
  • 被选中的 Key 将显示为选中状态
  • 选中的 API Key 将自动写入 Skill 包，终端用户安装 Skill 后即可直接使用，无需再单独配置鉴权
• 如尚未创建 API Key，点击列表下方的 【创建 API Key】 新建一个。
• 如不希望直接在 Skill 安装包中直接写入 API Key ，可以跳过该步骤，在 Skill 安装使用时再配置 API Key 环境变量。

4. 生成并下载 Skill 包

完成上述配置后，点击抽屉底部**【生成 Skill 包】** 按钮。
系统会自动校验配置完整性（必填项是否已选择、API Key 是否已关联等），校验通过后生成 Skill 压缩包并下载到本地。
下载完成后，将 ZIP 包发送给 AI Agent 或 Vibe Coding 工具（如 OpenClaw、Trae、Claude Code 等）即可安装使用。