Skip to main content
创建绑定智能体的会话,agent_id 和 agent(id 或名称)二选一。之后向会话投递事件就能运行轮次。

接口

认证

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

请求体

string
智能体 id(优先)。agent_id 和 agent 必须给一个。
string
智能体 id 或名称(没传 agent_id 时的回退)。
string
附加在智能体指令之后的会话级指令。

响应

string
会话 id(sess_<hex>)。
string
恒为 agent.session。
object
绑定智能体的快照(id,可选 name / instructions / model,以及 reasoning、multi_agent、service_tier)。
string
会话级指令(若已设置)。
string
初始为 idle。
integer
纪元毫秒。

示例