本文档由 AI 自动翻译。如有任何不准确之处，请参考 英文原版。
一个 Agent 知识库 可同时供多个应用使用。需要基于它作答的工作流、Agent 或程序都可以接入；你本机上的编码 Agent 也能通过 Dify CLI 读取其中的文档。
聊天助手、旧版 Agent 和文本生成应用无法检索 Agent 知识库。如需让应用基于 Agent 知识库作答，可改用 Chatflow 应用或 Agent 重新搭建。
在 Workflow 和 Chatflow 应用中使用#
添加一个 Agent 知识检索 节点，再选择它要检索的知识库。你没有查看权限的知识库不会出现在选择列表中。
如需只检索部分文档，可在节点中 按元数据过滤。
如需禁止所有工作流检索该知识库（包括测试运行），在知识库的 设置 中关闭 工作流访问。已在使用它的工作流会在该节点处运行失败，直到你重新开启。
在新 Agent 中使用#
在 Agent 的 配置 编辑器中，把知识库添加到 Agent 知识库 下。
Agent 会根据知识库的名称和描述，自行判断何时检索，并且始终使用「快速」检索深度。
如需禁止已发布的 Agent 检索该知识库，在知识库的 设置 中关闭 API 访问。使用它的 Agent 仍会照常运行，只是无法再检索它。这个开关同时控制服务 API，关闭后服务 API 也无法访问。
在自己的代码中调用#
通过 服务 API，你的代码可向知识库提问，在后台运行耗时更长的「研究」检索，还能维护其中的文档。
如需阻止 API 调用方访问，在知识库的 设置 中关闭 API 访问。Agent 也会随之失去访问权限。
供编码 Agent 读取 #
你本机上的编码 Agent（例如 Claude Code 或 Codex）可在工作时把知识库当作参考资料。借助 Dify CLI，它能像翻看文件夹里的文件一样浏览文档、阅读内容，并按原词精确搜索。
它无法修改知识库中的任何内容。如需像应用那样按语义检索，可使用 服务 API。
按 CLI 文档中的 快速开始 完成配置：安装 difyctl，用你的 Dify 账号登录，再用 difyctl Skill 配置你的编码 Agent。
之后直接告诉编码 Agent 你要做什么，并附上两项信息：
difyctl knowledge_fs，即要使用的命令。difyctlSkill 并未涵盖这组命令。- 知识库的 ID。在 Dify 中打开该知识库，从浏览器地址栏复制：它是
/datasets/new/与其后第一个/之间的那一段。
例如：
只要你在 Dify 中能查看某个 Agent 知识库，编码 Agent 就能打开它。
编码 Agent 只会在你登录时 Dify 中打开的那个工作空间里查找。如果知识库在其他工作空间，先 将 difyctl 切换到该工作空间。
应用上线之后#
同步或重新上传文档后，新版本一完成索引，你的应用、Agent、API 调用方和外部编码 Agent 就会读到它。
在 概览 页面留意已停止同步的数据源，以及没有检索到任何内容的问题。各自的处理方法详见 维护 Agent 知识库。