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

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

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

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

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

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}/v1/default/banks/${bankId}/memories/recall`, {
7    method: "POST",
8    headers: {
9      "Authorization": `Bearer ${memoryKey}`,
10      "Content-Type": "application/json",
11    },
12    body: JSON.stringify({
13      query: userMessage,
14      budget: "mid",
15      tags: ["user:demo"],
16      tags_match: "all_strict",
17    }),
18  });
19
20  if (!response.ok) {
21    throw new Error(`Recall failed: ${response.status}`);
22  }
23
24  return response.json();
25}

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}/v1/default/banks/{bank_id}/memories/recall",
10    headers={
11        "Authorization": f"Bearer {api_key}",
12        "Content-Type": "application/json",
13    },
14    json={
15        "query": "这个用户最近在做什么项目？",
16        "budget": "mid",
17        "tags": ["user:demo"],
18        "tags_match": "all_strict",
19    },
20    timeout=30,
21)
22
23resp.raise_for_status()
24print(resp.json())

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

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