Session & Event

Send Event

Send a user message to a session

POST

/api/v1/agentstudio/sessions/{session_id}/events

cURL

curl --request POST \
  --url 'https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio/sessions/{session_id}/events' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "input": [
    {
      "role": "user",
      "type": "message",
      "content": [
        {
          "type": "text",
          "text": "分析 /mnt/session/uploads/sales.csv 中 Q3 的销售趋势"
        }
      ]
    }
  ]
}
'

{
  "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..."
}

Authorizations

string

header

required

DashScope API Key

Path Parameters

string

required

Body

application/json

required

事件数组（长度 1-50）。每个事件至少含 role 与 type

Required range:items: 1–50

发送用户消息，触发智能体进入 running。必填 content（数组）

Show child attributes

enum<string>

required

Available options:user

enum<string>

required

Available options:message

required

ContentBlock 数组

纯文本

Show child attributes

enum<string>

required

Available options:text

string

required

Response

200-application/json

object[]

已受理事件的回显数组，与请求 input 顺序对齐；回显仅表示入队成功，不代表已被处理或裁决已生效

Show child attributes

string

对象类型，固定为 message

string

服务端分配的消息 ID，格式 msg_<ULID>

string

服务端写入时间，ISO 8601

string

事件角色，回显请求中的 user

string

事件类型，回显请求中所发事件的 type（如发送 message 则回显 message，发送 tool_approval_response 则回显 tool_approval_response），并非固定为 message

string

写入状态，固定为 completed

object[]

ContentBlock 数组，结构同请求

string

本次请求的唯一标识

cURL

curl --request POST \
  --url 'https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio/sessions/{session_id}/events' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "input": [
    {
      "role": "user",
      "type": "message",
      "content": [
        {
          "type": "text",
          "text": "分析 /mnt/session/uploads/sales.csv 中 Q3 的销售趋势"
        }
      ]
    }
  ]
}
'

{
  "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..."
}