创建 Actor

POST /openapi/memorylake/api/v3/actors

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

所需权限： actor:create

请求体

string

required

调用方定义的外部标识符。在您的账户中必须唯一。使用此字段将 Actor 映射到您自己系统中的身份。

string

Actor 类型。可选值：HUMAN（默认，终端用户）或 ASSISTANT（AI Agent — 通常在创建 Agent 时自动生成）。

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

Actor 类型：HUMAN 或 ASSISTANT

string

人类可读的显示名称

string

Actor 描述

string[]

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

object

调用方定义的元数据

string

创建时间戳

string

最后更新时间戳

{
  "success": true,
  "data": {
    "id": "act-a1b2c3d4e5f6",
    "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

管理 API

请求体

响应

​请求体

​响应

请求体

响应