知识

知识标签页:项目的所有记忆,围绕它们所涉及的 C4 元素聚集

知识标签页把项目的共享记忆呈现为一张地图。记忆是代码无法告诉你的东西:有人在生产环境踩过的陷阱、团队商定的约定、智能体在工作会话结束时留下的笔记。人在应用中编写记忆,智能体通过 harness(remember、finish_work_session)编写。两者存放在同一个地方,并且都会提供给下一个改动系统同一部分的智能体。

可以从项目标题栏(知识)、命令面板,或别人分享的链接打开它。

阅读地图

  • 元素是圆环:知识所涉及的 C4 系统、容器和组件。每条记忆都位于它所固定的元素周围。
  • 记忆是圆点,按类型着色:陷阱、约定、笔记。带浅色内环的圆点由人编写,其余来自智能体。
  • 决策(ADR)是方块,当记忆用 [[ADR-12]] 链接到某个决策时出现。
  • 虚线幽灵是还没有人写的链接:某条记忆提到了 [[Rate limits]],但没有任何记忆使用这个标题。点击即可编写它。

即使有数千条记忆,地图依然清晰可读。陈述同一事实的记忆会折叠成一个圆点,三份副本说同一件事时标记为 ×3。会话结果默认隐藏,并在其元素上计数;可以通过工具栏中的会话按钮显示。类型图例同时也是筛选器,底部的时间轴可以回放知识是如何积累起来的。

点击圆点可阅读完整的记忆,包括其链接和反向链接。点击元素可查看固定在它上面的所有内容,并为它编写下一条记忆。

键盘:/ 搜索,N 编写记忆,F 显示整张地图,Esc 后退一步。

提问

仅根据项目记忆写出的回答,其依据的记忆在地图上高亮显示

在搜索框中输入问题,然后点击提问(或在问号后按 Enter)。回答只根据项目的记忆写出,使用与智能体相同的检索方式:词语和语义,再加上与最佳匹配相链接的记忆。每个论断都以编号标注出处;点击编号即可在地图上找到对应的记忆,被引用的记忆会高亮显示。

当记忆中没有相关内容时,回答会直接说明,而不是猜测。这正是把事实写下来的时候:下一个人和下一个智能体都能找到它。如果没有可用的 AI 提供商,你会看到最接近的记忆,而不是回答。提问不算作向智能体提供记忆,因此不会影响下文的使用情况数据。

与其他 harness 功能一样,回答使用你所在组织的 AI 提供商。

矛盾

编写一条与项目已有事实相矛盾的事实

当你编写的记忆与关于相同元素的现有记忆几乎一样,却给出了不同的数字(“重试 8 次”对比“重试 3 次”)时,Archyl 会在关闭对话框之前停下来,把两条都显示出来。两条相互矛盾的有效记忆是智能体可能收到的最糟糕的东西,所以由你来选择:

  • 替换旧记忆:旧记忆移入历史。智能体不再看到它,地图会把它保留为一个链接到替代者的幽灵。
  • 两者都保留:当两者都成立时(两个环境、两个租户),保留两者并明确说明差异。
  • 删除我的记忆:错的是你的记忆。

逐字重写一条已存在的事实不会存储第二份副本:而是确认现有的记忆,对话框会告诉你这一点。智能体通过 API 得到同样的处理,体现在 remember 的 deduplicated 和 conflicts 字段中。

链接到任意事实

每条记忆和每个元素都有自己的地址。阅读面板中的链接可以复制它;把它粘贴到 pull request、ADR 或 Slack 讨论串中,它会打开地图并定位到这条记忆及其相邻记忆。记忆与重复项合并后,指向它的链接仍然有效;指向之后被替换的记忆的链接会打开历史视图,确保总能落到某个地方。

重复项

当智能体用多种方式写下同一事实时,重复项按钮会显示每个分组。合并为一条保留确认次数最多的副本,停用其余副本并迁移它们的链接。是否合并始终由你决定:关于两个不同元素的相似措辞,或数字不同的内容,永远不会被当作重复项提出。

待复核

自确认以来元素已变化的记忆,以及智能体从不使用的记忆

没人复核的记忆会悄无声息地出错。地图的待复核视图只让需要人工查看的记忆保持完整显示,并把它们列出来:

  • 其元素已变化:自记忆上次确认以来,元素下的代码发生了漂移。智能体仍会收到它,但会标记为待验证。如果它仍然正确,点击仍然正确即可确认并清除标记;否则打开它进行更正或替换。
  • 智能体从不使用:它已被提供给五个或更多会话,但没有一个会话表示它有帮助。打开它,让它更精确、固定到正确的元素,或删除它。

这个列表中的内容都不会被自动移除。同样的条目也会出现在每周的摘要中发送给团队,因此列表不依赖于有人打开这个标签页。

使用情况

按提供给智能体的次数调整大小的记忆;空心的表示已提供但从未使用

使用情况视图按记忆被提供给的智能体会话数量来决定每条记忆的大小。实心圆点至少被使用过一次(智能体在结束会话时在 usedMemories 中列出了它),空心圆点被提供过但从未使用,浅淡的圆点从未被提供过。它让你一眼回答两个问题:哪些知识真正支撑着智能体的工作,哪些只是噪音。

权限

任何可以查看项目的人都可以阅读地图并提问。编写、确认、合并、替换和删除记忆需要项目的编辑权限。