本文介绍如何为 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](https://docs.volcengine.com/docs/86681/1865671)，且知识库状态为**成功**。 ## 启用 API Key 1. 登录 [AgentKit 控制台](https://console.volcengine.com/agentkit)。 2. 在左侧导航树中，选择“知识库”。 3. 单击目标知识库名称，进入知识库详情页面。 4. 在**基本信息**页签的**访问控制**区域，单击“启用 API Key”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_db8cf089002ca777df629db42fc3f15f.png) 5. 等待系统生成当前知识库的专属 API Key。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_644737517104fb99ca4c06c6388661ed.png) ## 在智能体运行时中配置 API Key 启用知识库的 API Key 后，若您需要通过该方式进行鉴权和调用知识库，则需要将该凭证配置到智能体运行时的环境变量中。 ### Agent 已集成过知识库进入智能体运行时详情页，在**基本信息**的**环境变量**区域新增或更新 **`DATABASE_VIKING_API_KEY`**，并将变量值设置为知识库的 API Key。详细操作请参见[更新环境变量](https://docs.volcengine.com/docs/86681/2204801)。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_cece52933edb8ccc52924fc6d7bca3a7.png) ### Agent 未集成过知识库 1. [在 Agent 中集成目标知识库](https://docs.volcengine.com/docs/86681/1883770)。 2. 将 [Agent 部署至智能体运行时](https://docs.volcengine.com/docs/86681/2227881?lang=zh#cDugp6nD)。