Skip to main content
POST
创建会话

请求头

Idempotency-Key
string

可选的幂等键。相同的键与请求体会在 24 小时内重放首个响应;以不同的请求体复用,或在首个请求仍在处理时复用,返回 409。

请求体

application/json

创建会话的请求体。仅 agent_idenvironment_id 必填。

agent_id
string
必填

要运行的智能体。

Pattern: ^agent_[0-9a-hjkmnp-tv-z]{26}$
environment_id
string
必填

会话使用的环境。其最新构建就绪的版本会在会话的整个生命周期内固定。环境必须可见、活跃且具有构建就绪的版本。

Maximum string length: 128
Pattern: ^env_[0-9a-hjkmnp-tv-z]{26}$
agent_version
string

可选的精确智能体版本("1""2"……)。默认为创建时的最新版本。

Maximum string length: 128
title
string

可选的人类可读标题。

Maximum string length: 256
metadata
object

用户自定义元数据(最多 16 条)。

resources
(文件 · object | 凭据库 · object | 记忆库 · object)[]

创建时要绑定的资源:文件、凭据库(Vault)和记忆库。每个会话最多包含 16 个凭据库和 8 个记忆库,它们的绑定在创建后不能再添加或替换。

作为资源绑定到会话的文件。

agent_overrides
object

自创建起生效的会话级智能体配置覆盖。

响应

已创建的会话(idle),携带其资源绑定与智能体快照。

带版本智能体配置的一个运行实例。

id
string
必填

会话 ID。

Pattern: ^sesn_[0-9a-hjkmnp-tv-z]{26}$
agent_id
string
必填

此会话运行的智能体。

Pattern: ^agent_[0-9a-hjkmnp-tv-z]{26}$
environment_id
string
必填

托管此会话的环境。

Pattern: ^env_[0-9a-hjkmnp-tv-z]{26}$
status
enum<string>
必填

当前生命周期状态。

可用选项:
idle,
running,
terminated
created_at
string<date-time>
必填

创建时间戳。

updated_at
string<date-time>
必填

最后更新时间戳。

title
string

人类可读的标题。

metadata
object

用户自定义元数据(最多 16 条)。

agent_overrides
object

会话级智能体配置覆盖。未存储任何覆盖时不存在。

archived_at
string<date-time>

归档时间戳。活跃期间不存在。

resources
(文件 · object | 凭据库 · object | 记忆库 · object)[]

绑定到此会话的资源。在 GET /v1/sessions 的列表项中省略。

作为资源绑定到会话的文件。

agent
object

协调者线程使用的智能体版本快照。