Viking AI 搜索
Viking AI 搜索
文档指南
请输入
- 文档首页
Viking AI 搜索AI搜索引擎用户手册用户指南配置并发布使用 AI 搜索 Skill
复制全文
下载 pdf配置并发布使用 AI 搜索 Skill
文档反馈
问问助手
说明
Viking AI 搜索 是火山引擎推出的一站式 AI 搜索/推荐/问答 SaaS 服务。本文介绍如何将已配置好的对话搜索、推荐等服务发布为 Agent Skill，使终端用户可以通过 AI Agent（如 OpenClaw、Trae 等）使用您的搜索和推荐服务
功能概述
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 配置页面
- 登录 Viking AI 搜索控制台。
- 在左侧导航栏选择目标应用，进入 体验配置 页面。
- 在页面右上角中找到 Agent Skill 区域，点击 【发布 Skill】 按钮。
点击后将弹出 Skill 配置抽屉。
配置抽屉顶部有两个 Tab：搜索 & 问答 和 推荐，分别对应两类 Skill 能力。您可以根据需要选择其中一类 Skill 或同时配置和下载两种 Skill 。
步骤二：配置 Skill
配置「搜索 & 问答」
- 选择在 Skill 中生效的策略
点击「搜索」下拉框，从列表中选择一个搜索策略（Search Scene）。
- 下拉列表展示当前应用下已创建的所有搜索场景
- 选中的场景会将其完整的搜索策略配置（召回方式、排序规则、截断策略等）应用于 Skill 的搜索服务
- 默认选中该应用当前的默认搜索策略
- 选择在 Skill 中生效的数据集
点击「数据集」下拉框，选择 Skill 关联的物品数据集。
- 该数据集中的物品将作为搜索和问答的候选内容池
- 下拉列表展示当前应用下已绑定的所有物品数据集
- 配置物品详情页的跳转链接（可选）
在「物品详情页」输入框中填写商品或内容的跳转链接模板。配置后，终端用户在 Agent 中看到的搜索结果将附带可点击的跳转链接。
- 点击输入框右侧的 【+{{动态参数}}】 按钮，可从数据集字段中选择变量插入 URL
- 例如填写 https://www.example.com/product/{{item_id}}，系统会在展示搜索结果时将 {{item_id}} 替换为每条结果的实际物品 ID
- 支持拼接多个动态参数，如 https://www.example.com/{{category}}/{{item_id}}
- 选择使用的 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 环境变量。
- 生成并下载 Skill 包
完成上述配置后，点击抽屉底部【生成 Skill 包】 按钮。
系统会自动校验配置完整性（必填项是否已选择、API Key 是否已关联等），校验通过后生成 Skill 压缩包并下载到本地。
下载完成后，将 ZIP 包发送给 AI Agent 或 Vibe Coding 工具（如 OpenClaw、Trae、Claude Code 等）即可安装使用。
配置「推荐」
点击 【推荐】 Tab 切换到推荐配置页面，依次完成以下配置：
- 选择在 Skill 中生效的策略
点击「推荐」下拉框，从列表中选择一个推荐策略（Recommend Scene）。
- 下拉列表展示当前应用下已创建的所有推荐策略
- 选中的场景会将其完整的推荐策略配置应用于 Skill 的推荐服务
- 默认选中该应用当前的默认推荐策略
- 配置物品详情页的跳转链接（可选）
在「物品详情页」输入框中填写商品或内容的跳转链接模板。配置后，终端用户在 Agent 中看到的推荐结果将附带可点击的跳转链接。
- 点击输入框右侧的 【+{{动态参数}}】 按钮，可从数据集字段中选择变量插入 URL
- 例如填写 https://www.example.com/product/{{item_id}}，系统会在展示推荐结果时将 {{item_id}} 替换为每条结果的实际物品 ID
- 支持拼接多个动态参数，如 https://www.example.com/{{category}}/{{item_id}}
- 选择使用的 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 环境变量。
- 生成并下载 Skill 包
完成上述配置后，点击抽屉底部【生成 Skill 包】 按钮。
系统会自动校验配置完整性（必填项是否已选择、API Key 是否已关联等），校验通过后生成 Skill 压缩包并下载到本地。
下载完成后，将 ZIP 包发送给 AI Agent 或 Vibe Coding 工具（如 OpenClaw、Trae、Claude Code 等）即可安装使用。
最近更新时间：2026.08.09 18:18:19
这个页面对您有帮助吗？
有用
有用
无用
无用