列出 Actor

返回分页的 Actor 列表

GET /openapi/memorylake/api/v3/actors

返回账户中所有 Actor 的分页列表。您可以按 Actor 类型筛选，或按显示名称搜索。

所需权限： actor:list

查询参数

page_size · integer · default: "20"

每页返回的 Actor 数量。

continuation_token · string

上一次调用返回的分页令牌。首次请求时省略此参数。

actor_type · string

按 Actor 类型筛选。取值为 HUMAN 或 ASSISTANT。

display_name_fuzzy · string

按显示名称模糊搜索。

First page

curl -X GET 'https://app.memorylake.cn/openapi/memorylake/api/v3/actors?page_size=20' \
  -H 'Authorization: Bearer sk_xxxxxx'

curl -X GET 'https://app.memorylake.cn/openapi/memorylake/api/v3/actors?actor_type=HUMAN' \
  -H 'Authorization: Bearer sk_xxxxxx'

curl -X GET 'https://app.memorylake.cn/openapi/memorylake/api/v3/actors?display_name_fuzzy=Alice' \
  -H 'Authorization: Bearer sk_xxxxxx'

curl -X GET 'https://app.memorylake.cn/openapi/memorylake/api/v3/actors?page_size=20&continuation_token=eyJsYXN0X2lkIjoiYWN0LTk4NzY1NCJ9' \
  -H 'Authorization: Bearer sk_xxxxxx'

响应

data · object

Show 分页 Actor 列表

items · array

Actor 对象数组

Show Actor 对象

id · string

Actor ID

custom_id · string

调用方定义的外部标识符

actor_type · string

Actor 类型：HUMAN 或 ASSISTANT

display_name · string

人类可读的显示名称

description · string

Actor 描述

metadata · object

调用方定义的元数据（键值对）

created_at · string

创建时间戳

updated_at · string

最后更新时间戳

continuation_token · string

下一页的分页令牌。当为最后一页时，该值不存在或为 null。

Success (200)

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "act-a1b2c3d4e5f6",
        "custom_id": "user-ext-001",
        "actor_type": "HUMAN",
        "display_name": "Alice Chen",
        "description": "Primary end user for the mobile app",
        "metadata": {
          "tier": "premium",
          "region": "us-west"
        },
        "created_at": "2025-03-10T08:00:00Z",
        "updated_at": "2025-03-10T08:00:00Z"
      },
      {
        "id": "act-f6e5d4c3b2a1",
        "custom_id": "system-intake",
        "actor_type": "ASSISTANT",
        "display_name": "Intake Bot",
        "description": "Automated intake system for onboarding flows",
        "metadata": {},
        "created_at": "2025-03-12T14:30:00Z",
        "updated_at": "2025-03-12T14:30:00Z"
      }
    ],
    "continuation_token": "eyJsYXN0X2lkIjoiYWN0LWY2ZTVkNGMzYjJhMSJ9"
  }
}