智能体

记忆

智能体会记住。每个项目都有一个持久的知识图谱，智能体在工作时会读取并写入它——因此智能体在周一学到的东西，到周五依然存在，并且跨会话线程共享。检索是词法与语义混合的，记忆可链接、有版本，每个事实都携带其溯源信息。

记忆与检索

写下一个事实，它就会作为一个节点存储进项目的图谱中；搜索融合了关键词匹配与语义匹配，因此即使用词不同，一次查询也能找到正确的记忆。智能体会自动执行此操作；你也可以直接读取并整理这个图谱。

shell

# An agent (or you) writes a fact; recall is hybrid lexical + semantic.
curl https://api.commandagi.com/threads/$THREAD_ID/memory ''
  -H "Authorization: Bearer $COMMANDAGI_API_KEY" ''
  -d '{ "text": "The staging DB password rotates every Sunday 02:00 UTC." }'

curl "https://api.commandagi.com/threads/$THREAD_ID/memory?q=staging%20db" ''
  -H "Authorization: Bearer $COMMANDAGI_API_KEY"

不只是一个记事本

链接——将记忆连接成一张图谱（这个依赖于那个，这个与那个相矛盾）。
溯源——每个事实都会记录智能体为什么相信它；可以查询任意节点背后的因果链。
历史——记忆是事件溯源式的，因此你可以查看一个信念是如何随时间变化的。
分叉与对比——为一次实验分叉这张图谱，之后再把它对比合并回来，就像给一台机器做快照一样。

面向开发者的接口

记忆是一套一等公民的 API 和工具集，范围限定在单个项目内，并受到与其他一切相同的权限约束：

POST/app/threads/:id/memory记住一个事实。

GET/app/threads/:id/memory检索（混合搜索），或列出。

POST/app/threads/:id/memory/link链接两条记忆。

GET/app/threads/:id/memory/:nodeId/causal一条记忆背后的溯源链。

POST/app/threads/:id/memory/fork分叉这张图谱；之后再对比。

同样的操作也是智能体工具（memory_remember、memory_search、memory_link、memory_causal、memory_fork 等），因此智能体可以在工作过程中自行整理自己的记忆。

记忆