发送事件 API：POST /sessions/{session_id}/events-大模型服务平台百炼(Model Studio)-阿里云帮助中心

向会话写入事件：用户消息、中断、工具审批、回填函数结果、声明本轮成功标准。请求体顶层只有 input，为事件数组（长度 1-50）。

前提

已创建会话，详见创建 Session。

接口

POST /sessions/{session_id}/events

请求体顶层只有一个字段 input，为事件数组（长度 1-50）。每个事件至少含 role 与 type。

请求体结构

{
  "input": [
    { "role": "user", "type": "message", "content": [...] }
  ]
}

客户端事件类型

type	role	用途与关键字段
`message`	`user`	发送用户消息，触发智能体进入 `running`。必填 `content`（数组）

ContentBlock：消息内容

content 是 ContentBlock 数组。每个块按 type 区分，必须严格选其中一种载体。

type	互斥字段（三/二选一）	说明
`text`	`text`	纯文本
`data`	`data` （object）	结构化数据（JSON）。服务端状态事件也用此承载

示例：发送文本消息

Bash

curl -X POST "$AGENTSTUDIO_URL/sessions/sesn_01K8ZQX3/events" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": [
      {
        "role": "user",
        "type": "message",
        "content": [
          {"type": "text", "text": "分析 /mnt/session/uploads/sales.csv 中 Q3 的销售趋势"}
        ]
      }
    ]
  }'

Python

client.sessions.events.send(
    "sesn_01K8ZQX3",
    events=[user_message("分析 /mnt/session/uploads/sales.csv 中 Q3 的销售趋势")],
)

Java

client.sessions().events().send("sesn_01K8ZQX3",
    Collections.singletonList(
        ClientEvents.userMessage("分析 /mnt/session/uploads/sales.csv 中 Q3 的销售趋势")));

响应

200 OK 返回写入成功的事件回显与请求 ID：

{
  "data": [
    {
      "object": "message",
      "id": "msg_8f2a1c...",
      "created_at": "2025-10-24T08:15:30.123Z",
      "role": "user",
      "type": "message",
      "status": "completed",
      "content": [{"type": "text", "text": "..."}]
    }
  ],
  "request_id": "req_01K8ZQX..."
}

响应字段

字段	类型	说明
`data`	array<object>	写入成功的事件回显数组，与请求 `input` 顺序对齐
`data[].object`	string	对象类型，固定为 `message`
`data[].id`	string	服务端分配的消息 ID，格式 `msg_<ULID>`
`data[].created_at`	string	服务端写入时间，ISO 8601
`data[].role`	string	事件角色，回显请求中的 `user`
`data[].type`	string	事件类型，回显请求中的 `message`
`data[].content`	array<object>	ContentBlock 数组，结构同请求
`request_id`	string	本次请求的唯一标识