检索记忆版本

GET

memory_stores

{memory_store_id}

memory_versions

{memory_version_id}

检索记忆版本

curl --request GET \
  --url http://localhost:38080/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id} \
  --header 'X-Api-Key: <api-key>'

import requests

url = "http://localhost:38080/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}"

headers = {"X-Api-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};

fetch('http://localhost:38080/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "http://localhost:38080/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Api-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "type": "memory_version",
  "id": "<string>",
  "memory_store_id": "<string>",
  "memory_id": "<string>",
  "operation": "created",
  "created_at": "2023-11-07T05:31:56Z",
  "path": "<string>",
  "content": "<string>",
  "content_size_bytes": 123,
  "content_sha256": "<string>",
  "created_by": {
    "type": "session_actor",
    "session_id": "<string>"
  },
  "redacted_at": "2023-11-07T05:31:56Z",
  "redacted_by": {
    "type": "session_actor",
    "session_id": "<string>"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

每个请求都必须发送 ?beta=true。

授权

X-Api-Key

string

header

默认值:sk-ant-local-default

必填

OMA 工作区 API 密钥。

请求头

anthropic-version

string

anthropic-beta

string

路径参数

memory_store_id

string

必填

记忆存储标识符。

memory_version_id

string

必填

记忆版本标识符。

查询参数

beta

enum<boolean>

必填

为此接口启用 Beta API 合同，必须为 true。

可用选项:

true

view

enum<string>

view 的查询参数选择服务器返回 memory 或 memory_version 的哪种投影。basic 返回 content 置为 null 的对象；full 会填充 content。省略时默认值因端点而异：检索操作默认为 full；列表、创建和更新操作默认为 basic。使用 view=full 进行列表查询时，limit 上限为 20。

可用选项:

basic,

full

响应

请求成功。

memory_version 对象：记忆只追加历史中的一条不可变、带归因的记录。对记忆的每一次非无操作变更都会产生一个新版本。版本属于存储（而非单个记忆），并在记忆删除后继续保留。检索被脱敏的版本会返回 200，且 content、path、content_size_bytes 和 content_sha256 均置为 null；请根据 redacted_at 分支判断，而不是 HTTP 状态码。

type

enum<string>

必填

可用选项:

memory_version

string

必填

此版本的唯一标识符（memver_... 值）。

memory_store_id

string

必填

该版本所属的记忆存储的 ID（memstore_... 格式的值）。

memory_id

string

必填

该版本所快照的记忆的 ID（mem_... 值）。在该记忆被删除后仍然有效；将其作为 memory_id 传给列出记忆版本，即可检索完整的谱系，包括 deleted 行。

operation

enum<string>

必填

该版本记录的变更类型：created、modified 或 deleted。

可用选项:

created,

modified,

deleted

created_at

string<date-time>

必填

此版本的写入时间，采用 RFC 3339 格式。

path

string | null

此次写入时该记忆的路径。当且仅当设置了 redacted_at 时为 null。

content

string | null

该记忆在此版本时的 UTF-8 文本内容。view=basic、operation 为 deleted 或已设置 redacted_at 时为 null。

content_size_bytes

integer<int32> | null

此版本时 content 的字节大小。设置了 redacted_at 或 operation 为 deleted 时为 null。其他情况下无论 view 如何均会填充。

content_sha256

string | null

该版本 content 的小写十六进制 SHA-256 摘要（64 个字符）。当设置了 redacted_at 或 operation 为 deleted 时为 null。其他情况下无论 view 为何都会填充。

created_by

object

执行本次写入的主体：session_actor、api_actor 或 user_actor。在写入时记录，并在脱敏处理后保留。

Option 1
Option 2
Option 3

Show child attributes

redacted_at

string<date-time> | null

该版本被脱敏的时间，采用 RFC 3339 格式；未被脱敏时为 null。设置后，content、path、content_size_bytes 和 content_sha256 均为 null。参见脱敏记忆版本。

redacted_by

object

对此版本执行编辑的主体，未编辑时为 null。实践中始终为 api_actor 或 user_actor（智能体不具备编辑能力）。

Option 1
Option 2
Option 3

Show child attributes

检索记忆版本

curl --request GET \
  --url http://localhost:38080/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id} \
  --header 'X-Api-Key: <api-key>'

import requests

url = "http://localhost:38080/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}"

headers = {"X-Api-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};

fetch('http://localhost:38080/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "http://localhost:38080/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Api-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "type": "memory_version",
  "id": "<string>",
  "memory_store_id": "<string>",
  "memory_id": "<string>",
  "operation": "created",
  "created_at": "2023-11-07T05:31:56Z",
  "path": "<string>",
  "content": "<string>",
  "content_size_bytes": 123,
  "content_sha256": "<string>",
  "created_by": {
    "type": "session_actor",
    "session_id": "<string>"
  },
  "redacted_at": "2023-11-07T05:31:56Z",
  "redacted_by": {
    "type": "session_actor",
    "session_id": "<string>"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  }
}

开始使用

核心 API

托管智能体

Webhook

授权

请求头

路径参数

查询参数

响应