AS AgentScopeAPI 手册 / API Reference

HandsMetrics

@Component public class HandsMetrics
源码Source io/agentscope/builder/web/managed/service/HandsMetrics.java:29–80

Hands 指标,承载智能体的部署、调度与服务化运行。位于 io.agentscope.builder.web.managed.service 包。核心成员包括 recordAcquire、recordRelease、recordTimeout、snapshot、snapshotAll。

Per-session hands-lease counters: acquires, releases, and acquire timeouts. Phase D observability for HandsLeaseService — read by DeploymentService / the deployment status endpoint to surface self_hosted hands health without wiring a full metrics backend.

嵌套类摘要Nested Class Summary

类Class类型Kind说明Description
Snapshot记录record
承载快照数据的记录类型。
Immutable snapshot of one session's counters.

方法摘要Method Summary

方法Method说明Description
public void recordAcquire(String sessionId)
设置该参数。
Performs the record acquire operation.
public void recordRelease(String sessionId)
设置该参数。
Performs the record release operation.
public void recordTimeout(String sessionId)
设置该参数。
Performs the record timeout operation.
public Snapshot snapshot(String sessionId)
设置快照。
Returns the current counters for one session (all zero if never recorded).
public Map<String, Snapshot> snapshotAll()
返回快照所有。
Returns every session with at least one recorded event, keyed by sessionId.

方法详情Method Detail

recordAcquire

public void recordAcquire(String sessionId)

设置该参数。

Performs the record acquire operation.

参数Parameters
名称Name类型Type说明Description
sessionIdString会话标识(类型 `String`)。The session id.
源码Source io/agentscope/builder/web/managed/service/HandsMetrics.java:39–41

recordRelease

public void recordRelease(String sessionId)

设置该参数。

Performs the record release operation.

参数Parameters
名称Name类型Type说明Description
sessionIdString会话标识(类型 `String`)。The session id.
源码Source io/agentscope/builder/web/managed/service/HandsMetrics.java:43–45

recordTimeout

public void recordTimeout(String sessionId)

设置该参数。

Performs the record timeout operation.

参数Parameters
名称Name类型Type说明Description
sessionIdString会话标识(类型 `String`)。The session id.
源码Source io/agentscope/builder/web/managed/service/HandsMetrics.java:47–49

snapshot

public Snapshot snapshot(String sessionId)

设置快照。

Returns the current counters for one session (all zero if never recorded).

参数Parameters
名称Name类型Type说明Description
sessionIdString会话标识(类型 `String`)。The session id.
返回Returns Snapshot
返回快照。Returns snapshot.
源码Source io/agentscope/builder/web/managed/service/HandsMetrics.java:52–55

snapshotAll

public Map<String, Snapshot> snapshotAll()

返回快照所有。

Returns every session with at least one recorded event, keyed by sessionId.

返回Returns Map<String, Snapshot>
返回映射。Returns map.
源码Source io/agentscope/builder/web/managed/service/HandsMetrics.java:58–70

嵌套类详情Nested Class Detail

Snapshot

public record Snapshot(long acquires, long releases, long timeouts)

承载快照数据的记录类型。位于 io.agentscope.builder.web.managed.service 包。核心成员包括 acquires、releases、timeouts。

Immutable snapshot of one session's counters.

基于官方固定版本源码静态生成Generated from pinned official sources · Python 2.0.11 · Java 2.0.4
签名与文档为静态抽取;如有疑问请以源码为准。Signatures and docs are extracted statically; verify against the source when in doubt.