Create Profile Schema

Creates a user profile schema, defining the fields and descriptions included in the profile.

Method and endpoint

POST https://dashscope.aliyuncs.com/api/v2/apps/memory/profile_schemas

Request parameters

Parameter	Type	Required	Location	Description
`name`	string	Yes	Body	Profile schema name, up to 32 characters
`description`	string	No	Body	Profile schema description
`plan_version`	string	No	Body	Billing plan: `pro` or `lite`
`extract_scene`	string	No	Body	Extraction mode: `efficient` or `intelligent`; defaults to `efficient`
`attributes`	array	Yes	Body	Profile attribute definitions; the array cannot be empty
`attributes[].name`	string	Yes	Body	Attribute name
`attributes[].description`	string	No	Body	Attribute description
`memory_library_id`	string	No	Body	Memory library ID. If omitted, the default memory library is used

Code examples

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": "Basic user profile",
    "description": "User information including age and interests",
    "extract_scene": "efficient",
    "attributes": [
      {"name": "Age", "description": "User age"},
      {"name": "Hobbies", "description": "User interests and hobbies"},
      {"name": "Occupation", "description": "User occupation"}
    ]
  }'

Response example

{
  "profile_schema_id": "50edf54eaa5842e891d959ae115205be",
  "request_id": "f190a540-814e-9c1c-873e-0661851c8fca"
}

After creation, pass profile_schema via AddMemory to extract the profile, then use GetUserProfile to retrieve it.

​Method and endpoint

​Request parameters

​Code examples

​Response example

Method and endpoint

Request parameters

Code examples

Response example