概览 - MemoryLake AI

Boundary（记忆边界）是一个工作空间内有名字的记忆范围。它记下某类流量涉及哪些项目、哪个人、哪个 Agent，使用它的一方就只读写这部分记忆。您不必在每次调用时都传这四类引用，只需传 Boundary 的 ID。使用 Boundary 的地方：

Memory Router——在 LLM 调用上以 ?boundary_id= 传入。常见做法是每个终端用户一个 Boundary，这样每个用户的会话只读写自己的记忆。
MCP——客户端连接时，用户在 OAuth 授权页面上选择工作空间和 Boundary。

您可以在控制台创建 Boundary，也可以用下面的端点管理。

Boundary 包含什么

字段	含义
`workspace_id`	Boundary 所属的工作空间。创建时设定，之后不能修改。
`project_ids`	范围内的项目。不传或为空表示不把范围收窄到特定项目。
`human_actor_id`	范围内的 Actor，即那个人。可选。
`agent_id`	其记忆在范围内的 Agent。可选。
`name`	显示名称
`custom_id`	您自己的标识符，可配合 `by_custom_id=true` 查找 Boundary。创建时设定，之后不能修改。

Boundary 引用的每个项目、Actor 和 Agent 都必须属于它的工作空间：项目必须在该工作空间内，Actor 和 Agent 必须已绑定到该工作空间且未被删除。

读取 Boundary 只需 boundary:read。它展示的是声明了什么范围，而不是范围里有什么：通过 Boundary 检索时，仍会对内容本身检查权限。创建或更新 Boundary 时，还需要对请求中引用的每个对象有检索权限，因为 Boundary 就是检索这些内容的一种方式：

请求中引用了	需要对它有的权限
`project_ids` 中的项目	`project:mem_search` 和 `project:doc_search`
`human_actor_id`	`workspace_actor:fact_search`
`agent_id`	`workspace_agent:fact_search`

缺少任何一项，整个请求都会以 403 被拒绝。