Skip to main content
用户画像

创建画像模板

创建用户画像模板,定义画像字段

POST
/profile_schemas
cURL
curl --request POST \
  --url 'https://dashscope.aliyuncs.com/api/v2/apps/memory/profile_schemas' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "attributes": [
    {
      "name": "<string>",
      "description": "<string>"
    }
  ],
  "plan_version": "Pro"
}
'
创建用户画像模板,定义画像包含的字段及描述。

请求参数

参数类型必填说明
namestring画像模板名称
descriptionstring模板描述,用于指导智能体调用
attributesarray画像字段列表,每项含 namedescription
plan_versionstringProLite,不传默认 Pro

代码示例

curl -X POST https://dashscope.aliyuncs.com/api/v2/apps/memory/profile_schemas \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "用户基础画像",
    "description": "包含年龄和兴趣的用户信息",
    "attributes": [
      {"name": "年龄", "description": "用户年龄"},
      {"name": "爱好", "description": "用户的兴趣爱好"},
      {"name": "职业", "description": "用户职业"}
    ]
  }'

# response
{
  "profile_schema_id": "schema_xxx",
  "request_id": "a1b2c3d4-..."
}
创建后,使用 AddMemory 传入 profile_schema 提取画像,再用 GetUserProfile 获取。

Authorizations

string
header
required

Body

application/json
string
required

画像模板名称

object[]
required

画像字段列表

string

模板描述

enum<string>

策略版本,不传默认 Pro

Pro,Lite

Response

200-成功

成功

Managed Agent API
Sandbox API
Flow Agent API
RAG API
Connector API
框架集成
  • 框架
Assistant API(下线中)
  • 概览