什么是 Knowledge？
就像让一位新工程师入职一样，让 Devin 上手也需要先在知识传递上进行投入。 Knowledge 是一组提示、建议和说明，Devin 可以在所有会话中参考这些内容。你可以随着时间推移不断向 Devin 的 Knowledge 库中添加内容，而 Devin 会在需要时自动调用相关的 Knowledge。 使用 Knowledge 功能来分享文档、技巧、自定义内部库，以及 Devin 可能需要的其他资料。如何创建 Knowledge？
前往 Settings → Resources → Knowledge，然后点击右上角的 Create knowledge。 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。Devin 会读取整个 Knowledge 的内容，因此请确保其中所有内容都相关且保持最新！
- 在可能的情况下，将 Knowledge 拆分成更小的单元。Devin 能够同时访问多个 Knowledge“条目”。
- 养成添加和更新 Knowledge 的习惯。这些内容会在你的组织内共享，并会随着时间推移持续提升 Devin 为你团队服务的效果。
- Devin 会在相关时检索 Knowledge，而不是一次性全部检索，或在一开始就全部检索。请确保你的检索触发条件与内容高度相关。
- 使用文件夹对相关的 knowledge 进行分组 (例如按项目、团队或工作流) ，这样当你的关注重点发生变化时，就可以快速启用或禁用成组的 knowledge。
组织与企业 Knowledge
Knowledge 的作用域可以是单个组织，也可以是整个企业。Knowledge 页面显示的内容取决于你当前所在的组织：- 非主组织 — Knowledge 页面有两个选项卡：
- Organization (默认) — 作用域为当前组织的 knowledge 条目。这些条目对组织内所有成员可见，也是新建 knowledge 条目的默认作用域。
- Suggestions — 根据你的会话交互由 AI 生成的 knowledge 建议。
- 主组织 — Knowledge 页面仅显示企业 knowledge 视图，不含选项卡。企业 knowledge 对企业下的所有组织生效，企业管理员在此创建和管理这些内容。
非主组织没有 Enterprise 选项卡。如果你的组织隶属于某个企业，可通过 Knowledge 页面上的 Looking for enterprise knowledge? 链接，在企业的主组织中打开企业 knowledge。
将 Organization Knowledge 提升到 Enterprise
如果某个组织级条目足够有用，值得在整个 Enterprise 内共享，你可以直接在编辑器中将其提升。打开该条目，然后在“详情”选项卡中点击 Promote to Enterprise。该条目会从组织作用域移至 Enterprise 作用域，并对 Enterprise 中的所有组织可用。 执行提升操作需要具备 Enterprise 管理权限，并且仅适用于属于某个 Enterprise 的组织中由用户创建的条目。将 Knowledge 固定到仓库
你可以选择让 Knowledge 适用于不固定仓库、某个特定仓库或所有仓库：- 固定到无仓库：只有当 Devin 判断它与当前上下文相关时，才会检索该 Knowledge。
- 固定到某个特定仓库：只要 Devin 在该指定仓库中工作，就会始终使用该 Knowledge。
- 固定到所有仓库：无论 Devin 在任何会话中处理哪个仓库，该 Knowledge 都会自动应用到每个仓库。
Knowledge 迁移至技能常见问题
Knowledge 笔记即将停用，由技能取而代之。技能是为 Devin 提供可复用指示的标准方式。Devin 正在自动将你的笔记迁移为技能。切换当天，你的团队不会受到任何影响，你也无需进行任何操作。Knowledge 笔记如何映射为技能
例如，以下笔记：
会转换为以下技能：
SKILL.md
常见问题
Devin 的行为会有变化吗？
Devin 的行为会有变化吗？
不会。迁移后的技能会根据其描述加载，就像以前的笔记根据触发条件加载一样。
在哪里可以找到迁移后的技能？
在哪里可以找到迁移后的技能？
在 Devin 应用的 Customize → Plugins → Knowledge 下，按你原有的文件夹分组显示。
技能存储在哪里？
技能存储在哪里？
与你的笔记一样，存储在 Devin 中。与以
SKILL.md 文件形式提交到代码仓库的技能不同，迁移后的技能存放在由 Devin 管理的 plugin 中，而不在你的代码仓库里。不会有任何内容提交到你的代码仓库，你也无需添加或维护任何文件。如何编辑迁移后的技能？
如何编辑迁移后的技能？
前往 Customize → Skills，打开相应技能即可编辑。组织技能可由组织管理员及拥有 Manage Knowledge 权限的成员编辑；企业技能则由企业管理员编辑。
今后应如何添加指导内容？
今后应如何添加指导内容？
编写技能即可。技能适用于 Devin 运行的所有环境：Web 应用、CLI 和 Devin Desktop。
面向 API 用户
哪些 API 端点会受到影响？
哪些 API 端点会受到影响？
受影响的是 Knowledge 笔记 端点
/v3/organizations/{org_id}/knowledge/notes[/{note_id}] 和 /v3/enterprise/knowledge/notes[/{note_id}]，以及对应的 /knowledge/folders 端点。用什么替代它们？
用什么替代它们？
对于 笔记，请改用技能端点 (v3 beta) ，它们位于
/v3beta1/organizations/{org_id}/managed-plugins 和 /v3beta1/enterprise/managed-plugins 下：与其他 v3 端点一样，列表端点通过
first 和 after 进行分页。如何通过 API 访问已迁移的 note？
如何通过 API 访问已迁移的 note？
已迁移的 笔记 以各自的 slug 存放在
knowledge bundle 中。你可以使用 GET .../managed-plugins/bundles/knowledge/skills 列出全部 笔记，或使用 GET .../managed-plugins/bundles/knowledge/skills/deploying-to-staging 获取单个 笔记。