AutoTweaker API/io.github.autotweaker.api.adapter/CoreAPI/SessionAPI

SessionAPI

interface SessionAPI(source)

管理会话、Agent和工作区，AutoTweaker AI 功能的主要 API。

Properties

defaultWorkspaceId

abstract val defaultWorkspaceId: UUID

默认工作区的 id，永不变化。

Functions

abstract suspend fun create(model: ModelConfig): UUID

在默认工作区创建新会话。

abstract suspend fun create(workspaceId: UUID, model: ModelConfig): UUID

在指定工作区内创建新会话。

createWorkspace

abstract suspend fun createWorkspace(meta: WorkspaceMeta): WorkspaceData

创建一个新的工作区。

abstract suspend fun delete(sessionId: UUID): Boolean

删除一个会话，删除前会先 Stop 所有的 Agent。

deleteWorkspace

abstract suspend fun deleteWorkspace(id: UUID): Boolean

删除工作区，删除前会先遍历 delete 所有 session。

abstract suspend fun getHandle(sessionId: UUID): SessionHandle

获取会话的控制器。

getUsageSnapshots

abstract suspend fun getUsageSnapshots(): Map<UUID, UsageSnapshot>

获取历史的全部 Usage。

isContainerRunning

abstract fun isContainerRunning(): Boolean

容器的启停由 AutoTweaker 内部管理，按需自动启动，不需要在调用 api 前检查此值。

abstract suspend fun listWorkspaces(): List<WorkspaceData>

获取全部已有工作区的数据。

abstract suspend fun loadAgent(id: UUID): AgentData?

从数据库加载 agent 数据，找不到返回 null。

abstract suspend fun loadData(ids: List<UUID>): List<SessionData>

从数据库加载会话数据，找不到不会炸。

abstract suspend fun loadMessages(ids: List<UUID>): List<AgentMessage>

从数据库加载会话消息，请按需加载，找不到不会炸。

renameWorkspace

abstract suspend fun renameWorkspace(id: UUID, newName: String)

重命名一个工作区。

abstract suspend fun updateTitle(sessionId: UUID, title: String)

更新会话标题。