追加会话消息

向会话中追加一条消息

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

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

所需权限： project:conv_append

路径参数

conversationId · string · required

会话标识符

请求体

content · 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" }

actor_id · string · required

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

timestamp · string

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

metadata · object

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

custom_id · string · required

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

parent_message_id · string

父消息的 ID，用于线程化会话。设置后，此消息将被视为对指定父消息的回复。

Text message

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?"
      }
    ],
    "actor_id": "actor_user_jane",
    "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"
      }
    ],
    "actor_id": "actor_assistant_v2",
    "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."
      }
    ],
    "actor_id": "actor_user_jane",
    "parent_message_id": "msg_9e4b2c3d5f6a7b8c"
  }'

响应

data · object

Show 消息对象

id · string

消息唯一标识符

content · array

组成消息体的内容块数组

Show 内容块

block_type · string

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

text · string

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

uri · string

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

mime_type · string

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

metadata · object

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

timestamp · string

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

conversation_id · string

此消息所属会话的 ID

sequence_no · integer

此消息在会话中的位置

actor_id · string

发送此消息的 Actor ID

actor_type · string

Actor 类型：HUMAN 或 ASSISTANT

created_at · string

创建时间戳

Success (200)

{
  "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": 3,
    "actor_id": "actor_user_jane",
    "created_at": "2025-06-01T14:10:05Z"
  }
}