# MA 接入 Viking 知识库检索 skill 使用手册 ## 体验中心 > [方舟体验中心](https://console.volcengine.com/ark/region:cn-beijing/experience) 可在方舟体验中心的 Managed Agent 下体验接入 Viking 知识库的 4 个 Agent 模板： * 视频知识：接入内置的视频 Viking 知识库，检索视频资料并定位关键片段，提供知识点问答、片段检索、内容总结、拍摄技巧分析等能力。 * Deep Search：接入内置的行业报告、产品报告和技术报告 Viking 知识库，跨文档多轮检索并整合证据，形成有依据的结论。 * 售后客服：接入墨川数码的产品资料与售后政策 Viking 知识库，辅助故障排查、退换货和服务流程指引。 * 企业知识问答：接入星澜软件的企业制度与内部资料 Viking 知识库，解答人事、财务、行政和 IT 权限等常见问题。

![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/cf46b0a55dfc4d3a9ba02a5233e78000~tplv-goo7wpa0wc-topic.webp) ## 接入方法概述

提示

需要预先开通 Viking 知识库，开通入口：Viking 知识库

MA 中提供了内置的 Viking 知识库检索 Skill，同时提供了 4 个使用 Viking 知识库的 Agent 模板。在 MA 中可使用以下两种方式创建绑定 Viking 知识库的 Agent。注意，都需要做 Viking 知识库鉴权配置。 1. **MA\-Agents** 入口创建 Agent 时绑定 Viking 知识库检索skill `viking-knowldege-search` 2. **MA\-Quickstart** 入口使用 4 个接入 Viking 知识库的默认模板进行创建：视频知识、Deepsearch、售后客服、企业知识问答。 ## **MA\-Agents** 入口创建 Agent 绑定知识库检索skill > [火山方舟 - Create Agent](https://console.volcengine.com/ark/region:cn-beijing/managed-agents/agents/create) 1. 在 Managed Agents 平台的 Agents 页面创建 Agent 时选择预置的 Viking 知识库检索 skill `viking-knowldege-search` ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/7ace87c158b340acac8b416437fde863~tplv-goo7wpa0wc-topic.webp) 2. 在 Managed Agents 平台的 Credentials Vault 页面创建 Viking 知识库鉴权使用的凭证，具体鉴权配置方法可见[第 3 部分](https://bytedance.larkoffice.com/docx/Ks5SdqWFGoQ0a6xrtOjcYyvOnVd#share-QTRudxTyVoTGE2xURW2cCcR5nRe)。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/32a2f9c9b486406a8fc8dde4994f25ec~tplv-goo7wpa0wc-topic.webp) 3. 在 Managed Agents 平台的 Environments 页面创建默认环境 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/2b8db9250aa647d1a1453145594dda5e~tplv-goo7wpa0wc-topic.webp) 4. 在 Managed Agents 平台的 Sessions 页面创建绑定对应 Agent、对应 Credencial Vault、对应 Environment 的 Session，开始进行对话。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/0d5020856ff74dcf965fce8dc684f1a1~tplv-goo7wpa0wc-topic.webp) **开通知识库&创建Agent绑定知识库检索skill的视频录屏**：

## **MA\-Quickstart** 入口使用4个Viking知识库默认模板 > [火山方舟 - QuickStart](https://console.volcengine.com/ark/region:cn-beijing/managed-agents/quickstart) 1. 在 MA\-Quickstart 入口使用 4 个接入 Viking 知识库的默认模板：视频知识、Deepsearch、售后客服、企业知识问答进行快速创建。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/3db2b9a6e6da4e91a152720ffed53a94~tplv-goo7wpa0wc-topic.webp) 2. 创建过程中，需要创建 Viking 知识库鉴权使用的凭证，具体鉴权配置方法可见[第 3 部分](https://bytedance.larkoffice.com/docx/Ks5SdqWFGoQ0a6xrtOjcYyvOnVd#share-QTRudxTyVoTGE2xURW2cCcR5nRe)。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/1ca5bcb1cc944ed59120355c8eaacbc6~tplv-goo7wpa0wc-topic.webp) 3. 创建过程中，需要修改配置时，可直接在对话中描述。 **在 MA\-Quickstart 入口使用 Viking 知识库默认模板视频录屏**：

## Viking 知识库鉴权配置 Viking 知识库鉴权配置可选择 Viking API Key 或者火山 API Key 两种方式。 ### Viking API Key #### 在 Viking 知识库控制台创建 API Key > [账号登录-火山引擎](https://console.volcengine.com/vikingdb/knowledge/region:vdb-knowledge+cn-beijing/apiKey) 1. 创建 API Key 2. 绑定需要的知识库 3. 完成创建 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/6af61e7965bb4c6eb46476ab320c36f6~tplv-goo7wpa0wc-topic.webp) ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/d496fc5ac6e540e98ff0f295eb7fbe34~tplv-goo7wpa0wc-topic.webp) #### 在 Managed Agents 平台创建 Credentials Vault 凭证 > [火山方舟 - Credentials Vault](https://console.volcengine.com/ark/region:cn-beijing/managed-agents/credentials-vault?projectName=default) 1. 创建 Vault 2. 选择 credential 类型为 **ENV** 3. 填写变量名为 **`VIKING_API_KEY`**，value 值为第一步创建的 API Key 的值 4. 选择出网范围为受限，填写允许的域名为 **api\-knowledgebase.mlp.cn\-beijing.volces.com** ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/36aafb4bf192470ba918ea258710aa1d~tplv-goo7wpa0wc-topic.webp) #### 在 Managed Agents 平台创建 session 对话时选择对应的 credential 凭证 > [火山方舟 - Sessions](https://console.volcengine.com/ark/region:cn-beijing/managed-agents/sessions?projectName=default) ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/9f87c7ffa2cd47afb38dc6a08c8645d1~tplv-goo7wpa0wc-topic.webp) ### 火山 API Key #### 在火山访问控制页面给某个用户子账号创建 API Key > [账号登录-火山引擎](https://console.volcengine.com/iam/identitymanage/user) ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/1d02231d184844319ef7309a8830b65b~tplv-goo7wpa0wc-topic.webp) #### 在 Managed Agents 平台创建 Credentials Vault 凭证 > [火山方舟 - Credentials Vault](https://console.volcengine.com/ark/region:cn-beijing/managed-agents/credentials-vault?projectName=default) 1. 创建 Vault 2. 选择 credential 类型为 **ENV** 3. 填写变量名为 **`VOLC_API_KEY`**，value 值为第一步创建的 API Key 的值 4. 选择出网范围为受限，填写允许的域名为 **api\-knowledgebase.mlp.cn\-beijing.volces.com** ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/0f5a73e55a7c4edeb991b5045a3949ee~tplv-goo7wpa0wc-topic.webp) #### 在 Managed Agents 平台创建 session 对话时选择对应的 credential 凭证 > [火山方舟 - Sessions](https://console.volcengine.com/ark/region:cn-beijing/managed-agents/sessions?projectName=default) ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/f65df15e3c444676984336bf37ca25af~tplv-goo7wpa0wc-topic.webp)

向量数据库VikingDB