智能体是一份可复用的配置：模型、系统提示词、工具包、技能。每次更新自动递增版本号，会话创建时锁定当时版本。
版本机制
智能体使用 version 整数字段跟踪配置历史，行为如下：
-
更新接口采用全量替换语义，成功后
version自动 +1，请求体需带当前值用作乐观锁，不一致返回 409。 -
会话创建时锁定当时
version，已有会话不受后续更新影响；查询历史版本通过GET /agents/{agent_id}?version=N。 -
归档为软操作，
archived_at被填入归档时间；归档后不可用于新建会话，已有会话不受影响。
智能体操作
|
操作 |
端点 |
说明 |
|
|
创建智能体，初始 |
|
|
|
默认返回最新版本；带 |
|
|
|
分页列出工作空间下的智能体，默认不含已归档 |
|
|
|
全量替换；请求体需带 |
|
|
|
软归档；不可用于新建会话，已有会话不受影响 |
|
|
|
分页返回该智能体的全部历史版本 |
该文章对您有帮助吗？