类class io.agentscope.builder.web.managed.service 2.x

AgentVersionService

@Service @Transactional public class AgentVersionService

源码Source io/agentscope/builder/web/managed/service/AgentVersionService.java:37–255

智能体版本服务，承载智能体的部署、调度与服务化运行。位于 io.agentscope.builder.web.managed.service 包。核心成员包括 snapshotFromStoredEntry、snapshotFromEntity、toJson、fromJson、createInitialVersion、appendVersion。

Manages immutable version snapshots for user-custom agents.

字段摘要Field Summary

字段Field	类型Type	说明Description
`GLOBAL_OWNER` staticfinal	String	GLOBAL 所有者字段。 Synthetic owner id used to key version rows for global (project-level) agents, which have no `ownerId` of their own.

构造器摘要Constructor Summary

构造器Constructor	说明Description
`public` `AgentVersionService(AgentVersionEntityRepository versionRepository, AgentEntityRepository agentRepository)`	初始化 `AgentVersionService` 实例。 Creates a new instance.

方法摘要Method Summary

方法Method	说明Description
`public` `AgentVersionSnapshot snapshotFromStoredEntry(UserAgentDefinitionStore.StoredEntry entry)`	构建快照来自已存储目录条目。 Builds a snapshot from a stored catalog entry.
`public` `AgentVersionSnapshot snapshotFromEntity(AgentEntity entity)`	设置该参数。 Builds a snapshot from a persisted agent entity.
`public String toJson(AgentVersionSnapshot snapshot)`	设置到 JSON。 Serializes a snapshot to JSON.
`public` `AgentVersionSnapshot fromJson(String json)`	设置来自 JSON。 Deserializes a snapshot from JSON.
`public int createInitialVersion(String ownerId, String agentId,` `AgentVersionSnapshot snapshot)`	创建 `createInitialVersion`。 Creates version 1 for a newly created agent and bumps the head pointer.
`public int appendVersion(String ownerId, String agentId,` `AgentVersionSnapshot snapshot)`	追加版本。 Appends a new version when the snapshot changed.
`public int ensureGlobalVersion(String agentId,` `AgentVersionSnapshot snapshot)`	执行 `ensureGlobalVersion` 方法。 Ensures a global agent has a version row.
`public List<AgentVersionEntity> listVersions(String ownerId, String agentId)`	列出 `listVersions`。 Lists all versions for an agent in ascending order.
`public` `AgentVersionEntity getVersion(String ownerId, String agentId, int version)`	获取版本。 Returns a specific version snapshot row.

字段详情Field Detail

GLOBAL_OWNER

public static final String GLOBAL_OWNER

staticfinal

GLOBAL 所有者字段。声明为 public static final String GLOBAL_OWNER。

Synthetic owner id used to key version rows for global (project-level) agents, which have no ownerId of their own.

源码Source io/agentscope/builder/web/managed/service/AgentVersionService.java:46

构造器详情Constructor Detail

AgentVersionService

public AgentVersionService(AgentVersionEntityRepository versionRepository, AgentEntityRepository agentRepository)

初始化 AgentVersionService 实例。

Creates a new instance.

参数Parameters

名称Name	类型Type	说明Description
`versionRepository`	AgentVersionEntityRepository	版本仓库（类型 `AgentVersionEntityRepository`）。The version repository.
`agentRepository`	AgentEntityRepository	智能体仓库（类型 `AgentEntityRepository`）。The agent repository.

源码Source io/agentscope/builder/web/managed/service/AgentVersionService.java:56–60

方法详情Method Detail

snapshotFromStoredEntry

public AgentVersionSnapshot snapshotFromStoredEntry(UserAgentDefinitionStore.StoredEntry entry)

构建快照来自已存储目录条目。

Builds a snapshot from a stored catalog entry.

参数Parameters

名称Name	类型Type	说明Description
`entry`	UserAgentDefinitionStore.StoredEntry	条目（类型 `UserAgentDefinitionStore.StoredEntry`）。The entry.

返回Returns AgentVersionSnapshot

返回AgentVersionSnapshot。Returns agent version snapshot.

源码Source io/agentscope/builder/web/managed/service/AgentVersionService.java:63–82

snapshotFromEntity

public AgentVersionSnapshot snapshotFromEntity(AgentEntity entity)

设置该参数。

Builds a snapshot from a persisted agent entity.

参数Parameters

名称Name	类型Type	说明Description
`entity`	AgentEntity	entity（类型 `AgentEntity`）。The entity.

返回Returns AgentVersionSnapshot

返回AgentVersionSnapshot。Returns agent version snapshot.

源码Source io/agentscope/builder/web/managed/service/AgentVersionService.java:86–104

toJson

public String toJson(AgentVersionSnapshot snapshot)

设置到 JSON。

Serializes a snapshot to JSON.

参数Parameters

名称Name	类型Type	说明Description
`snapshot`	AgentVersionSnapshot	快照（类型 `AgentVersionSnapshot`）。The snapshot.

返回Returns String

返回字符串结果。Returns a string.

源码Source io/agentscope/builder/web/managed/service/AgentVersionService.java:107–114

fromJson

public AgentVersionSnapshot fromJson(String json)

设置来自 JSON。

Deserializes a snapshot from JSON.

参数Parameters

名称Name	类型Type	说明Description
`json`	String	JSON（类型 `String`）。The json.

返回Returns AgentVersionSnapshot

返回AgentVersionSnapshot。Returns agent version snapshot.

源码Source io/agentscope/builder/web/managed/service/AgentVersionService.java:117–123

createInitialVersion

public int createInitialVersion(String ownerId, String agentId, AgentVersionSnapshot snapshot)

创建 createInitialVersion。

Creates version 1 for a newly created agent and bumps the head pointer.

参数Parameters

名称Name	类型Type	说明Description
`ownerId`	String	所有者标识（类型 `String`）。The owner id.
`agentId`	String	智能体标识（类型 `String`）。The agent id.
`snapshot`	AgentVersionSnapshot	快照（类型 `AgentVersionSnapshot`）。The snapshot.

返回Returns int

返回数值结果。Returns a numeric result.

源码Source io/agentscope/builder/web/managed/service/AgentVersionService.java:126–146

appendVersion

public int appendVersion(String ownerId, String agentId, AgentVersionSnapshot snapshot)

追加版本。

Appends a new version when the snapshot changed.

参数Parameters

名称Name	类型Type	说明Description
`ownerId`	String	所有者标识（类型 `String`）。The owner id.
`agentId`	String	智能体标识（类型 `String`）。The agent id.
`snapshot`	AgentVersionSnapshot	快照（类型 `AgentVersionSnapshot`）。The snapshot.

返回Returns int

返回数值结果。Returns a numeric result.

源码Source io/agentscope/builder/web/managed/service/AgentVersionService.java:152–180

ensureGlobalVersion

public int ensureGlobalVersion(String agentId, AgentVersionSnapshot snapshot)

执行 ensureGlobalVersion 方法。

Ensures a global agent has a version row.

参数Parameters

名称Name	类型Type	说明Description
`agentId`	String	智能体标识（类型 `String`）。The agent id.
`snapshot`	AgentVersionSnapshot	快照（类型 `AgentVersionSnapshot`）。The snapshot.

返回Returns int

返回数值结果。Returns a numeric result.

源码Source io/agentscope/builder/web/managed/service/AgentVersionService.java:187–214

listVersions

public List<AgentVersionEntity> listVersions(String ownerId, String agentId)

列出 listVersions。

Lists all versions for an agent in ascending order.

参数Parameters

名称Name	类型Type	说明Description
`ownerId`	String	所有者标识（类型 `String`）。The owner id.
`agentId`	String	智能体标识（类型 `String`）。The agent id.

返回Returns List<AgentVersionEntity>

返回列出。Returns list.

源码Source io/agentscope/builder/web/managed/service/AgentVersionService.java:217–220

getVersion

public AgentVersionEntity getVersion(String ownerId, String agentId, int version)

获取版本。

Returns a specific version snapshot row.

参数Parameters

名称Name	类型Type	说明Description
`ownerId`	String	所有者标识（类型 `String`）。The owner id.
`agentId`	String	智能体标识（类型 `String`）。The agent id.
`version`	int	版本（类型 `int`）。The version.

返回Returns AgentVersionEntity

返回AgentVersionEntity。Returns agent version entity.

源码Source io/agentscope/builder/web/managed/service/AgentVersionService.java:223–232