流式智能体事件

curl -N -X POST https://agent.ariacompute.cn/v1/agents/sessions/sess_9f8e7d6c5b4a3210fedc/events/stream \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -d '{
    "input": "Explain quantum computing"
  }'

data: {"type":"agent.turn.created","session_id":"sess_9f8e7d6c5b4a3210fedc","turn_id":"turn_0abc...","turn":{"id":"turn_0abc...","status":"in_progress"}}

data: {"type":"agent.turn.output_text.delta","delta":"Quantum"}

data: {"type":"agent.turn.output_text.delta","delta":" computing"}

data: {"type":"agent.turn.completed","session_id":"sess_9f8e7d6c5b4a3210fedc","turn_id":"turn_0abc...","turn":{"id":"turn_0abc...","status":"completed","output":"Quantum computing..."}}

curl -N -X POST https://agent.ariacompute.cn/v1/agents/sessions/sess_9f8e7d6c5b4a3210fedc/events/stream \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -d '{
    "input": "Explain quantum computing"
  }'

data: {"type":"agent.turn.created","session_id":"sess_9f8e7d6c5b4a3210fedc","turn_id":"turn_0abc...","turn":{"id":"turn_0abc...","status":"in_progress"}}

data: {"type":"agent.turn.output_text.delta","delta":"Quantum"}

data: {"type":"agent.turn.output_text.delta","delta":" computing"}

data: {"type":"agent.turn.completed","session_id":"sess_9f8e7d6c5b4a3210fedc","turn_id":"turn_0abc...","turn":{"id":"turn_0abc...","status":"completed","output":"Quantum computing..."}}

请求体同创建事件，但响应是 text/event-stream。每条 SSE data: 行都是一个 OpenAI Agents 信封里的 JSON 帧（agent.turn.*）。没有 [DONE] 哨兵，流在 agent.turn.completed 或 agent.turn.failed 处结束。

接口

POST /v1/agents/sessions/{session_id}/events/stream

认证

Authorization: Bearer <api_key> 或 Authorization: ApiKey <key>。若未设置 AGENT_CLOUD_API_KEY，则可选。

路径参数

string

required

会话标识符。

请求体

同创建事件：input 和/或 content 片段，输入为空返回 400。

响应

text/event-stream JSON 帧，常见的 type 值有：

agent.turn.created
agent.turn.in_progress
agent.turn.item.added / agent.turn.item.done
agent.turn.output_text.delta
agent.turn.completed（终止）
agent.turn.failed（终止）

curl -N -X POST https://agent.ariacompute.cn/v1/agents/sessions/sess_9f8e7d6c5b4a3210fedc/events/stream \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -d '{
    "input": "Explain quantum computing"
  }'

data: {"type":"agent.turn.created","session_id":"sess_9f8e7d6c5b4a3210fedc","turn_id":"turn_0abc...","turn":{"id":"turn_0abc...","status":"in_progress"}}

data: {"type":"agent.turn.output_text.delta","delta":"Quantum"}

data: {"type":"agent.turn.output_text.delta","delta":" computing"}

data: {"type":"agent.turn.completed","session_id":"sess_9f8e7d6c5b4a3210fedc","turn_id":"turn_0abc...","turn":{"id":"turn_0abc...","status":"completed","output":"Quantum computing..."}}

PIN API

ROUTER API

AGENT API

MEMO API

接口

认证

路径参数

请求体

响应

​接口

​认证

​路径参数

​请求体

​响应

接口

认证

路径参数

请求体

响应