> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 知识

> 共享重要的背景信息和知识，帮助 Devin 快速上手

<div id="what-is-knowledge">
  ## 什么是 Knowledge？
</div>

就像让一位新工程师入职一样，让 Devin 上手也需要先在**知识传递**上进行投入。

Knowledge 是一组提示、建议和说明，Devin 可以在所有会话中参考这些内容。你可以随着时间推移不断向 Devin 的 Knowledge 库中添加内容，而 Devin 会在需要时**自动调用相关的 Knowledge**。

<video controls className="w-full aspect-video" src="https://mintcdn.com/cognitionai/ifLkKLaMB-vvINwf/images/feature-add-knowledge.mp4?fit=max&auto=format&n=ifLkKLaMB-vvINwf&q=85&s=a0d91cc2095f798e31fb3e182812f63d" data-path="images/feature-add-knowledge.mp4" />

使用 Knowledge 功能来分享文档、技巧、自定义内部库，以及 Devin 可能需要的其他资料。

<div id="how-do-i-create-knowledge">
  ## 如何创建 Knowledge？
</div>

前往 **Settings & Library** 页面中的 **Knowledge** 选项卡，然后点击右上角的 “Create knowledge”。

<Frame>
  <img src="https://mintcdn.com/cognitionai/s_eAbNGhbOgn5ZqZ/images/knowledge_settings.png?fit=max&auto=format&n=s_eAbNGhbOgn5ZqZ&q=85&s=525ecdc36c84554bdb4fe14e06659e71" alt="Devin" width="2954" height="902" data-path="images/knowledge_settings.png" />
</Frame>

**Trigger Description** 将帮助 Devin 在合适的时机调用相关的 Knowledge。它可以是一句简单的短语或句子。当 Devin 当前的工作与指定的触发条件相关时，就会检索对应的 Knowledge 条目；所有 Knowledge 都需要设置触发描述。

**Content** 应由几句话组成，包含相关的关键信息。

<div id="macros">
  ### 宏
</div>

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

<div id="enabling-and-disabling-knowledge">
  ### 启用和禁用 Knowledge
</div>

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

<div id="knowledge-suggestions">
  ## 知识建议
</div>

Devin 会根据你在对话中的反馈自动建议需要记忆的知识。你可以在保存前编辑这些建议的知识，或者在不需要时将其丢弃。

<video controls className="w-full aspect-video" src="https://mintcdn.com/cognitionai/ifLkKLaMB-vvINwf/images/feature-knowledge-suggestions.mp4?fit=max&auto=format&n=ifLkKLaMB-vvINwf&q=85&s=a09d259bd828f60086f982d8f0ddf5a4" data-path="images/feature-knowledge-suggestions.mp4" />

你也可以根据自己的反馈请求 Devin 重新生成知识建议。这样可以更方便地对建议的知识进行迭代，而不必手动编辑。除了建议新的知识条目外，Devin 还可以为现有的知识条目提出更新建议。

<div id="what-belongs-in-knowledge">
  ## 知识库里应该包含什么？
</div>

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

<div id="organizing-knowledge-with-folders">
  ## 使用文件夹组织 Knowledge
</div>

你可以将 Knowledge 条目整理到**文件夹**中，以便更轻松地管理。文件夹支持：

* **嵌套层级** — 创建子文件夹，构建结构化的知识树。
* **批量启用/禁用** — 一键启用或禁用整个文件夹。文件夹被禁用后，其中所有 Knowledge 条目都会在你的会话中被禁用。
* **移动条目** — 在文件夹之间拖动 Knowledge 条目，或使用移动操作重新整理。
* **自动整理** — 选择多个 Knowledge 条目，让 Devin 自动将它们归类到逻辑清晰的文件夹中。

当你的组织中有大量分属不同团队、项目或工作流的 Knowledge 条目时，文件夹会特别有帮助。

<div id="tips-and-tricks">
  ## 使用技巧
</div>

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

<div id="organization-and-enterprise-knowledge">
  ## 组织级和 Enterprise Knowledge
</div>

对于企业客户，Knowledge 页面会划分为多个独立的标签页，帮助你在不同层级范围内管理知识：

* **Organization Knowledge** —— 作用域为你当前组织的 Knowledge 条目。组织内所有成员均可见，也是新建 Knowledge 条目的默认作用域。
* **Suggestions** —— 基于你的会话交互由 AI 生成的知识建议（在非主组织中显示）。
* **Enterprise Knowledge** —— 适用于你的 Enterprise 中所有组织的 Knowledge 条目。仅当你属于 Enterprise 账户时可见。Enterprise 管理员可以在此标签页创建和管理企业级 Knowledge。

<Note>
  主组织用户只会看到一个 **Enterprise Knowledge** 标签。拥有 Enterprise 账户的非主组织用户会看到全部三个标签，其中 Organization Knowledge 为默认标签。没有 Enterprise 账户的非主组织用户仅会看到 Organization Knowledge 和 Suggestions。
</Note>

Enterprise Knowledge 条目特别适合用于共享公司范围内的编码规范、架构指南、部署流程，以及其他需要在所有团队和组织中统一适用的上下文信息。

<div id="promoting-organization-knowledge-to-enterprise">
  ### 将 Organization Knowledge 提升到 Enterprise
</div>

如果某个组织级条目足够有用，值得在整个 Enterprise 内共享，你可以直接在编辑器中将其提升。打开该条目，然后在“详情”选项卡中点击 **Promote to Enterprise**。该条目会从组织作用域移至 Enterprise 作用域，并对 Enterprise 中的所有组织可用。

执行提升操作需要具备 Enterprise 管理权限，并且仅适用于属于某个 Enterprise 的组织中由用户创建的条目。

<div id="pinning-knowledge-to-repos">
  ## 将 Knowledge 固定到仓库
</div>

你可以选择让 Knowledge 适用于不固定仓库、某个特定仓库或所有仓库：

* 固定到**无仓库**：只有当 Devin 判断它与当前上下文相关时，才会检索该 Knowledge。
* 固定到**某个特定仓库**：只要 Devin 在该指定仓库中工作，就会始终使用该 Knowledge。
* 固定到**所有仓库**：无论 Devin 在任何会话中处理哪个仓库，该 Knowledge 都会自动应用到每个仓库。
