Skip to main content
本文档由 AI 自动翻译。如有任何不准确之处,请参考 英文原版。
两种知识库各有自己的 API,但使用同样的 API 密钥:

创建 API 密钥

只有工作空间所有者和管理员可以创建、查看和删除密钥。
在 知识库 页面右上角点击 服务 API,再点击 API 密钥。每个工作空间最多可有 10 个密钥。 同一面板中还显示服务 API 端点,即这两种 API 的基础 URL。

选择访问范围

创建密钥时,可以让它访问所有知识库,也可以只访问你选定的知识库,两种知识库都能选。只选择集成实际要用到的知识库。 如果集成还要调用不指定知识库的操作,例如获取经典知识库列表或创建经典知识库、管理标签,或 获取可用模型,则改为让密钥访问所有知识库。 访问范围创建后无法修改。如需更改,替换密钥。

替换密钥

要更改密钥的访问范围或轮换密钥,先创建新密钥,把集成切换过去,再删除旧密钥。密钥删除后立即失效。 在 Agent 知识库中,研究任务和删除作业只能用发起它们的密钥读取。删除旧密钥前,先等它们完成,并读取结果。

密钥被拒绝时

在经典知识库中,403 forbidden 可能对应上表中的多种原因,需查看错误的 message 加以区分。 限定于某个经典知识库的密钥,不能访问由它升级而来的 Agent 知识库。要访问这个 Agent 知识库,替换密钥,换成访问范围包含它的密钥。 如果某个 Agent 知识库 ID 在密钥所属的工作空间中不存在,会返回 401 knowledge_fs_invalid_credential,与密钥无效时相同。替换密钥前,先检查 ID 是否正确。
Last modified on October 28, 2026