文档中心

AgentKit

管理知识库

使用 API Key 鉴权访问 Viking 知识库

使用 API Key 鉴权访问 Viking 知识库

本文介绍如何为 Viking 知识库启用 API Key，并将其配置到智能体运行时的环境变量中，使 Agent 通过 API Key 完成鉴权并调用知识库。启用 API Key 不影响 AK/SK 鉴权方式。

鉴权方式说明

支持 API Key 和 AK/SK 两种鉴权方式，二选一即可。

注意

若同时配置了 AK/SK 和 API Key，系统将优先使用 API Key 进行鉴权。

鉴权方式	适用场景	说明
API Key	需要细粒度访问控制的场景	权限粒度更细，可一对一绑定到具体知识库，适合按最小权限原则精确控制访问范围。
AK/SK	需要统一管理多资源访问的场景	权限范围更大，通过 IAM 策略统一管控，适合需要跨资源、跨服务调用的场景。

前提条件

已将目标 Viking 知识库导入 AgentKit，且知识库状态为成功。

启用 API Key

登录 AgentKit 控制台。

在左侧导航树中，选择“知识库”。

单击目标知识库名称，进入知识库详情页面。

在基本信息页签的访问控制区域，单击“启用 API Key”按钮。

等待系统生成当前知识库的专属 API Key。

在智能体运行时中配置 API Key

启用知识库的 API Key 后，若您需要通过该方式进行鉴权和调用知识库，则需要将该凭证配置到智能体运行时的环境变量中。

Agent 已集成过知识库

进入智能体运行时详情页，在基本信息的环境变量区域新增或更新 DATABASE_VIKING_API_KEY，并将变量值设置为知识库的 API Key。详细操作请参见更新环境变量。

Agent 未集成过知识库

在 Agent 中集成目标知识库。

将 Agent 部署至智能体运行时。

最近更新时间：2026.09.18 17:49:29

这个页面对您有帮助吗？

有用

有用

无用

无用