更新时间：2026-11-03 GMT+08:00
上报记忆数据到AgentArts
什么是记忆
在智能体应用中，记忆（Memory）是支撑智能体实现上下文理解与持续交互能力的核心组件。AgentArts Memory是面向智能体场景的云上记忆服务，提供以下两类记忆能力：
- 短期会话记忆：存储当前会话中的即时上下文信息（如最近几轮对话内容），确保智能体在单次交互中保持上下文连贯。
- 长期记忆检索：跨会话持久化存储历史交互信息，支持基于语义检索的历史记忆召回，使智能体能够积累经验并实现个性化响应。
为什么要将记忆接入可观测
记忆模块作为智能体运行链路中的关键环节，其读写状态直接影响智能体的响应质量。然而在实际开发与运维中，记忆模块的运行往往处于“黑盒”状态，开发者常面临以下挑战：
| 挑战 | 说明 |
|---|---|
| 读写状态不可见 | 难以判断记忆是否成功写入、检索是否返回了预期结果。 |
| 异常定界困难 | 当智能体出现上下文丢失或逻辑跳跃时，难以判断是记忆检索失败、记忆写入异常，还是大模型理解偏差所致。 |
| 性能瓶颈模糊 | 无法量化记忆读写的耗时分布，难以判断记忆操作是否已成为整体响应的瓶颈。 |
通过将记忆接入AgentArts观测，可将记忆模块的运行过程透明化，实现记忆读写的全程可观测。
接入后能做什么
接入记忆探针后，AgentArts将读取并展示以下维度的观测数据：
调用链（Trace）
- 关键属性标注：接入记忆探针后将会生成一个Memory Span便于精准定位目标记录。
- 读写内容记录：记忆的输入消息与输出结果将会在智能体产生的Trace详情中展示，帮助您核查记忆写入与检索的内容是否正确。
- 会话级关联：记忆调用通过会话ID（gen_ai.conversation.id）与智能体整体调用链关联，您可在完整链路中查看记忆环节在整个推理过程中的位置与耗时占比。
指标（Metric）
- 长期/短期记忆调用次数：统计周期内长期记忆与短期记忆的调用总次数。
- 长期/短期记忆调用耗时：监测单次记忆调用的耗时分布，区分长期记忆与短期记忆的读写性能，帮助识别性能瓶颈。
- 长期/短期记忆调用成功率：统计周期内记忆调用的成功次数占比，用于检测记忆功能的运行稳定性。
接入方式概览
AgentArts提供Memory独立探针（Memory探针），基于OpenTelemetry标准实现自动化埋点，具备以下特点：
- 装即生效：通过monkey-patch机制自动埋点，无需修改Memory SDK源码或业务代码。
- 框架隔离：与LangChain、AgentScope等其他框架探针完全隔离，互不干扰。
- 灵活集成：既可独立观测记忆服务，也可与LangChain / LangGraph等框架探针同时加载，实现Agent + Memory的统一可观测，两者上报的数据通过会话ID自动关联至同一智能体会话。
