类class io.agentscope.builder.web.catalog 2.x

HarnessAgentBuildService

@Service public class HarnessAgentBuildService

源码Source io/agentscope/builder/web/catalog/HarnessAgentBuildService.java:83–771

Harness 智能体构建服务，承载智能体的部署、调度与服务化运行。位于 io.agentscope.builder.web.catalog 包。核心成员包括 setManagedEventLog、getOrBuildAgent、evict、close、discardSession、resolveAgentWorkspace。

Data-plane agent factory: instantiates (and caches) HarnessAgent instances for managed sessions.

Managed session turns build exclusively from the control-plane (aistiod) session resolve payload — agentSnapshot, workspacePath, and definitionFiles. There is no JPA catalog fallback; resolve must succeed with a non-empty snapshot.

Namespace rules

Build owner (definition-store / memory / vault / resource mounts): the agent owner for user-custom agents; the session owner for global agents, mirroring the control-plane per-user overlay write path.

Built agents, mutable workspaces, and staged definitions are isolated per session. Task attempts additionally fence cached credentials by attempt and generation.

构造器摘要Constructor Summary

构造器Constructor 说明Description

构造器Constructor	说明Description
`public` `HarnessAgentBuildService(Optional<Model> modelOpt, ToolEventBus toolEventBus, SharedWorkspacePaths sharedWorkspacePaths, EnvironmentSpecFactory environmentSpecFactory, ToolConfirmationMiddleware toolConfirmationMiddleware, MemoryMountService memoryMountService, VaultCredentialResolver vaultCredentialResolver, AgentStateStore agentStateStore, SessionResourceMountService sessionResourceMountService, DefinitionStore definitionStore, ControlPlaneClient controlPlaneClient)`	初始化 `HarnessAgentBuildService` 实例。 Creates a new instance.

public

HarnessAgentBuildService(Optional<Model> modelOpt, ToolEventBus toolEventBus, SharedWorkspacePaths sharedWorkspacePaths, EnvironmentSpecFactory environmentSpecFactory, ToolConfirmationMiddleware toolConfirmationMiddleware, MemoryMountService memoryMountService, VaultCredentialResolver vaultCredentialResolver, AgentStateStore agentStateStore, SessionResourceMountService sessionResourceMountService, DefinitionStore definitionStore, ControlPlaneClient controlPlaneClient)

初始化 `HarnessAgentBuildService` 实例。

Creates a new instance.

方法摘要Method Summary

方法Method	说明Description
`public void setManagedEventLog(io.agentscope.builder.web.managed.service.SessionEventLog eventLog)`	设置托管事件日志。 Sets the managed event log.
`public` `HarnessAgent getOrBuildAgent(ManagedSessionDto session, SessionAgentBuildSpec spec)`	获取或构建智能体。 Resolves (and caches) the `HarnessAgent` for a managed-session turn.
`public void evict(String sessionOwnerId, String agentId)`	执行 `evict` 方法。 Evicts all cached instance variants for a session-owner/agent pair.
`public void close()`	关闭连接并释放相关资源。 Releases resources and connections.
`public void discardSession(String ownerId, String sessionId)`	执行 `discardSession` 方法。 Drops persisted state and releases the deleted session's cached runtime resources.
`public Path resolveAgentWorkspace(String agentOwnerId, String agentId)`	用于定义管理的工作区路径。 Workspace path for definition management.
`public Path resolveSessionWorkspace(ManagedSessionDto session, SessionResolveResult resolved)`	解析会话工作区。 Session-private staging root shared by Brain construction and Worker skill delivery.

构造器详情Constructor Detail

HarnessAgentBuildService

public HarnessAgentBuildService(Optional<Model> modelOpt, ToolEventBus toolEventBus, SharedWorkspacePaths sharedWorkspacePaths, EnvironmentSpecFactory environmentSpecFactory, ToolConfirmationMiddleware toolConfirmationMiddleware, MemoryMountService memoryMountService, VaultCredentialResolver vaultCredentialResolver, AgentStateStore agentStateStore, SessionResourceMountService sessionResourceMountService, DefinitionStore definitionStore, ControlPlaneClient controlPlaneClient)

初始化 HarnessAgentBuildService 实例。

Creates a new instance.

参数Parameters

名称Name	类型Type	说明Description
`modelOpt`	Optional<Model>	模型 Opt（类型 `Optional`）。The model opt.
`toolEventBus`	ToolEventBus	工具事件总线（类型 `ToolEventBus`）。The tool event bus.
`sharedWorkspacePaths`	SharedWorkspacePaths	共享工作区 Paths（类型 `SharedWorkspacePaths`）。The shared workspace paths.
`environmentSpecFactory`	EnvironmentSpecFactory	环境规格工厂（类型 `EnvironmentSpecFactory`）。The environment spec factory.
`toolConfirmationMiddleware`	ToolConfirmationMiddleware	工具确认中间件（类型 `ToolConfirmationMiddleware`）。The tool confirmation middleware.
`memoryMountService`	MemoryMountService	记忆 Mount 服务（类型 `MemoryMountService`）。The memory mount service.
`vaultCredentialResolver`	VaultCredentialResolver	vault 凭证解析器（类型 `VaultCredentialResolver`）。The vault credential resolver.
`agentStateStore`	AgentStateStore	智能体状态存储（类型 `AgentStateStore`）。The agent state store.
`sessionResourceMountService`	SessionResourceMountService	会话资源 Mount 服务（类型 `SessionResourceMountService`）。The session resource mount service.
`definitionStore`	DefinitionStore	定义存储（类型 `DefinitionStore`）。The definition store.
`controlPlaneClient`	ControlPlaneClient	控制面客户端（类型 `ControlPlaneClient`）。The control plane client.

源码Source io/agentscope/builder/web/catalog/HarnessAgentBuildService.java:109–132

方法详情Method Detail

setManagedEventLog

public void setManagedEventLog(io.agentscope.builder.web.managed.service.SessionEventLog eventLog)

设置托管事件日志。

Sets the managed event log.

参数Parameters

名称Name	类型Type	说明Description
`eventLog`	io.agentscope.builder.web.managed.service.SessionEventLog	事件日志（类型 `io.agentscope.builder.web.managed.service.SessionEventLog`）。The event log.

源码Source io/agentscope/builder/web/catalog/HarnessAgentBuildService.java:138–142

getOrBuildAgent

public HarnessAgent getOrBuildAgent(ManagedSessionDto session, SessionAgentBuildSpec spec)

获取或构建智能体。

Resolves (and caches) the HarnessAgent for a managed-session turn.

参数Parameters

名称Name	类型Type	说明Description
`session`	ManagedSessionDto	会话（类型 `ManagedSessionDto`）。The session.
`spec`	SessionAgentBuildSpec	规格（类型 `SessionAgentBuildSpec`）。The spec.

返回Returns HarnessAgent

返回HarnessAgent。Returns harness agent.

源码Source io/agentscope/builder/web/catalog/HarnessAgentBuildService.java:145–153

evict

public void evict(String sessionOwnerId, String agentId)

执行 evict 方法。

Evicts all cached instance variants for a session-owner/agent pair.

参数Parameters

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

源码Source io/agentscope/builder/web/catalog/HarnessAgentBuildService.java:230–233

close

public void close()

关闭连接并释放相关资源。

Releases resources and connections.

源码Source io/agentscope/builder/web/catalog/HarnessAgentBuildService.java:251–254

discardSession

public void discardSession(String ownerId, String sessionId)

执行 discardSession 方法。

Drops persisted state and releases the deleted session's cached runtime resources.

参数Parameters

名称Name	类型Type	说明Description
`ownerId`	String	所有者标识（类型 `String`）。The owner id.
`sessionId`	String	会话标识（类型 `String`）。The session id.

源码Source io/agentscope/builder/web/catalog/HarnessAgentBuildService.java:259–273

resolveAgentWorkspace

public Path resolveAgentWorkspace(String agentOwnerId, String agentId)

用于定义管理的工作区路径。

Workspace path for definition management.

参数Parameters

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

返回Returns Path

返回路径。Returns path.

源码Source io/agentscope/builder/web/catalog/HarnessAgentBuildService.java:278–280

resolveSessionWorkspace

public Path resolveSessionWorkspace(ManagedSessionDto session, SessionResolveResult resolved)

解析会话工作区。

Session-private staging root shared by Brain construction and Worker skill delivery.

参数Parameters

名称Name	类型Type	说明Description
`session`	ManagedSessionDto	会话（类型 `ManagedSessionDto`）。The session.
`resolved`	SessionResolveResult	已解析（类型 `SessionResolveResult`）。The resolved.

返回Returns Path

返回路径。Returns path.

源码Source io/agentscope/builder/web/catalog/HarnessAgentBuildService.java:283–285