Skip to main content
向会话推送用户输入并跑一轮。这是个阻塞式接口:先 recall,再 model、tools、persist,最后返回一个 turn 对象。

接口

认证

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

路径参数

string
required
会话标识符。

请求体

用 input 或 结构化 content 片段提供文本,输入为空返回 400。
string
纯文本用户输入(简写形式)。
array
OpenAI 形态片段,例如 [{"type":"input_text","text":"..."}]。
string
可选的类型标签,默认把请求体当成一条消息。

响应

返回 agent.session.turn 对象:
string
轮次 id(turn_<hex>)。
string
恒为 agent.session.turn。
string
父会话。
string
跑这一轮的智能体。
string
通常为 completed(或 failed / cancelled / in_progress)。
string
完成时的助手输出文本。
integer
纪元毫秒。
integer
完成时的纪元毫秒。