1Authorization: Bearer <your-api-key>
2Content-Type: application/json

1curl "$MEMORY_API_BASE_URL/memories/retain" \
2  -H "Authorization: Bearer $MEMORY_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "bank_id": "'"$MEMORY_BANK_ID"'",
6    "items": [
7      {
8        "content": "用户偏好使用 TypeScript、React 和 Tailwind 构建前端页面。",
9        "context": "project onboarding",
10        "document_id": "onboarding-session-001",
11        "timestamp": "2026-05-12T10:00:00+08:00",
12        "tags": ["user:demo", "project:frontend"]
13      }
14    ]
15  }'

1curl "$MEMORY_API_BASE_URL/memories/retain" \
2  -H "Authorization: Bearer $MEMORY_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "bank_id": "'"$MEMORY_BANK_ID"'",
6    "items": [
7      {
8        "content": "新增讨论：团队决定将状态管理从 Redux 迁移到 Zustand。",
9        "document_id": "onboarding-session-001",
10        "update_mode": "append",
11        "tags": ["user:demo", "project:frontend"]
12      }
13    ]
14  }'

1curl "$MEMORY_API_BASE_URL/files/retain" \
2  -H "Authorization: Bearer $MEMORY_API_KEY" \
3  -F 'request={
4    "bank_id":"'"$MEMORY_BANK_ID"'",
5    "document_id":"product-guide-001",
6    "tags":["project:docs"]
7  }' \
8  -F "files=@./product-guide.md;type=text/markdown"

1curl "$MEMORY_API_BASE_URL/recall" \
2  -H "Authorization: Bearer $MEMORY_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "bank_id": "'"$MEMORY_BANK_ID"'",
6    "query": "这个用户偏好的前端技术栈是什么？",
7    "budget": "mid",
8    "tags": ["user:demo"],
9    "tags_match": "all_strict",
10    "max_tokens": 1200,
11    "trace": true
12  }'

1const apiBaseUrl = process.env.MEMORY_API_BASE_URL;
2const memoryKey = process.env.MEMORY_API_KEY;
3const bankId = process.env.MEMORY_BANK_ID;
4
5async function recallUserContext(userMessage) {
6  const response = await fetch(`${apiBaseUrl}/recall`, {
7    method: "POST",
8    headers: {
9      "Authorization": `Bearer ${memoryKey}`,
10      "Content-Type": "application/json",
11    },
12    body: JSON.stringify({
13      bank_id: bankId,
14      query: userMessage,
15      budget: "mid",
16      tags: ["user:demo"],
17      tags_match: "all_strict",
18    }),
19  });
20
21  if (!response.ok) {
22    throw new Error(`Recall failed: ${response.status}`);
23  }
24
25  return response.json();
26}

1import os
2import requests
3
4api_base_url = os.environ["MEMORY_API_BASE_URL"]
5api_key = os.environ["MEMORY_API_KEY"]
6bank_id = os.environ["MEMORY_BANK_ID"]
7
8resp = requests.post(
9    f"{api_base_url}/recall",
10    headers={
11        "Authorization": f"Bearer {api_key}",
12        "Content-Type": "application/json",
13    },
14    json={
15        "bank_id": bank_id,
16        "query": "这个用户最近在做什么项目？",
17        "budget": "mid",
18        "tags": ["user:demo"],
19        "tags_match": "all_strict",
20    },
21    timeout=30,
22)
23
24resp.raise_for_status()
25print(resp.json())

1curl "$MEMORY_API_BASE_URL/reflect" \
2  -H "Authorization: Bearer $MEMORY_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "bank_id": "'"$MEMORY_BANK_ID"'",
6    "query": "请总结这个用户的工程偏好，并给出接下来生成代码时应遵循的建议。",
7    "budget": "mid",
8    "include_facts": true,
9    "tags": ["user:demo"],
10    "tags_match": "all_strict"
11  }'

1curl "$MEMORY_API_BASE_URL/reflect" \
2  -H "Authorization: Bearer $MEMORY_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "bank_id": "'"$MEMORY_BANK_ID"'",
6    "query": "这个用户适合使用什么前端框架？",
7    "budget": "low",
8    "response_schema": {
9      "type": "object",
10      "properties": {
11        "recommendation": {"type": "string"},
12        "confidence": {"type": "string", "enum": ["low", "medium", "high"]},
13        "reasons": {"type": "array", "items": {"type": "string"}}
14      },
15      "required": ["recommendation", "confidence", "reasons"]
16    }
17  }'