文档中心

记忆库 Mem0

异步任务

查询异步事件详情

GET https://<your_mem0_host>/v1/event/{event_id}/

用于查询异步任务的状态与结果。调用“添加记忆”接口时，若设置 async_mode=true，系统将返回任务 ID（event_id），本接口通过该 ID 追踪任务执行情况，返回结果包括原始输入、生成的记忆、耗时及错误信息（如有）。

说明

GET https://<your_mem0_host>/v1/event/{event_id}/ 与 GET https://<your_mem0_host>/v1/job/{job_id}/ 均可用于查询同一任务的状态。其中 /v1/job/ 为早期接口，推荐您优先使用 /v1/event/ 接口。两者的响应结构和字段不同，本文描述的响应结构仅适用于 /v1/event/ 。若您调用的是 /v1/job/ ，请以实际返回的数据结构为准。

鉴权

本接口采用 API Key 鉴权。具体操作，请参见请求说明 - 鉴权。

请求参数

Path 参数

event_id String 必选示例值：evt_abcdef1234567890

要查询的事件 ID，即异步调用时返回的 event_id。

返回参数

id String 示例值：evt_abcdef1234567890

事件 ID。

event_type String 示例值：add

事件类型。

status String 示例值：SUCCEEDED

事件处理状态，包括 PENDING、RUNNING、SUCCEEDED 和 FAILED。

payload Object

事件输入载荷。

messages Array[Message] 示例值：[{\"role\": \"user\", \"content\": \"我下周要去北京出差...\"}]

原始请求的输入内容。

user_id String 示例值：user-12345

原始请求的用户 ID。

metadata Object 示例值：{"source": "trip_planner_chat"}

原始请求的附加元数据。

results Array[String] 示例值：["用户计划下周去北京出差，需要推荐烤鸭店。"]

事件处理结果。

error String 示例值：null

事件处理失败时的错误信息。

latencyInteger 示例值：4000

事件处理耗时，单位为毫秒。任务处理中时，该字段可为 null。

created_at String 示例值：2026-01-07T10:00:00Z

事件创建时间，ISO 8601 格式。

updated_at String 示例值：2026-01-07T10:00:00Z

事件最后更新时间，ISO 8601 格式。

started_at String 示例值：2026-01-07T10:15:01Z

事件开始处理时间，ISO 8601 格式。

completed_at String 示例值：2026-01-07T10:15:01Z

事件完成时间，ISO 8601 格式。

events Array[Object]

任务关联的事件列表。

id String 示例值：evt_abcdef1234567890

事件 ID。

memory String 示例值：用户计划下周去北京出差，需要推荐烤鸭店。

记忆内容。

event String 示例值：ADD

记忆操作。

输入示例 1

输入示例

curl -X GET 'https://<your_mem0_host>/v1/event/evt_abcdef123456xxxx/' \
-H 'Authorization: Token YOUR_PERSONAL_API_KEY'

输出示例

{
  "id": "evt_abcdef123456xxxx",
  "event_type": "add",
  "status": "SUCCEEDED",
  "payload": {
    "messages": [
      {
        "role": "user",
        "content": "我下周要去北京出差..."
      }
    ],
    "user_id": "user-1xxxx",
    "async_mode": true
  },
  "metadata": {
    "source": "trip_planner_chat"
  },
  "results": [
    "用户计划下周去北京出差，需要推荐烤鸭店。"
  ],
  "created_at": "2026-01-07T10:15:00Z",
  "updated_at": "2026-01-07T10:15:05Z",
  "started_at": "2026-01-07T10:15:01Z",
  "completed_at": "2026-01-07T10:15:05Z",
  "latency": 4000,
  "error": null,
  "events": [
    {
      "id": "evt_abcdef123456xxxx",
      "memory": "用户计划下周去北京出差，需要推荐烤鸭店。",
      "event": "ADD"
    }
  ]
}

最近更新时间：2026.11.05 17:43:03

这个页面对您有帮助吗？

有用

无用