跳转到主要内容

什么是 Knowledge?

就像让一位新工程师入职一样,让 Devin 上手也需要先在知识传递上进行投入。 Knowledge 是一组提示、建议和说明,Devin 可以在所有会话中参考这些内容。你可以随着时间推移不断向 Devin 的 Knowledge 库中添加内容,而 Devin 会在需要时自动调用相关的 Knowledge 使用 Knowledge 功能来分享文档、技巧、自定义内部库,以及 Devin 可能需要的其他资料。

如何创建 Knowledge?

前往 Settings & Library 页面中的 Knowledge 选项卡,然后点击右上角的 “Add Knowledge”。
Devin
Trigger Description 将帮助 Devin 在合适的时机调用相关的 Knowledge。它可以是一句简单的短语或句子。当 Devin 当前的工作与指定的触发条件相关时,就会检索对应的 Knowledge 条目;所有 Knowledge 都需要设置触发描述。 Content 应由几句话组成,包含相关的关键信息。

你可以为任何 Knowledge 条目指定一个——一个以 ! 开头的简短标识符(例如 !deploy-checklist)。宏让你可以在提示中输入宏名称,快速引用 Knowledge。宏只能包含字母、数字和连字符,并且在你的组织内必须唯一。

启用和禁用 Knowledge

每个 Knowledge 条目都可以按用户单独启用或禁用。禁用某个 Knowledge 条目后,Devin 将无法在你的会话中检索到它,但不会将其从组织中删除。当某个 Knowledge 条目暂时与你当前的工作无关,但可能对队友或未来有用时,这样做会很有帮助。

知识建议

Devin 会根据你在对话中的反馈自动建议需要记忆的知识。你可以在保存前编辑这些建议的知识,或者在不需要时将其丢弃。 你也可以根据自己的反馈请求 Devin 重新生成知识建议。这样可以更方便地对建议的知识进行迭代,而不必手动编辑。除了建议新的知识条目外,Devin 还可以为现有的知识条目提出更新建议。

知识库里应该包含什么?

我们建议将你在提示词或 playbook 中经常反复使用的内容加入知识库。例如:常见的 Bug 及其对应的解决方案、代码规范实践、部署流程、测试流程、如何使用自研/专有工具等。

使用文件夹组织 Knowledge

你可以将 Knowledge 条目整理到文件夹中,以便更轻松地管理。文件夹支持:
  • 嵌套层级 — 创建子文件夹,构建结构化的知识树。
  • 批量启用/禁用 — 一键启用或禁用整个文件夹。文件夹被禁用后,其中所有 Knowledge 条目都会在你的会话中被禁用。
  • 移动条目 — 在文件夹之间拖动 Knowledge 条目,或使用移动操作重新整理。
  • 自动整理 — 选择多个 Knowledge 条目,让 Devin 自动将它们归类到逻辑清晰的文件夹中。
当你的组织中有大量分属不同团队、项目或工作流的 Knowledge 条目时,文件夹会特别有帮助。

使用技巧

  1. 创建针对单一工作流或操作的具体 Knowledge。Devin 会读取整个 Knowledge 的内容,因此请确保其中所有内容都相关且保持最新!
    • 在可能的情况下,将 Knowledge 拆分成更小的单元。Devin 能够同时访问多个 Knowledge“条目”。
  2. 养成添加和更新 Knowledge 的习惯。这些内容会在你的组织内共享,并会随着时间推移持续提升 Devin 为你团队服务的效果。
  3. Devin 会在相关时检索 Knowledge,而不是一次性全部检索,或在一开始就全部检索。请确保你的检索触发条件与内容高度相关。
  4. 使用文件夹对相关的 knowledge 进行分组(例如按项目、团队或工作流),这样当你的关注重点发生变化时,就可以快速启用或禁用成组的 knowledge。

组织级和 Enterprise Knowledge

对于企业客户,Knowledge 页面会划分为多个独立的标签页,帮助你在不同层级范围内管理知识:
  • Organization Knowledge —— 作用域为你当前组织的 Knowledge 条目。组织内所有成员均可见,也是新建 Knowledge 条目的默认作用域。
  • Suggestions —— 基于你的会话交互由 AI 生成的知识建议(在非主组织中显示)。
  • Enterprise Knowledge —— 适用于你的 Enterprise 中所有组织的 Knowledge 条目。仅当你属于 Enterprise 账户时可见。Enterprise 管理员可以在此标签页创建和管理企业级 Knowledge。
主组织用户只会看到一个 Enterprise Knowledge 标签。拥有 Enterprise 账户的非主组织用户会看到全部三个标签,其中 Organization Knowledge 为默认标签。没有 Enterprise 账户的非主组织用户仅会看到 Organization Knowledge 和 Suggestions。
Enterprise Knowledge 条目特别适合用于共享公司范围内的编码规范、架构指南、部署流程,以及其他需要在所有团队和组织中统一适用的上下文信息。

将 Organization Knowledge 提升到 Enterprise

如果某个组织级条目足够有用,值得在整个 Enterprise 内共享,你可以直接在编辑器中将其提升。打开该条目,然后在“详情”选项卡中点击 Promote to Enterprise。该条目会从组织作用域移至 Enterprise 作用域,并对 Enterprise 中的所有组织可用。 执行提升操作需要具备 Enterprise 管理权限,并且仅适用于属于某个 Enterprise 的组织中由用户创建的条目。

将 Knowledge 固定到仓库

你可以选择让 Knowledge 适用于不固定仓库、某个特定仓库或所有仓库:
  • 固定到无仓库:只有当 Devin 判断它与当前上下文相关时,才会检索该 Knowledge。
  • 固定到某个特定仓库:只要 Devin 在该指定仓库中工作,就会始终使用该 Knowledge。
  • 固定到所有仓库:无论 Devin 在任何会话中处理哪个仓库,该 Knowledge 都会自动应用到每个仓库。