Memorax API 开发者文档

复制# metadata.source：当前代码场景必填，必须为 memorax-code；即将取消此必填要求。
# content_type：混合场景选 auto，办公类场景选 work。
curl --request POST "$MEMORAX_BASE_URL/v1/memories/add" \
  --header "Authorization: Token $MEMORAX_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "user_id": "quickstart-user",
  "async_mode": true,
  "content_type": "code",
  "mode": "default",
  "session_id": "cedar-coding-session",
  "metadata": {
    "source": "memorax-code"
  },
  "messages": [
    {
      "role": "user",
      "content": "Cedar 项目的回调模块已确定以下约束：自动投递总次数最多 3 次；重试复用同一个 event_id；使用唯一约束避免重复产生业务效果。",
      "timestamp": -1
    }
  ]
}'

复制import os
import requests

base = os.environ["MEMORAX_BASE_URL"].rstrip("/")
headers = {"Authorization": "Token " + os.environ["MEMORAX_API_KEY"]}
payload = {'user_id': 'quickstart-user',
 'async_mode': True,
 'content_type': 'code', # content_type：混合场景选 auto，办公类场景选 work。
 'mode': 'default',
 'session_id': 'cedar-coding-session',
 'metadata': {'source': 'memorax-code'}, # metadata.source：当前代码场景必填，必须为 memorax-code；即将取消此必填要求。
 'messages': [{'role': 'user',
               'content': 'Cedar 项目的回调模块已确定以下约束：自动投递总次数最多 3 次；重试复用同一个 '
                          'event_id；使用唯一约束避免重复产生业务效果。',
               'timestamp': -1}]}

response = requests.post(base + "/v1/memories/add", headers=headers, json=payload, timeout=120)
response.raise_for_status()
print(response.json())

复制const base = process.env.MEMORAX_BASE_URL.replace(/\/$/, "");
const headers = { Authorization: `Token ${process.env.MEMORAX_API_KEY}` };
const payload = {
  "user_id": "quickstart-user",
  "async_mode": true,
  "content_type": "code", // content_type：混合场景选 auto，办公类场景选 work。
  "mode": "default",
  "session_id": "cedar-coding-session",
  "metadata": {
    "source": "memorax-code" // metadata.source：当前代码场景必填，必须为 memorax-code；即将取消此必填要求。
  },
  "messages": [
    {
      "role": "user",
      "content": "Cedar 项目的回调模块已确定以下约束：自动投递总次数最多 3 次；重试复用同一个 event_id；使用唯一约束避免重复产生业务效果。",
      "timestamp": -1
    }
  ]
};

const response = await fetch(`${base}/v1/memories/add`, {
  method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify(payload),
  signal: AbortSignal.timeout(120000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

复制curl --request GET "$MEMORAX_BASE_URL/v1/memories/add/status/TASK_ID" \
  --header "Authorization: Token $MEMORAX_API_KEY"

复制import os
import requests

base = os.environ["MEMORAX_BASE_URL"].rstrip("/")
headers = {"Authorization": "Token " + os.environ["MEMORAX_API_KEY"]}
task_id = "TASK_ID"  # 替换为 Add 返回的 data.task_id

response = requests.get(base + "/v1/memories/add/status/" + task_id, headers=headers, timeout=30)
response.raise_for_status()
print(response.json())

复制const base = process.env.MEMORAX_BASE_URL.replace(/\/$/, "");
const headers = { Authorization: `Token ${process.env.MEMORAX_API_KEY}` };
const taskId = "TASK_ID"; // 替换为 Add 返回的 data.task_id

const response = await fetch(`${base}/v1/memories/add/status/${encodeURIComponent(taskId)}`, {
  headers,
  signal: AbortSignal.timeout(30000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

复制curl --request POST "$MEMORAX_BASE_URL/v1/memories/search" \
  --header "Authorization: Token $MEMORAX_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "user_id": "quickstart-user",
  "query": "实现 Cedar 回调模块时，重试次数和幂等处理需要遵守哪些约束？",
  "mode": "fast",
  "output_mode": "summary",
  "top_k": 5
}'

复制import os
import requests

base = os.environ["MEMORAX_BASE_URL"].rstrip("/")
headers = {"Authorization": "Token " + os.environ["MEMORAX_API_KEY"]}
payload = {'user_id': 'quickstart-user',
 'query': '实现 Cedar 回调模块时，重试次数和幂等处理需要遵守哪些约束？',
 'mode': 'fast',
 'output_mode': 'summary',
 'top_k': 5}

response = requests.post(base + "/v1/memories/search", headers=headers, json=payload, timeout=120)
response.raise_for_status()
print(response.json())

复制const base = process.env.MEMORAX_BASE_URL.replace(/\/$/, "");
const headers = { Authorization: `Token ${process.env.MEMORAX_API_KEY}` };
const payload = {
  "user_id": "quickstart-user",
  "query": "实现 Cedar 回调模块时，重试次数和幂等处理需要遵守哪些约束？",
  "mode": "fast",
  "output_mode": "summary",
  "top_k": 5
};

const response = await fetch(`${base}/v1/memories/search`, {
  method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify(payload),
  signal: AbortSignal.timeout(120000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

复制curl --request POST "$MEMORAX_BASE_URL/v1/memories/add" \
  --header "Authorization: Token $MEMORAX_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "user_id": "demo-user",
  "async_mode": true,
  "messages": [
    {
      "role": "user",
      "content": "Cedar 回调最多重试三次。",
      "timestamp": -1
    },
    {
      "role": "assistant",
      "content": "已确认，会按此约束实现。",
      "timestamp": -1
    }
  ]
}'

复制import os
import requests

base = os.environ["MEMORAX_BASE_URL"].rstrip("/")
payload = {
    "user_id": "demo-user",
    "async_mode": True,
    "messages": [
        {"role": "user", "content": "Cedar 回调最多重试三次。", "timestamp": -1},
        {"role": "assistant", "content": "已确认，会按此约束实现。", "timestamp": -1},
    ],
}
response = requests.post(
    base + "/v1/memories/add",
    headers={"Authorization": "Token " + os.environ["MEMORAX_API_KEY"]},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(response.json())

复制// Node.js 18+，保存为 .mjs 后执行；密钥不应放在公开网页中。
const base = process.env.MEMORAX_BASE_URL.replace(/\/$/, "");
const payload = {
  "user_id": "demo-user",
  "async_mode": true,
  "messages": [
    {
      "role": "user",
      "content": "Cedar 回调最多重试三次。",
      "timestamp": -1
    },
    {
      "role": "assistant",
      "content": "已确认，会按此约束实现。",
      "timestamp": -1
    }
  ]
};
const response = await fetch(`${base}/v1/memories/add`, {
  method: "POST",
  headers: {
    Authorization: `Token ${process.env.MEMORAX_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify(payload),
  signal: AbortSignal.timeout(120000),
});
if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
console.log(await response.json());

复制curl --request POST "$MEMORAX_BASE_URL/v1/memories/search" \
  --header "Authorization: Token $MEMORAX_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "user_id": "demo-user",
  "query": "Cedar 回调如何重试？",
  "mode": "fast",
  "output_mode": "summary",
  "top_k": 5
}'

复制import os
import requests

base = os.environ["MEMORAX_BASE_URL"].rstrip("/")
payload = {'user_id': 'demo-user',
 'query': 'Cedar 回调如何重试？',
 'mode': 'fast',
 'output_mode': 'summary',
 'top_k': 5}
response = requests.post(
    base + "/v1/memories/search",
    headers={"Authorization": "Token " + os.environ["MEMORAX_API_KEY"]},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(response.json())

复制// Node.js 18+，保存为 .mjs 后执行；密钥不应放在公开网页中。
const base = process.env.MEMORAX_BASE_URL.replace(/\/$/, "");
const payload = {
  "user_id": "demo-user",
  "query": "Cedar 回调如何重试？",
  "mode": "fast",
  "output_mode": "summary",
  "top_k": 5
};
const response = await fetch(`${base}/v1/memories/search`, {
  method: "POST",
  headers: {
    Authorization: `Token ${process.env.MEMORAX_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify(payload),
  signal: AbortSignal.timeout(120000),
});
if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
console.log(await response.json());