CreateMemory_大模型服务平台百炼_API文档-阿里云OpenAPI开发者门户

接口说明

您可以将对话过程中的特定信息（即记忆片段，详见长期记忆）存储到长期记忆体（Memory）中，智能体应用将在后续对话中持续引用这些信息（非自动，您需要先调用 CreateMemory 接口创建长期记忆体，获取memoryId。然后通过 API 调用智能体应用时，传入该memoryId）。
说明长期记忆体尚不支持存储与管理用户画像，请您通过控制台进行相关操作，详见长期记忆。
若传入memoryId，系统会根据对话记录，在指定长期记忆体下自动创建记忆片段（MemoryNode）。您也可以调用 CreateMemoryNode 接口手动创建记忆片段。
本接口不具备幂等性。

限流说明： 请确保两次请求间隔至少 1 秒，否则可能触发系统限流。如遇限流，请稍后重试。

当前云产品API请求速率暂未透出。

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

sfm:CreateMemory	Create	全部资源 *	无	无

POST /{workspaceId}/memories HTTP/1.1

字段名称	字段详情
workspaceIdstring	长期记忆体所属的业务空间 ID。获取方式请参见如何使用业务空间。示例值:llm-3z7uw7fwz0vexxxx

字段名称	字段详情
descriptionstring	长期记忆体的描述信息。长度为 1~50 个字符，支持 Unicode 中 letter 分类下的字符（其中包括英文、中文和数字等）。可以包含半角冒号（:）、下划线（_）、半角句号（.）或者短划线（-）。示例值:我的大模型应用$APP_ID关于A用户的长期记忆体

字段名称	字段详情
memoryIdstring	长期记忆体 ID。展开详情示例值:6bff4f317a14442fbc9f73d29dbxxxx
requestIdstring	请求 ID。示例值:17204B98-xxxx-4F9A--2446A84821CA

没有我想要的错误码, 点击反馈

HTTP 状态码	错误码	错误信息	操作

400	Memory.DescriptionInvalid	Input parameter description is invalid.	诊断
404	Memory.MemoryIdNotFound	Memory Id not exist or is not authorized.	诊断
500	Memory.InternalError	Memory service inner exception.	诊断

暂无变更历史