Quickstart

Use the default memory to write, view, and search memories in 3 steps. To customize memory rules, see Create memory.

Prerequisites

First-time use requires activating Memory: open the Memory page in the Bailian console and click Activate Now
DASHSCOPE_API_KEY configured. See Get API key
For Python SDK: pip install agentscope-runtime

Step 1: Write memory

Call AddMemory to pass a conversation to the memory. The system auto-extracts factual memories.

curl -X POST https://dashscope.aliyuncs.com/api/v2/apps/memory/add \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "messages": [
      {"role": "user", "content": "Remind me to drink water at 9 AM every day"},
      {"role": "assistant", "content": "Got it, recorded"},
      {"role": "user", "content": "Remind me to organize meeting notes at 10 AM tomorrow"}
    ],
    "user_id": "user_001"
  }'

Step 2: View memory

In the Bailian console, open the default memory's Memory details tab. Enter memory entity ID user_001 and click View to see auto-extracted factual memories. Or list memories via API:

curl -X GET "https://dashscope.aliyuncs.com/api/v2/apps/memory/memory_nodes?user_id=user_001&page_size=10&page_num=1" \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header "Content-Type: application/json"

Step 3: Search memory

In the console, switch to the Memory search tab. Enter entity ID user_001, type "What do I need to do?" in the input, and click Run. Or search via API:

curl -X POST https://dashscope.aliyuncs.com/api/v2/apps/memory/memory_nodes/search \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "user_id": "user_001",
    "messages": [{"role": "user", "content": "What do I need to do?"}],
    "top_k": 10,
    "min_score": 0.3,
    "plan_version": "Lite"
  }'

You've completed writing, viewing, and searching memories. Inject the results into your prompt for personalized responses.

After the core flow, continue to create a memory with custom rules.

​Prerequisites

​Step 1: Write memory

​Step 2: View memory

​Step 3: Search memory

Prerequisites

Step 1: Write memory

Step 2: View memory

Step 3: Search memory