yun

按完整路径读取一份场景记忆 Markdown 文件全文。传入目标路径，系统返回该场景记忆的原文与时间戳。

按目录前缀列出场景记忆的目录树。通过 path_prefix 指定列举范围，系统一次性返回该范围内的全部节点。

实例模板用于将一套实例配置（Skill + SOUL）保存为快照，用户端创建实例时可直接选用模板，实现标准化创建。这里说明如何新建、编辑和删除实例模板。

按条件分页查询原子记忆。传入分页参数与筛选参数，即可一次返回命中条件的原子记忆列表与命中总数。

这篇说说腾讯云原子记忆按主键批量删除接口，支持通过ids数组精确删除指定记忆，单次最多100条，空数组或超量返回400错误。 删除流程：先通过query_atomic获取目标id，再调用delete_atomic执行删除。 安全机制：空ids视为非法请求，不属于当前上下文的id静默跳过。

这篇说说腾讯云场景记忆删除接口 rm_scenario，通过 path 参数指定完整路径，可删除文件或递归删除目录，路径不存在时返回404错误码，成功返回删除节点数与追踪ID。 删除规则：路径末尾带 / 则递归删除整个目录，不带 / 仅删除单文件，属高危操作需谨慎。 请求与返回：POST /v2/scenario/rm，返回 path、deleted_count 和 trace_id 字段。

写入或全量覆盖 Agent 核心记忆。核心记忆是 Agent 维度的单体快照，路径由系统固定，本接口同时承担”写入即创建”与”全量覆盖更新”两种语义。

本接口（/atom/search）用于在原子记忆中做语义检索。传入检索文本，并按需附加预过滤条件，即可拿到按相关度排序的 Top-K 命中结果。

在原始对话消息中做语义检索。传入检索文本，并按需附加预过滤条件，即可拿到按相关度排序的 Top-K 命中结果。

本接口（/conversation/query）用于按条件分页查询原始对话消息。在请求体顶层平铺分页参数与筛选参数，即可一次返回命中条件的消息列表与命中总数。