创建 Boundary

curl -X POST 'https://app.memorylake.cn/openapi/memorylake/api/v3/boundaries' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "workspace_id": "ws-8001856949ad4f6a5b6226f415ffa877",
    "name": "Alice Chen - Support Assistant",
    "custom_id": "user-ext-001",
    "project_ids": ["proj-b93e8d95a8705bcc4ec42a65ba4cc7f8"],
    "human_actor_id": "actor-8d093c0578ffeb19f8fa10ea28ee9362",
    "agent_id": "agent-f8bf71ab17ed8eccad8c0e8ae708273f"
  }'

{
  "success": true,
  "data": {
    "id": "bnd-5e8a2c71d94f4b3a8e6d0c2b7f1a9e34",
    "custom_id": "user-ext-001",
    "workspace_id": "ws-8001856949ad4f6a5b6226f415ffa877",
    "name": "Alice Chen - Support Assistant",
    "project_ids": ["proj-b93e8d95a8705bcc4ec42a65ba4cc7f8"],
    "human_actor_id": "actor-8d093c0578ffeb19f8fa10ea28ee9362",
    "agent_id": "agent-f8bf71ab17ed8eccad8c0e8ae708273f"
  }
}

curl -X POST 'https://app.memorylake.cn/openapi/memorylake/api/v3/boundaries' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "workspace_id": "ws-8001856949ad4f6a5b6226f415ffa877",
    "name": "Alice Chen - Support Assistant",
    "custom_id": "user-ext-001",
    "project_ids": ["proj-b93e8d95a8705bcc4ec42a65ba4cc7f8"],
    "human_actor_id": "actor-8d093c0578ffeb19f8fa10ea28ee9362",
    "agent_id": "agent-f8bf71ab17ed8eccad8c0e8ae708273f"
  }'

{
  "success": true,
  "data": {
    "id": "bnd-5e8a2c71d94f4b3a8e6d0c2b7f1a9e34",
    "custom_id": "user-ext-001",
    "workspace_id": "ws-8001856949ad4f6a5b6226f415ffa877",
    "name": "Alice Chen - Support Assistant",
    "project_ids": ["proj-b93e8d95a8705bcc4ec42a65ba4cc7f8"],
    "human_actor_id": "actor-8d093c0578ffeb19f8fa10ea28ee9362",
    "agent_id": "agent-f8bf71ab17ed8eccad8c0e8ae708273f"
  }
}

POST /openapi/memorylake/api/v3/boundaries

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

所需权限： 对该工作空间的 boundary:create，以及对请求中引用的每个项目、Actor 和 Agent 的检索权限——参见权限

请求体

string

required

Boundary 所属的工作空间。之后不能修改。

string

required

显示名称，1 到 255 个字符。

string

这个 Boundary 在您自己系统里的标识符，最多 255 个字符。在您的租户内必须唯一，设置后不能修改，且不能以 _sys_ 开头。在获取 Boundary 时带上 by_custom_id=true 即可用它查找。参见您自己的标识符。

string[]

范围内的项目。不传或传空数组表示不把范围收窄到特定项目。

string

范围内的 Actor（即那个人）的 ID。

string

其记忆在范围内的 Agent 的 ID。

curl -X POST 'https://app.memorylake.cn/openapi/memorylake/api/v3/boundaries' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "workspace_id": "ws-8001856949ad4f6a5b6226f415ffa877",
    "name": "Alice Chen - Support Assistant",
    "custom_id": "user-ext-001",
    "project_ids": ["proj-b93e8d95a8705bcc4ec42a65ba4cc7f8"],
    "human_actor_id": "actor-8d093c0578ffeb19f8fa10ea28ee9362",
    "agent_id": "agent-f8bf71ab17ed8eccad8c0e8ae708273f"
  }'

响应

object

Show Boundary

string

Boundary ID

string

您为 Boundary 设置的自有标识符（如有）

string

Boundary 所属的工作空间

string

Boundary 名称

string[]

范围内的项目。不把范围收窄到特定项目时不出现。

string

范围内的 Actor。未设置时不出现。

string

其记忆在范围内的 Agent。未设置时不出现。

此响应不包含 created_at 和 updated_at，请通过获取 Boundary 读取。

错误

状态码	错误码	何时出现
`400`	`INVALID_ARGUMENT`	项目不在该工作空间内，或 Actor / Agent 不存在或未绑定到该工作空间。消息里会指出是哪个字段。
`400`	`ACTOR_INACTIVE`	Actor 或 Agent 已被删除
`403`	`ACCESS_DENIED`	您没有 `boundary:create`，或对请求中引用的某个对象没有检索权限
`404`	`NOT_FOUND`	工作空间不存在
`409`	`CUSTOM_ID_CONFLICT`	您的租户内已有其他 Boundary 使用了这个 `custom_id`

{
  "success": true,
  "data": {
    "id": "bnd-5e8a2c71d94f4b3a8e6d0c2b7f1a9e34",
    "custom_id": "user-ext-001",
    "workspace_id": "ws-8001856949ad4f6a5b6226f415ffa877",
    "name": "Alice Chen - Support Assistant",
    "project_ids": ["proj-b93e8d95a8705bcc4ec42a65ba4cc7f8"],
    "human_actor_id": "actor-8d093c0578ffeb19f8fa10ea28ee9362",
    "agent_id": "agent-f8bf71ab17ed8eccad8c0e8ae708273f"
  }
}

MemoryLake API

管理 API

请求体

响应

错误

​请求体

​响应

​错误

请求体

响应

错误