使用Agent Memory服务

进入 Agent Memory 服务

1. 登录向量检索服务 Milvus 版控制台。

2. 在左侧导航栏选择AI 中心 > Agent Memory 服务。

3. 在Agent Memory 服务页面中，按需切换以下页签：

创建 Agent 身份

1. 在Agent 身份管理页签中，单击添加 Agent 身份。

2. 在弹出的面板中填写 Agent 信息。

   配置项	是否必填	说明
   Agent 名称	是	Agent 的显示名称。建议使用能够区分业务、环境或用途的名称，例如 Coding Agent、Review Agent。
   记忆提取语言	否	用于指定该 Agent 默认的记忆提取语言。当前支持中文和英文，默认显示为中文。
   描述	否	Agent 的用途说明，例如“负责代码编写和技术决策”。

3. 单击确认完成创建。

4. 创建成功后，在 Agent 身份列表中查看并记录以下信息：

   字段	说明
   Agent ID	Agent 的唯一标识，用于控制台识别 Agent 身份。Mem0 兼容协议接入时通常不需要显式传入。
   默认记忆空间	创建 Agent 时自动生成的默认记忆空间 ID，可作为 Mem0 兼容接口中的 app_id。
   关联记忆空间数	当前 Agent 关联的记忆空间数量。
   API Key	Agent 对应的调用凭证。列表中默认脱敏展示，可通过复制图标复制完整值。
   记忆提取语言	当前 Agent 使用的默认记忆提取语言。

管理 Agent 身份

在Agent 身份管理页签中，可以执行以下操作：

• 在搜索框中输入 Agent 名称或 Agent ID，快速定位目标 Agent。

• 单击刷新按钮，重新加载 Agent 身份列表。

• 单击 Agent ID、默认记忆空间或 API Key 后的复制图标，复制对应值。

• 在操作列单击删除，按控制台提示删除不再使用的 Agent 身份。

删除 Agent 身份前，请确认调用方已经停止使用对应 API Key，并评估默认记忆空间和历史记忆数据的影响。实际删除范围以控制台确认提示为准。

查看记忆空间

1. 在Agent Memory 服务页面切换到记忆空间页签。

2. 使用状态筛选器按启用中或已停用过滤记忆空间。

3. 在搜索框中输入记忆空间名称或 ID，定位目标记忆空间。

4. 在列表中查看记忆空间信息。

如需删除记忆空间，在操作列单击删除，并根据控制台提示完成确认。删除前请确认没有 Agent 或应用继续依赖该记忆空间。

创建接入点

1. 在Agent Memory 服务页面切换到接入点列表页签。

2. 单击创建接入点。

3. 在弹出的面板中填写接入点信息。

   配置项	是否必填	说明
   接入点名称	是	接入点名称，例如 prod-ap-01。建议体现环境、网络或业务用途。
   网络来源	是	选择公网或内网。公网适合从公网环境调用，内网适合同地域 VPC 或内部网络调用。

4. 单击确认创建接入点。

5. 创建完成后，等待接入点状态变为运行中。

6. 在接入点列表中复制接入点别名，作为应用侧访问地址。

管理接入点

在接入点列表页签中，可以执行以下操作：

• 在搜索框中输入接入点名称或 ID，快速定位接入点。

• 单击刷新按钮，重新加载接入点列表。

• 单击接入点别名后的复制图标，复制接入地址。

• 单击详情，查看接入点名称、网络来源等基础信息。

• 单击删除接入点，按控制台提示删除不再使用的接入点。

删除接入点会影响使用该地址访问 AMS 的应用。删除前请确认接入方已经切换到新的接入点或停止调用。

应用侧接入

应用接入 AMS 时，通常需要以下配置：

Agent 身份由 API Key 标识。控制台中的 Agent ID 用于管理和排查；应用按 Mem0 协议调用时，通常只需要传业务侧的 user_id 和 run_id。如需指定记忆空间，可传 app_id；不传时使用 API Key 绑定的默认记忆空间。

认证头支持以下两种格式：

Authorization: Token <api_key>
Authorization: Bearer <api_key>

使用建议

• 每个生产 Agent、环境或业务系统使用独立 Agent 身份和 API Key。

• API Key 应放入密钥管理系统，不要写入代码仓库、文档截图或日志。

• 需要隔离记忆数据时，使用不同记忆空间，并在请求中显式传入 app_id。

• 对话型应用建议保持稳定的 run_id，用于区分不同会话上下文。

• 接入公网地址前确认网络访问策略；内部系统优先使用内网接入点。

• 删除 Agent 身份、记忆空间或接入点前，先确认调用方依赖和数据影响。