接口interface io.agentscope.builder.web.persistence.jpa 2.x

CoordHitlTicketEntityRepository

public interface CoordHitlTicketEntityRepository extends JpaRepository<CoordHitlTicketEntity, Long>

源码Source io/agentscope/builder/web/persistence/jpa/CoordHitlTicketEntityRepository.java:26–69

定义 Coord Hitl Ticket Entity 仓库契约的接口。位于 io.agentscope.builder.web.persistence.jpa 包，实现 JpaRepository<CoordHitlTicketEntity, Long>。核心成员包括 findBySessionIdAndToolUseIdAndAgentTaskIdIsNull、findBySessionIdAndToolUseIdOrderByCreatedAtDesc、findBySessionIdAndAttemptIdAndDispatchGenerationAndTurnIdAndToolUseId、findPersonalForUpdate、findManagedForUpdate、findByExpiresAtLessThanAndResolvedAllowIsNull。

An interface in io.agentscope.builder.web.persistence.jpa that defines the contract for components that persists and restores session and memory data across calls. Declared in io.agentscope.builder.web.persistence.jpa. Implements JpaRepository.

方法摘要Method Summary

方法Method	说明Description
`public Optional<CoordHitlTicketEntity> findBySessionIdAndToolUseIdAndAgentTaskIdIsNull(String sessionId, String toolUseId)`	查找 `findBySessionIdAndToolUseIdAndAgentTaskIdIsNull`。 Finds the by session id and tool use id and agent task id is null.
`public List<CoordHitlTicketEntity> findBySessionIdAndToolUseIdOrderByCreatedAtDesc(String sessionId, String toolUseId)`	查找 `findBySessionIdAndToolUseIdOrderByCreatedAtDesc`。 Finds the by session id and tool use id order by created at desc.
`public Optional<CoordHitlTicketEntity> findBySessionIdAndAttemptIdAndDispatchGenerationAndTurnIdAndToolUseId(String sessionId, String attemptId, long dispatchGeneration, String turnId, String toolUseId)`	查找 `findBySessionIdAndAttemptIdAndDispatchGenerationAndTurnIdAndToolUseId`。 Finds the by session id and attempt id and dispatch generation and turn id and tool use id.
`public Optional<CoordHitlTicketEntity> findPersonalForUpdate(String sessionId, String toolUseId)`	查找 `findPersonalForUpdate`。 Finds the personal for update.
`public Optional<CoordHitlTicketEntity> findManagedForUpdate(String sessionId, String attemptId, long dispatchGeneration, String turnId, String toolUseId)`	查找托管用于更新。 Finds the managed for update.
`public List<CoordHitlTicketEntity> findByExpiresAtLessThanAndResolvedAllowIsNull(long expiresAt)`	查找 `findByExpiresAtLessThanAndResolvedAllowIsNull`。 Finds the by expires at less than and resolved allow is null.
`public void deleteBySessionIdAndToolUseId(String sessionId, String toolUseId)`	删除通过会话标识和工具使用标识。 Deletes the by session id and tool use id.
`public void deleteBySessionId(String sessionId)`	删除通过会话标识。 Deletes the by session id.
`public long deleteByResolvedAllowIsNotNullAndExpiresAtLessThan(long expiresAt)`	删除 `deleteByResolvedAllowIsNotNullAndExpiresAtLessThan`。 Deletes the by resolved allow is not null and expires at less than.

方法详情Method Detail

findBySessionIdAndToolUseIdAndAgentTaskIdIsNull

public Optional<CoordHitlTicketEntity> findBySessionIdAndToolUseIdAndAgentTaskIdIsNull(String sessionId, String toolUseId)

查找 findBySessionIdAndToolUseIdAndAgentTaskIdIsNull。

Finds the by session id and tool use id and agent task id is null.

参数Parameters

名称Name	类型Type	说明Description
`sessionId`	String	会话标识（类型 `String`）。The session id.
`toolUseId`	String	工具使用标识（类型 `String`）。The tool use id.

返回Returns Optional<CoordHitlTicketEntity>

返回可选。Returns optional.

源码Source io/agentscope/builder/web/persistence/jpa/CoordHitlTicketEntityRepository.java:29–30

findBySessionIdAndToolUseIdOrderByCreatedAtDesc

public List<CoordHitlTicketEntity> findBySessionIdAndToolUseIdOrderByCreatedAtDesc(String sessionId, String toolUseId)

查找 findBySessionIdAndToolUseIdOrderByCreatedAtDesc。

Finds the by session id and tool use id order by created at desc.

参数Parameters

名称Name	类型Type	说明Description
`sessionId`	String	会话标识（类型 `String`）。The session id.
`toolUseId`	String	工具使用标识（类型 `String`）。The tool use id.

返回Returns List<CoordHitlTicketEntity>

返回列出。Returns list.

源码Source io/agentscope/builder/web/persistence/jpa/CoordHitlTicketEntityRepository.java:32–33

findBySessionIdAndAttemptIdAndDispatchGenerationAndTurnIdAndToolUseId

public Optional<CoordHitlTicketEntity> findBySessionIdAndAttemptIdAndDispatchGenerationAndTurnIdAndToolUseId(String sessionId, String attemptId, long dispatchGeneration, String turnId, String toolUseId)

查找 findBySessionIdAndAttemptIdAndDispatchGenerationAndTurnIdAndToolUseId。

Finds the by session id and attempt id and dispatch generation and turn id and tool use id.

参数Parameters

名称Name	类型Type	说明Description
`sessionId`	String	会话标识（类型 `String`）。The session id.
`attemptId`	String	尝试标识（类型 `String`）。The attempt id.
`dispatchGeneration`	long	dispatch Generation（类型 `long`）。The dispatch generation.
`turnId`	String	轮次标识（类型 `String`）。The turn id.
`toolUseId`	String	工具使用标识（类型 `String`）。The tool use id.

返回Returns Optional<CoordHitlTicketEntity>

返回可选。Returns optional.

源码Source io/agentscope/builder/web/persistence/jpa/CoordHitlTicketEntityRepository.java:35–41

findPersonalForUpdate

public Optional<CoordHitlTicketEntity> findPersonalForUpdate(String sessionId, String toolUseId)

查找 findPersonalForUpdate。

Finds the personal for update.

参数Parameters

名称Name	类型Type	说明Description
`sessionId`	String	会话标识（类型 `String`）。The session id.
`toolUseId`	String	工具使用标识（类型 `String`）。The tool use id.

返回Returns Optional<CoordHitlTicketEntity>

返回可选。Returns optional.

源码Source io/agentscope/builder/web/persistence/jpa/CoordHitlTicketEntityRepository.java:43–48

findManagedForUpdate

public Optional<CoordHitlTicketEntity> findManagedForUpdate(String sessionId, String attemptId, long dispatchGeneration, String turnId, String toolUseId)

查找托管用于更新。

Finds the managed for update.

参数Parameters

名称Name	类型Type	说明Description
`sessionId`	String	会话标识（类型 `String`）。The session id.
`attemptId`	String	尝试标识（类型 `String`）。The attempt id.
`dispatchGeneration`	long	dispatch Generation（类型 `long`）。The dispatch generation.
`turnId`	String	轮次标识（类型 `String`）。The turn id.
`toolUseId`	String	工具使用标识（类型 `String`）。The tool use id.

返回Returns Optional<CoordHitlTicketEntity>

返回可选。Returns optional.

源码Source io/agentscope/builder/web/persistence/jpa/CoordHitlTicketEntityRepository.java:50–60

findByExpiresAtLessThanAndResolvedAllowIsNull

public List<CoordHitlTicketEntity> findByExpiresAtLessThanAndResolvedAllowIsNull(long expiresAt)

查找 findByExpiresAtLessThanAndResolvedAllowIsNull。

Finds the by expires at less than and resolved allow is null.

参数Parameters

名称Name	类型Type	说明Description
`expiresAt`	long	过期 At（类型 `long`）。The expires at.

返回Returns List<CoordHitlTicketEntity>

返回列出。Returns list.

源码Source io/agentscope/builder/web/persistence/jpa/CoordHitlTicketEntityRepository.java:62

deleteBySessionIdAndToolUseId

public void deleteBySessionIdAndToolUseId(String sessionId, String toolUseId)

删除通过会话标识和工具使用标识。

Deletes the by session id and tool use id.

参数Parameters

名称Name	类型Type	说明Description
`sessionId`	String	会话标识（类型 `String`）。The session id.
`toolUseId`	String	工具使用标识（类型 `String`）。The tool use id.

源码Source io/agentscope/builder/web/persistence/jpa/CoordHitlTicketEntityRepository.java:64

deleteBySessionId

public void deleteBySessionId(String sessionId)

删除通过会话标识。

Deletes the by session id.

参数Parameters

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

源码Source io/agentscope/builder/web/persistence/jpa/CoordHitlTicketEntityRepository.java:66

deleteByResolvedAllowIsNotNullAndExpiresAtLessThan

public long deleteByResolvedAllowIsNotNullAndExpiresAtLessThan(long expiresAt)

删除 deleteByResolvedAllowIsNotNullAndExpiresAtLessThan。

Deletes the by resolved allow is not null and expires at less than.

参数Parameters

名称Name	类型Type	说明Description
`expiresAt`	long	过期 At（类型 `long`）。The expires at.

返回Returns long

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

源码Source io/agentscope/builder/web/persistence/jpa/CoordHitlTicketEntityRepository.java:68