更新记忆

POST

memory_stores

{memory_store_id}

memories

{memory_id}

更新记忆

curl --request POST \
  --url http://localhost:38080/v1/memory_stores/{memory_store_id}/memories/{memory_id} \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '{}'

import requests

url = "http://localhost:38080/v1/memory_stores/{memory_store_id}/memories/{memory_id}"

payload = {}
headers = {
    "X-Api-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

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

package main

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

func main() {

	url := "http://localhost:38080/v1/memory_stores/{memory_store_id}/memories/{memory_id}"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Api-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

{
  "type": "memory",
  "id": "<string>",
  "memory_store_id": "<string>",
  "path": "<string>",
  "content_size_bytes": 123,
  "content_sha256": "<string>",
  "memory_version_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "content": "<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_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

请求体

application/json

更新记忆的请求参数。必须至少提供 content 或 path 之一。重命名到被另一个记忆占用的路径会返回 memory_path_conflict_error（HTTP 409）。重命名从不覆盖；请先删除或重命名占位记忆。如果所提供的所有字段都已与存储值一致，则该更新为无操作：返回 200 和现有记忆，且不写入新版本。

content

string | null

记忆的新 UTF-8 文本内容。最大 100 kB（102,400 字节）。省略则保持内容不变（例如仅重命名的更新）。

path

string | null

记忆的新路径（重命名）。必须以 / 开头，至少包含一个非空片段，且不超过 1,024 字节。不得包含空片段、. 或 .. 片段、控制字符或格式字符，且必须为 NFC 规范化。路径区分大小写。重命名后记忆的 id 保持不变。省略则路径不变。

Required string length: 2 - 1024

precondition

object

可选的乐观并发前置条件。提供时，仅当该记忆的当前状态匹配时才应用更新；不匹配时请求返回 memory_precondition_failed_error（HTTP 409）。省略时，更新无条件应用。

Show child attributes

响应

请求成功。

memory 对象：记忆存储中位于层级路径上的单个文本文档。view=full 时填充 content 字段，view=basic 时为 null；content_size_bytes 和 content_sha256 字段始终填充，以便同步客户端无需拉取内容即可比对差异。记忆以其 mem_... ID 寻址；路径是创建时的键，可通过更新修改。

type

enum<string>

必填

可用选项:

memory

string

必填

此记忆的唯一标识符（mem_... 格式的值）。重命名后保持不变；读取、更新或删除该记忆时应使用此 ID 而非路径。

memory_store_id

string

必填

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

path

string

必填

该记忆在存储内的层级路径，例如 /projects/foo/notes.md。始终以 / 开头。路径区分大小写，且在同一存储内唯一。最大 1,024 字节。

content_size_bytes

integer<int32>

必填

content 的字节大小（UTF-8 明文长度）。无论 view 为何值，始终填充。

content_sha256

string

必填

UTF-8 content 字节的小写十六进制 SHA-256 摘要（64 个字符）。服务端不做任何规范化处理，因此客户端可在本地计算相同的哈希，用于过期检查，并作为更新时 content_sha256 前置条件的值。无论 view 如何，此字段始终填充。

memory_version_id

string

必填

表示此记忆当前内容的 memory_version 的 ID（memver_... 值）。这是权威的头部指针；memory_version 对象不携带 is_latest 标志，因此请改为与此字段比较。可通过列出记忆版本枚举完整历史。

created_at

string<date-time>

必填

此记忆的创建时间，采用 RFC 3339 格式。

updated_at

string<date-time>

必填

该记忆最近一次修改的时间，采用 RFC 3339 格式。可将其用作低成本的时效性信号；如需了解是谁做出的修改，请通过列出记忆版本查询 head 版本的 created_by。

content

string | null

记忆的 UTF-8 文本内容。view=full 时填充；view=basic 时为 null。最大 100 kB（102,400 字节）。

更新记忆

curl --request POST \
  --url http://localhost:38080/v1/memory_stores/{memory_store_id}/memories/{memory_id} \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '{}'

import requests

url = "http://localhost:38080/v1/memory_stores/{memory_store_id}/memories/{memory_id}"

payload = {}
headers = {
    "X-Api-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

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

package main

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

func main() {

	url := "http://localhost:38080/v1/memory_stores/{memory_store_id}/memories/{memory_id}"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Api-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

{
  "type": "memory",
  "id": "<string>",
  "memory_store_id": "<string>",
  "path": "<string>",
  "content_size_bytes": 123,
  "content_sha256": "<string>",
  "memory_version_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "content": "<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

授权

请求头

路径参数

查询参数

请求体

响应