追加会话消息

POST /openapi/memorylake/api/v3/conversations/{conversationId}/messages

向会话中追加一条新消息。每条消息包含一个或多个内容块（文本、文件或两者兼有），并归属于一个 Actor。MemoryLake 会自动处理新消息以提取结构化事实。

所需权限： project:conv_append

路径参数

string

required

会话标识符

请求体

array

required

组成消息体的内容块数组。每个块必须包含 block_type 字段。可接受的 block_type 值：TEXT、FILE、IMAGE、THINKING、TOOL_USE、TOOL_RESULT。文本块： { "block_type": "TEXT", "text": "message content" }图片块： { "block_type": "IMAGE", "uri": "drive://...", "mime_type": "image/png" }

string

required

发送此消息的 Actor ID。应引用参与该会话的 Actor。

string

消息原始发生时间的 ISO 8601 时间戳。在导入历史会话时使用此字段，以便 MemoryLake 保留原始时间线。

object

附加到消息的任意键值元数据

string

required

调用方定义的消息在会话内的唯一标识符

string|null

required

本条消息在会话中的前驱消息 ID，也就是紧挨在它前面的那一条。它表达的是顺序，不是回复关系：即使本条并不是对上一条的回复，也要填上一条的 ID。顺序由调用方声明，服务端不会替你猜。会话的第一条消息没有前驱，填 null。之后的每一条都必须填一个真实的 ID —— 上一次追加返回的 id，或者续写已有会话时读到的 current_message_id。请求到达时，这个 ID 必须仍是会话的最新一条消息。如果不是（ID 已过期，或会话已有消息却填了 null），追加会失败并返回 409，且不写入任何内容。重新读取 current_message_id，用它重试。

curl -X POST 'https://app.memorylake.cn/openapi/memorylake/api/v3/conversations/conv_7d2e3f4a5b6c7d8e/messages' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "content": [
      {
        "block_type": "TEXT",
        "text": "Can you summarize last quarter'\''s revenue numbers?"
      }
    ],
    "custom_id": "msg-001",
    "actor_id": "actor_user_jane",
    "parent_message_id": null,
    "timestamp": "2025-06-01T14:10:00Z",
    "metadata": {
      "source": "web-app"
    }
  }'

curl -X POST 'https://app.memorylake.cn/openapi/memorylake/api/v3/conversations/conv_7d2e3f4a5b6c7d8e/messages' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "content": [
      {
        "block_type": "TEXT",
        "text": "Here is the chart for your review."
      },
      {
        "block_type": "IMAGE",
        "uri": "drive://items/item_abc123/chart.png",
        "mime_type": "image/png"
      }
    ],
    "custom_id": "msg-002",
    "actor_id": "actor_assistant_v2",
    "parent_message_id": "msg_3f4a5b6c7d8e9f0a",
    "timestamp": "2025-06-01T14:10:30Z"
  }'

curl -X POST 'https://app.memorylake.cn/openapi/memorylake/api/v3/conversations/conv_7d2e3f4a5b6c7d8e/messages' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "content": [
      {
        "block_type": "TEXT",
        "text": "Good point — I'\''ve updated the figures in the attached version."
      }
    ],
    "custom_id": "msg-003",
    "actor_id": "actor_user_jane",
    "parent_message_id": "msg_9e4b2c3d5f6a7b8c"
  }'

响应

object

Show 消息对象

string

消息唯一标识符

array

组成消息体的内容块数组

Show 内容块

string

块类型：TEXT、FILE、IMAGE、THINKING、TOOL_USE、TOOL_RESULT

string

文本内容（当 block_type 为 TEXT 时存在）

string

Drive 资源 URI（当 block_type 为 IMAGE 时存在）

string

图片 MIME 类型（当 block_type 为 IMAGE 时存在）

object

附加到消息的任意键值元数据

string

调用方提供的消息原始发生时间戳（ISO 8601）

string

此消息所属会话的 ID

integer

此消息在会话中的位置

string

发送此消息的 Actor ID

string

Actor 类型：HUMAN 或 ASSISTANT

string

创建时间戳

{
  "success": true,
  "data": {
    "id": "msg_3f4a5b6c7d8e9f0a",
    "content": [
      {
        "block_type": "TEXT",
        "text": "Can you summarize last quarter's revenue numbers?"
      }
    ],
    "metadata": {
      "source": "web-app"
    },
    "timestamp": "2025-06-01T14:10:00Z",
    "conversation_id": "conv_7d2e3f4a5b6c7d8e",
    "sequence_no": 1,
    "actor_id": "actor_user_jane",
    "created_at": "2025-06-01T14:10:05Z"
  }
}

MemoryLake API

管理 API

路径参数

请求体

响应

​路径参数

​请求体

​响应

路径参数

请求体

响应