创建 Actor

curl -X POST 'https://app.memorylake.cn/openapi/memorylake/api/v3/actors' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "custom_id": "user-ext-001",
    "actor_type": "HUMAN",
    "display_name": "Alice Chen",
    "description": "Primary end user for the mobile app",
    "tags": ["vip", "cn"],
    "metadata": {
      "tier": "premium",
      "region": "us-west"
    }
  }'

{
  "success": true,
  "data": {
    "id": "actor-8d093c0578ffeb19f8fa10ea28ee9362",
    "custom_id": "user-ext-001",
    "actor_type": "HUMAN",
    "display_name": "Alice Chen",
    "description": "Primary end user for the mobile app",
    "tags": ["vip", "cn"],
    "metadata": {
      "tier": "premium",
      "region": "us-west"
    },
    "created_at": "2025-03-10T08:00:00Z",
    "updated_at": "2025-03-10T08:00:00Z"
  }
}

curl -X POST 'https://app.memorylake.cn/openapi/memorylake/api/v3/actors' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "custom_id": "user-ext-001",
    "actor_type": "HUMAN",
    "display_name": "Alice Chen",
    "description": "Primary end user for the mobile app",
    "tags": ["vip", "cn"],
    "metadata": {
      "tier": "premium",
      "region": "us-west"
    }
  }'

{
  "success": true,
  "data": {
    "id": "actor-8d093c0578ffeb19f8fa10ea28ee9362",
    "custom_id": "user-ext-001",
    "actor_type": "HUMAN",
    "display_name": "Alice Chen",
    "description": "Primary end user for the mobile app",
    "tags": ["vip", "cn"],
    "metadata": {
      "tier": "premium",
      "region": "us-west"
    },
    "created_at": "2025-03-10T08:00:00Z",
    "updated_at": "2025-03-10T08:00:00Z"
  }
}

POST /openapi/memorylake/api/v3/actors

创建一个新的 Actor。Actor 代表会话中的参与者——通常是终端用户或系统身份，其交互会生成记忆。创建 Actor 后，您可以将其绑定到工作空间，使其能够参与该工作空间项目中的会话。

所需权限： actor:create

请求体

string

required

这个Actor在您自己系统里已有的标识符。在您的租户内必须唯一。后续请求带上 by_custom_id=true，即可用它代替 id 来访问。参见您自己的标识符。

string

required

人类可读的名称，显示在控制台中并在 API 响应中返回。

string

Actor 角色或用途的自由文本描述。

string[]

用于分组和筛选 Actor 的标签，例如 vip 或 cn。重复的标签会被去除，首尾空白会被裁剪。匹配是精确且区分大小写的，因此 VIP 和 vip 是两个不同的标签。每个 Actor 最多 20 个标签，每个标签最长 64 个字符，标签中不能包含逗号。

object

任意键值对，用于调用方定义的元数据，例如层级、地区或部门。元数据不支持筛选——需要按属性检索时请使用 tags。

curl -X POST 'https://app.memorylake.cn/openapi/memorylake/api/v3/actors' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "custom_id": "user-ext-001",
    "actor_type": "HUMAN",
    "display_name": "Alice Chen",
    "description": "Primary end user for the mobile app",
    "tags": ["vip", "cn"],
    "metadata": {
      "tier": "premium",
      "region": "us-west"
    }
  }'

响应

object

Show Actor

string

Actor ID

string

调用方定义的外部标识符

string

人类可读的显示名称

string

Actor 描述

string[]

Actor 上的标签。没有标签时为空数组

object

调用方定义的元数据

string

创建时间戳

string

最后更新时间戳

{
  "success": true,
  "data": {
    "id": "actor-8d093c0578ffeb19f8fa10ea28ee9362",
    "custom_id": "user-ext-001",
    "actor_type": "HUMAN",
    "display_name": "Alice Chen",
    "description": "Primary end user for the mobile app",
    "tags": ["vip", "cn"],
    "metadata": {
      "tier": "premium",
      "region": "us-west"
    },
    "created_at": "2025-03-10T08:00:00Z",
    "updated_at": "2025-03-10T08:00:00Z"
  }
}

MemoryLake API

Memory Router API

请求体

响应

​请求体

​响应

请求体

响应