本文档由 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/与其后第一个/之间的那一段。
difyctl 切换到该工作空间。