GET /openapi/memorylake/api/v3/actors
所需权限：
actor:list查询参数
integer
default:"20"
每页返回的 Actor 数量。
string
上一次调用返回的分页令牌。首次请求时省略此参数。
string
按 Actor 类型筛选。取值为
HUMAN 或 ASSISTANT。string
按显示名称模糊搜索。
string[]
按标签筛选。重复传参（
?tags=vip&tags=cn）或用逗号分隔（?tags=vip,cn）可同时要求多个标签——只返回同时带有所有列出标签的 Actor。匹配是精确且区分大小写的。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?tags=vip&tags=cn' \
-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'
响应
object
{
"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",
"tags": ["vip", "cn"],
"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",
"tags": [],
"metadata": {},
"created_at": "2025-03-12T14:30:00Z",
"updated_at": "2025-03-12T14:30:00Z"
}
],
"continuation_token": "eyJsYXN0X2lkIjoiYWN0LWY2ZTVkNGMzYjJhMSJ9"
}
}