功能域Functional domain

状态·记忆·会话State, memory & sessions

AgentState、Memory、会话存储与各类数据库/缓存后端。生产环境中会话恢复、多租户隔离和并发控制都依赖这一层。Agent state, memory, session stores and database/cache backends for resumability, tenant isolation and concurrency control.

324类型总数types total

44Python

280Java

3学习锚点learning anchors

心智模型Mental model

状态与记忆层负责「一次会话内」的上下文管理和「跨会话」的长期记忆；存储适配器把状态落到内存、文件、Redis、数据库等后端。State and memory cover in-session context and cross-session long-term recall; storage adapters persist state to memory, files, Redis or databases.

先学什么What to learn first

先区分 AgentState（可恢复的运行状态）与 Memory（语义记忆）。Separate AgentState (recoverable runtime state) from Memory (semantic recall).
会话隔离以 user_id + session_id 为键，不要把两者混为一个字符串。Scope sessions by user_id plus session_id; do not collapse them into one string.
存储实现要支持并发写入与版本冲突处理。Storage implementations must handle concurrent writes and version conflicts.

生产常见坑Production pitfalls

把全量历史直接塞回上下文，成本和延迟失控。Replaying full history into context explodes cost and latency.
多个实例同时写同一会话，最后写入覆盖别人的状态。Concurrent writers to one session silently overwrite each other.

进入对应闯关单元Practice this domain →

域内图谱Domain map

点击节点打开 API 页面；拖拽平移，滚轮缩放。Click a node to open its API page. Drag to pan, scroll to zoom.

Python API 集Python API set 44

归入本功能域的全部 Python 公开类型，按所属包分组。Every public Python type classified into this domain, grouped by owning package.

agentscope.app.storage39

`AgentChatConfig`	class	智能体聊天配置，保存相关配置项。
`AgentData`	class	智能体数据模型。
`AgentRecord`	class	智能体 ORM 模型。
`AsyncSQLAlchemyStorage`	class	异步 SQLAlchemy 存储，负责持久化与读取数据。
`ChannelBinding`	class	渠道绑定，在多次调用之间保存和恢复会话与记忆数据。
`ChannelOrigin`	class	一种会话入站平台消息已打开。
`ChannelRecord`	class	渠道记录，在多次调用之间保存和恢复会话与记忆数据。
`ChatModelConfig`	class	模型配置类。
`ChunkerConfig`	class	切分器配置，保存相关配置项。
`CredentialRecord`	class	凭证记录，在多次调用之间保存和恢复会话与记忆数据。
`EmbeddingModelConfig`	class	向量化模型配置，保存相关配置项。
`InviteConfig`	class	邀请配置，保存相关配置项。
`KnowledgeBaseData`	class	可变负载的知识库基类类。
`KnowledgeBaseRecord`	class	知识库记录，在多次调用之间保存和恢复会话与记忆数据。
`KnowledgeDocumentData`	class	可变负载的知识库文档类。
`KnowledgeDocumentRecord`	class	知识库文档记录，在多次调用之间保存和恢复会话与记忆数据。
`MCPRecord`	class	MCP 记录，在多次调用之间保存和恢复会话与记忆数据。
`RealtimeModelConfig`	class	实时语音模型配置类。
`RedisStorage`	class	Redis 存储，负责持久化与读取数据。
`RedisStorage.KeyConfig`	class	键配置，保存相关配置项。
`RoutingConfig`	class	路由配置，保存相关配置项。
`ScheduleData`	class	调度配置数据。
`ScheduleOrigin`	class	调度来源，在多次调用之间保存和恢复会话与记忆数据。
`ScheduleRecord`	class	调度记录，在多次调用之间保存和恢复会话与记忆数据。
`ScheduleSource`	class	调度来源，在多次调用之间保存和恢复会话与记忆数据。
`SessionConfig`	class	会话配置，保存相关配置项。
`SessionKnowledgeConfig`	class	会话知识库配置，保存相关配置项。
`SessionNaming`	class	会话命名，在多次调用之间保存和恢复会话与记忆数据。
`SessionRecord`	class	会话类。
`SessionScope`	class	会话范围，在多次调用之间保存和恢复会话与记忆数据。
`SessionSettings`	class	会话设置，保存相关配置项。
`SessionSource`	class	会话来源，在多次调用之间保存和恢复会话与记忆数据。
`SkillRecord`	class	技能记录，在多次调用之间保存和恢复会话与记忆数据。
`SOPOrigin`	class	SOP 来源，在多次调用之间保存和恢复会话与记忆数据。
`StorageBase`	class	存储抽象基类类。
`TeamOrigin`	class	团队来源，在多次调用之间保存和恢复会话与记忆数据。
`TTSModelConfig`	class	TTS 模型配置类。
`UserOrigin`	class	用户来源，在多次调用之间保存和恢复会话与记忆数据。
`UserRecord`	class	用户类。

agentscope.state5

`AgentState`	class	会话状态
`ReplyContext`	class	当前智能体回复的上下文。
`Task`	class	智能体任务。
`TaskContext`	class	任务上下文。
`ToolContext`	class	工具上下文，在多次调用之间保存和恢复会话与记忆数据。

Java API 集Java API set 280

归入本功能域的全部 Java 公开类型，按包分组并标注构件。Every public Java type classified into this domain, grouped by package with its artifact.

io.agentscope.builder.web.persistence.jpa43

`AgentEntity`	class	`service-common`	智能体 Entity，在多次调用之间保存和恢复会话与记忆数据。
`AgentEntityRepository`	interface	`service-common`	定义智能体 Entity 仓库契约的接口。
`AgentShareEntity`	class	`service-common`	智能体 Share Entity，在多次调用之间保存和恢复会话与记忆数据。
`AgentStateEntity`	class	`service-common`	智能体状态 Entity，在多次调用之间保存和恢复会话与记忆数据。
`AgentStateEntityRepository`	interface	`service-common`	定义智能体状态 Entity 仓库契约的接口。
`AgentVersionEntity`	class	`service-common`	智能体版本 Entity，在多次调用之间保存和恢复会话与记忆数据。
`AgentVersionEntityRepository`	interface	`service-common`	定义智能体版本 Entity 仓库契约的接口。
`CoordHitlTicketEntity`	class	`service-common`	Coord Hitl Ticket Entity，在多次调用之间保存和恢复会话与记忆数据。
`CoordHitlTicketEntityRepository`	interface	`service-common`	定义 Coord Hitl Ticket Entity 仓库契约的接口。
`CoordLeaseEntity`	class	`service-common`	Coord Lease Entity，在多次调用之间保存和恢复会话与记忆数据。
`CoordLeaseEntityRepository`	interface	`service-common`	定义 Coord Lease Entity 仓库契约的接口。
`CoordWorkerHeartbeatEntity`	class	`service-common`	Coord 工作进程心跳 Entity，在多次调用之间保存和恢复会话与记忆数据。
`CoordWorkerHeartbeatEntityRepository`	interface	`service-common`	定义 Coord 工作进程心跳 Entity 仓库契约的接口。
`CoordWorkItemEntity`	class	`service-common`	Coord Work 条目 Entity，在多次调用之间保存和恢复会话与记忆数据。
`CoordWorkItemEntityRepository`	interface	`service-common`	定义 Coord Work 条目 Entity 仓库契约的接口。
`DeploymentEntity`	class	`service-common`	部署 Entity，在多次调用之间保存和恢复会话与记忆数据。
`DeploymentEntityRepository`	interface	`service-common`	定义部署 Entity 仓库契约的接口。
`EnvironmentEntity`	class	`service-common`	环境 Entity，在多次调用之间保存和恢复会话与记忆数据。
`EnvironmentEntityRepository`	interface	`service-common`	定义环境 Entity 仓库契约的接口。
`JpaAgentStateStore`	class	`service-common`	JPA 智能体状态存储，负责持久化与读取数据。
`JpaPersistenceConfig`	class	`service-common`	JPA 持久化配置，保存相关配置项。
`JpaUserAgentDefinitionStore`	class	`service-common`	JPA 用户智能体定义存储，负责持久化与读取数据。
`JpaUserStore`	class	`service-common`	JPA 用户存储，负责持久化与读取数据。
`ManagedSessionEntity`	class	`service-common`	托管会话 Entity，在多次调用之间保存和恢复会话与记忆数据。
`ManagedSessionEntityRepository`	interface	`service-common`	定义托管会话 Entity 仓库契约的接口。
`MemoryEntity`	class	`service-common`	记忆 Entity，在多次调用之间保存和恢复会话与记忆数据。
`MemoryEntityRepository`	interface	`service-common`	定义记忆 Entity 仓库契约的接口。
`MemoryStoreEntity`	class	`service-common`	记忆存储 Entity，在多次调用之间保存和恢复会话与记忆数据。
`MemoryStoreEntityRepository`	interface	`service-common`	定义记忆存储 Entity 仓库契约的接口。
`MemoryVersionEntity`	class	`service-common`	记忆版本 Entity，在多次调用之间保存和恢复会话与记忆数据。
`MemoryVersionEntityRepository`	interface	`service-common`	定义记忆版本 Entity 仓库契约的接口。
`ResourceShareEntity`	class	`service-common`	资源 Share Entity，在多次调用之间保存和恢复会话与记忆数据。
`ResourceShareEntityRepository`	interface	`service-common`	定义资源 Share Entity 仓库契约的接口。
`SessionEventEntity`	class	`service-common`	会话事件 Entity，在多次调用之间保存和恢复会话与记忆数据。
`SessionEventEntityRepository`	interface	`service-common`	定义会话事件 Entity 仓库契约的接口。
`UserEntity`	class	`service-common`	用户 Entity，在多次调用之间保存和恢复会话与记忆数据。
`UserEntityRepository`	interface	`service-common`	定义用户 Entity 仓库契约的接口。
`UserMarketplaceEntity`	class	`service-common`	用户市场 Entity，在多次调用之间保存和恢复会话与记忆数据。
`UserMarketplaceRepository`	interface	`service-common`	定义用户市场仓库契约的接口。
`VaultCredentialEntity`	class	`service-common`	Vault 凭证 Entity，在多次调用之间保存和恢复会话与记忆数据。
`VaultCredentialEntityRepository`	interface	`service-common`	定义 Vault 凭证 Entity 仓库契约的接口。
`VaultEntity`	class	`service-common`	Vault Entity，在多次调用之间保存和恢复会话与记忆数据。
`VaultEntityRepository`	interface	`service-common`	定义 Vault Entity 仓库契约的接口。

io.agentscope.harness.coding.session24

`AgentManagerConfig`	record	`agentscope-codingagent`	承载智能体管理器配置数据的记录类型。
`AnnounceDispatcher`	interface	`agentscope-codingagent`	定义 Announce 调度器契约的接口。
`CleanupPolicy`	enum	`agentscope-codingagent`	定义Cleanup 策略相关取值的枚举。
`CommandLane`	enum	`agentscope-codingagent`	定义命令 Lane相关取值的枚举。
`HistoryResult`	record	`agentscope-codingagent`	承载历史结果数据的记录类型。
`PendingCompletion`	record	`agentscope-codingagent`	承载待处理补全数据的记录类型。
`ResetMode`	enum	`agentscope-codingagent`	定义重置模式相关取值的枚举。
`RunRecord`	record	`agentscope-codingagent`	承载运行记录数据的记录类型。
`RunStatus`	enum	`agentscope-codingagent`	定义运行状态的枚举。
`SendResult`	record	`agentscope-codingagent`	承载发送结果数据的记录类型。
`SessionAgentManager`	class	`agentscope-codingagent`	会话智能体管理器，在多次调用之间保存和恢复会话与记忆数据。
`SessionConstants`	class	`agentscope-codingagent`	会话 Constants，在多次调用之间保存和恢复会话与记忆数据。
`SessionEntry`	record	`agentscope-codingagent`	承载会话条目数据的记录类型。
`SessionFreshness`	record	`agentscope-codingagent`	承载会话 Freshness数据的记录类型。
`SessionFreshnessEvaluator`	class	`agentscope-codingagent`	会话 Freshness 评估器，在多次调用之间保存和恢复会话与记忆数据。
`SessionKind`	enum	`agentscope-codingagent`	定义会话种类相关取值的枚举。
`SessionMaintenanceConfig`	record	`agentscope-codingagent`	用于会话存储维护的配置。
`SessionResetPolicy`	record	`agentscope-codingagent`	承载会话重置策略数据的记录类型。
`SessionStore`	class	`agentscope-codingagent`	会话存储，负责持久化与读取数据。
`SessionView`	record	`agentscope-codingagent`	承载会话 View数据的记录类型。
`SpawnInterceptor`	interface	`agentscope-codingagent`	定义 Spawn 拦截器契约的接口。
`SpawnResult`	record	`agentscope-codingagent`	承载 Spawn 结果数据的记录类型。
`StoredEntry`	record	`agentscope-codingagent`	承载已存储条目数据的记录类型。
`SubagentRunRegistry`	class	`agentscope-codingagent`	子智能体运行注册表，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.core.state22

`AgentState`	class	`agentscope-core`	会话状态
`AgentStateStore`	interface	`agentscope-core`	定义智能体状态存储契约的接口。
`Builder`	class	`agentscope-core`	构建器，用于构建并配置目标实例。
`Builder`	class	`agentscope-core`	构建器，用于构建并配置目标实例。
`Builder`	class	`agentscope-core`	构建器，用于构建并配置目标实例。
`ConcurrentSessionModificationException`	class	`agentscope-core`	Concurrent 会话 Modification 异常，表示执行过程中的错误。
`ConflictPolicy`	enum	`agentscope-core`	定义Conflict 策略相关取值的枚举。
`InMemoryAgentStateStore`	class	`agentscope-core`	In 记忆智能体状态存储，负责持久化与读取数据。
`JsonFileAgentStateStore`	class	`agentscope-core`	JSON 文件状态存储
`LegacyLoadResult`	record	`agentscope-core`	承载 Legacy 加载结果数据的记录类型。
`LegacyStateLoader`	class	`agentscope-core`	Legacy 状态加载器，在多次调用之间保存和恢复会话与记忆数据。
`ListHashUtil`	class	`agentscope-core`	列表 Hash Util，在多次调用之间保存和恢复会话与记忆数据。
`PlanModeContextState`	class	`agentscope-core`	计划模式上下文状态，在多次调用之间保存和恢复会话与记忆数据。
`ReadCacheEntry`	record	`agentscope-core`	承载读取缓存条目数据的记录类型。
`SessionInfo`	class	`agentscope-core`	会话信息，在多次调用之间保存和恢复会话与记忆数据。
`SpawnEntry`	record	`agentscope-core`	承载 Spawn 条目数据的记录类型。
`State`	interface	`agentscope-core`	定义状态契约的接口。
`State`	enum	`agentscope-core`	用于`#state`的已允许值。
`Task`	class	`agentscope-core`	任务，在多次调用之间保存和恢复会话与记忆数据。
`TaskContextState`	class	`agentscope-core`	任务上下文状态，在多次调用之间保存和恢复会话与记忆数据。
`ToolContextState`	class	`agentscope-core`	工具上下文状态，在多次调用之间保存和恢复会话与记忆数据。
`VersionedState`	record	`agentscope-core`	承载 Versioned 状态数据的记录类型。

io.agentscope.core.memory.reme18

`Builder`	class	`agentscope-extensions-reme`	ReMeAddRequest的构建器。
`Builder`	class	`agentscope-extensions-reme`	ReMeLongTermMemory的构建器。
`Builder`	class	`agentscope-extensions-reme`	用于ReMeMessage的构建器类。
`Builder`	class	`agentscope-extensions-reme`	ReMeSearchRequest的构建器。
`Builder`	class	`agentscope-extensions-reme`	用于ReMeTrajectory的构建器类。
`MemoryItem`	class	`agentscope-extensions-reme`	记忆条目，在多次调用之间保存和恢复会话与记忆数据。
`MemoryItem`	class	`agentscope-extensions-reme`	记忆条目，在多次调用之间保存和恢复会话与记忆数据。
`Metadata`	class	`agentscope-extensions-reme`	元数据，在多次调用之间保存和恢复会话与记忆数据。
`Metadata`	class	`agentscope-extensions-reme`	元数据，在多次调用之间保存和恢复会话与记忆数据。
`ReMeAddRequest`	class	`agentscope-extensions-reme`	Re Me 添加请求，在多次调用之间保存和恢复会话与记忆数据。
`ReMeAddResponse`	class	`agentscope-extensions-reme`	Re Me 添加响应，在多次调用之间保存和恢复会话与记忆数据。
`ReMeClient`	class	`agentscope-extensions-reme`	Re Me 客户端，封装与远端服务的连接和调用。
`ReMeLongTermMemory`	class	`agentscope-extensions-reme`	Re Me Long Term 记忆，在多次调用之间保存和恢复会话与记忆数据。
`ReMeMessage`	class	`agentscope-extensions-reme`	以ReMe API格式表示消息。
`ReMeSearchRequest`	class	`agentscope-extensions-reme`	Re Me 搜索请求，在多次调用之间保存和恢复会话与记忆数据。
`ReMeSearchResponse`	class	`agentscope-extensions-reme`	Re Me 搜索响应，在多次调用之间保存和恢复会话与记忆数据。
`ReMeTrajectory`	class	`agentscope-extensions-reme`	Re Me Trajectory，在多次调用之间保存和恢复会话与记忆数据。
`UpdateResult`	class	`agentscope-extensions-reme`	更新结果，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.core.memory.autocontext14

`AutoContextConfig`	class	`agentscope-extensions-autocontext-memory`	用于AutoContextMemory的配置类。
`AutoContextHook`	class	`agentscope-extensions-autocontext-memory`	Auto 上下文钩子，在多次调用之间保存和恢复会话与记忆数据。
`AutoContextMemory`	class	`agentscope-extensions-autocontext-memory`	Auto 上下文记忆，在多次调用之间保存和恢复会话与记忆数据。
`Builder`	class	`agentscope-extensions-autocontext-memory`	构建器，用于构建并配置目标实例。
`Builder`	class	`agentscope-extensions-autocontext-memory`	构建器，用于构建并配置目标实例。
`CompressionEvent`	class	`agentscope-extensions-autocontext-memory`	压缩事件，描述执行过程中的事件。
`ContextOffloadTool`	class	`agentscope-extensions-autocontext-memory`	上下文卸载工具，封装可被智能体调用的能力。
`MsgUtils`	class	`agentscope-extensions-autocontext-memory`	消息 Utils，在多次调用之间保存和恢复会话与记忆数据。
`OffloadContextState`	record	`agentscope-extensions-autocontext-memory`	承载卸载上下文状态数据的记录类型。
`Pair`	record	`agentscope-extensions-autocontext-memory`	承载 Pair数据的记录类型。
`PromptConfig`	class	`agentscope-extensions-autocontext-memory`	提示词配置，保存相关配置项。
`PromptProvider`	class	`agentscope-extensions-autocontext-memory`	提示词提供者，在多次调用之间保存和恢复会话与记忆数据。
`Prompts`	class	`agentscope-extensions-autocontext-memory`	提示词，在多次调用之间保存和恢复会话与记忆数据。
`TokenCounterUtil`	class	`agentscope-extensions-autocontext-memory`	令牌 Counter Util，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.core.memory.bailian14

`BailianAddRequest`	class	`agentscope-extensions-memory-bailian`	Bailian 添加请求，在多次调用之间保存和恢复会话与记忆数据。
`BailianAddResponse`	class	`agentscope-extensions-memory-bailian`	Bailian 添加响应，在多次调用之间保存和恢复会话与记忆数据。
`BailianLongTermMemory`	class	`agentscope-extensions-memory-bailian`	Bailian Long Term 记忆，在多次调用之间保存和恢复会话与记忆数据。
`BailianMemoryClient`	class	`agentscope-extensions-memory-bailian`	Bailian 记忆客户端，封装与远端服务的连接和调用。
`BailianMemoryNode`	class	`agentscope-extensions-memory-bailian`	表示记忆节点 in 响应。
`BailianMemoryNode`	class	`agentscope-extensions-memory-bailian`	表示记忆节点 in 响应。
`BailianMessage`	class	`agentscope-extensions-memory-bailian`	Bailian 消息，在多次调用之间保存和恢复会话与记忆数据。
`BailianSearchRequest`	class	`agentscope-extensions-memory-bailian`	Bailian 搜索请求，在多次调用之间保存和恢复会话与记忆数据。
`BailianSearchResponse`	class	`agentscope-extensions-memory-bailian`	Bailian 搜索响应，在多次调用之间保存和恢复会话与记忆数据。
`Builder`	class	`agentscope-extensions-memory-bailian`	BailianAddRequest的构建器。
`Builder`	class	`agentscope-extensions-memory-bailian`	`BailianLongTermMemory`的构建器。
`Builder`	class	`agentscope-extensions-memory-bailian`	`BailianMemoryClient`的构建器。
`Builder`	class	`agentscope-extensions-memory-bailian`	BailianMessage的构建器。
`Builder`	class	`agentscope-extensions-memory-bailian`	BailianSearchRequest的构建器。

io.agentscope.core.memory.mem013

`Builder`	class	`agentscope-extensions-mem0`	Mem0AddRequest的构建器。
`Builder`	class	`agentscope-extensions-mem0`	Mem0LongTermMemory的构建器。
`Builder`	class	`agentscope-extensions-mem0`	用于Mem0Message的构建器类。
`Builder`	class	`agentscope-extensions-mem0`	Mem0SearchRequest的构建器。
`Mem0AddRequest`	class	`agentscope-extensions-mem0`	Mem 0 添加请求，在多次调用之间保存和恢复会话与记忆数据。
`Mem0AddResponse`	class	`agentscope-extensions-mem0`	Mem 0 添加响应，在多次调用之间保存和恢复会话与记忆数据。
`Mem0ApiType`	enum	`agentscope-extensions-mem0`	定义Mem 0 API 类型的枚举。
`Mem0Client`	class	`agentscope-extensions-mem0`	Mem 0 客户端，封装与远端服务的连接和调用。
`Mem0LongTermMemory`	class	`agentscope-extensions-mem0`	Mem 0 Long Term 记忆，在多次调用之间保存和恢复会话与记忆数据。
`Mem0Message`	class	`agentscope-extensions-mem0`	以Mem0 API格式表示消息。
`Mem0SearchRequest`	class	`agentscope-extensions-mem0`	Mem 0 搜索请求，在多次调用之间保存和恢复会话与记忆数据。
`Mem0SearchResponse`	class	`agentscope-extensions-mem0`	Mem 0 搜索响应，在多次调用之间保存和恢复会话与记忆数据。
`Mem0SearchResult`	class	`agentscope-extensions-mem0`	Mem 0 搜索结果，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.harness.agent.memory.compaction10

`Builder`	class	`agentscope-harness`	构建器，用于构建并配置目标实例。
`Builder`	class	`agentscope-harness`	`ToolResultEvictionConfig`的构建器。
`CompactionConfig`	class	`agentscope-harness`	压缩配置，保存相关配置项。
`ConversationCompactor`	class	`agentscope-harness`	会话 Compactor，在多次调用之间保存和恢复会话与记忆数据。
`PruneBuilder`	class	`agentscope-harness`	修剪构建器，用于构建并配置目标实例。
`PruneConfig`	class	`agentscope-harness`	修剪配置，保存相关配置项。
`TokenCounterUtil`	class	`agentscope-harness`	令牌 Counter Util，在多次调用之间保存和恢复会话与记忆数据。
`ToolResultEvictionConfig`	class	`agentscope-harness`	工具结果淘汰配置，保存相关配置项。
`TruncateArgsBuilder`	class	`agentscope-harness`	Truncate 参数构建器，用于构建并配置目标实例。
`TruncateArgsConfig`	class	`agentscope-harness`	Truncate 参数配置，保存相关配置项。

io.agentscope.harness.agent.memory.session9

`CompactionEntry`	class	`agentscope-harness`	压缩条目，在多次调用之间保存和恢复会话与记忆数据。
`MessageEntry`	class	`agentscope-harness`	消息条目，在多次调用之间保存和恢复会话与记忆数据。
`SessionEntry`	class	`agentscope-harness`	会话条目，在多次调用之间保存和恢复会话与记忆数据。
`SessionFreshnessEvaluator`	class	`agentscope-harness`	会话 Freshness 评估器，在多次调用之间保存和恢复会话与记忆数据。
`SessionTranscriptWriter`	class	`agentscope-harness`	会话 Transcript Writer，在多次调用之间保存和恢复会话与记忆数据。
`SessionTree`	class	`agentscope-harness`	会话树，在多次调用之间保存和恢复会话与记忆数据。
`SummaryEntry`	class	`agentscope-harness`	摘要条目，在多次调用之间保存和恢复会话与记忆数据。
`ToolResultEntry`	class	`agentscope-harness`	工具结果条目，在多次调用之间保存和恢复会话与记忆数据。
`ToolUseEntry`	class	`agentscope-harness`	工具使用条目，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.core.memory8

`AgentStateMemoryView`	class	`agentscope-core`	智能体状态记忆 View，在多次调用之间保存和恢复会话与记忆数据。
`InMemoryMemory`	class	`agentscope-core`	In 记忆记忆，在多次调用之间保存和恢复会话与记忆数据。
`LongTermMemory`	interface	`agentscope-core`	定义 Long Term 记忆契约的接口。
`LongTermMemoryMode`	enum	`agentscope-core`	定义Long Term 记忆模式相关取值的枚举。
`LongTermMemoryTools`	class	`agentscope-core`	Long Term 记忆工具，封装可被智能体调用的能力。
`Memory`	interface	`agentscope-core`	定义记忆契约的接口。
`StateBackedMemory`	class	`agentscope-core`	状态 Backed 记忆，在多次调用之间保存和恢复会话与记忆数据。
`StaticLongTermMemoryHook`	class	`agentscope-core`	Static Long Term 记忆钩子，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.extensions.mysql.store7

`Builder`	class	`agentscope-extensions-mysql`	`JdbcStore`的构建器。
`H2JdbcStoreDialect`	class	`agentscope-extensions-mysql`	H 2 JDBC 存储 Dialect，在多次调用之间保存和恢复会话与记忆数据。
`JdbcStore`	class	`agentscope-extensions-mysql`	JDBC 存储，负责持久化与读取数据。
`JdbcStoreDialect`	interface	`agentscope-extensions-mysql`	定义 JDBC 存储 Dialect契约的接口。
`MysqlJdbcStoreDialect`	class	`agentscope-extensions-mysql`	MySQL JDBC 存储 Dialect，在多次调用之间保存和恢复会话与记忆数据。
`PostgresJdbcStoreDialect`	class	`agentscope-extensions-mysql`	Postgres JDBC 存储 Dialect，在多次调用之间保存和恢复会话与记忆数据。
`SqliteJdbcStoreDialect`	class	`agentscope-extensions-mysql`	Sqlite JDBC 存储 Dialect，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.harness.agent.memory7

`Builder`	class	`agentscope-harness`	构建器，用于构建并配置目标实例。
`FlushMode`	enum	`agentscope-harness`	定义刷新模式相关取值的枚举。
`FlushTrigger`	class	`agentscope-harness`	刷新 Trigger，在多次调用之间保存和恢复会话与记忆数据。
`MemoryBackgroundTasks`	class	`agentscope-harness`	记忆 Background 任务，在多次调用之间保存和恢复会话与记忆数据。
`MemoryConfig`	class	`agentscope-harness`	记忆配置，保存相关配置项。
`MemoryConsolidator`	class	`agentscope-harness`	记忆 Consolidator，在多次调用之间保存和恢复会话与记忆数据。
`MemoryFlushManager`	class	`agentscope-harness`	记忆刷新管理器，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.runtime.engine.services.memory.persistence.memory.service5

`InMemoryMemoryService`	class	`agentscope-runtime-engine`	In 记忆记忆服务，在多次调用之间保存和恢复会话与记忆数据。
`Mem0MemoryService`	class	`agentscope-runtime-engine`	Mem 0 记忆服务，在多次调用之间保存和恢复会话与记忆数据。
`RedisMemoryService`	class	`agentscope-runtime-engine`	Redis 记忆服务，在多次调用之间保存和恢复会话与记忆数据。
`SimpleEmbeddingService`	class	`agentscope-runtime-engine`	简单向量化服务，在多次调用之间保存和恢复会话与记忆数据。
`TableStoreMemoryService`	class	`agentscope-runtime-engine`	Table 存储记忆服务，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.extensions.jdbc.dialect4

`AbstractJdbcDialect`	class	`agentscope-extensions-jdbc`	抽象 JDBC Dialect，在多次调用之间保存和恢复会话与记忆数据。
`AbstractJdbcDialectBuilder`	class	`agentscope-extensions-jdbc`	抽象 JDBC Dialect 构建器，用于构建并配置目标实例。
`BoundSql`	record	`agentscope-extensions-jdbc`	承载 Bound SQL数据的记录类型。
`SandboxLockStrategy`	interface	`agentscope-extensions-jdbc`	定义沙箱锁 Strategy契约的接口。

io.agentscope.extensions.jdbc.dialect.vendor4

`H2Dialect`	class	`agentscope-extensions-jdbc`	H 2 Dialect，在多次调用之间保存和恢复会话与记忆数据。
`MysqlDialect`	class	`agentscope-extensions-jdbc`	MySQL Dialect，在多次调用之间保存和恢复会话与记忆数据。
`PostgresDialect`	class	`agentscope-extensions-jdbc`	Postgres Dialect，在多次调用之间保存和恢复会话与记忆数据。
`SqliteDialect`	class	`agentscope-extensions-jdbc`	Sqlite Dialect，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.extensions.mongodb4

`MongoConstants`	class	`agentscope-extensions-mongodb`	Mongo Constants，在多次调用之间保存和恢复会话与记忆数据。
`MongoDistributedStore`	class	`agentscope-extensions-mongodb`	Mongo 分布式存储，负责持久化与读取数据。
`MongoIndexUtils`	class	`agentscope-extensions-mongodb`	Mongo 索引 Utils，在多次调用之间保存和恢复会话与记忆数据。
`MongoKeyEscaper`	class	`agentscope-extensions-mongodb`	Mongo 键 Escaper，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.extensions.redis.state4

`Builder`	class	`agentscope-extensions-redis`	`RedisAgentStateStore`的构建器。
`RedisAgentStateStore`	class	`agentscope-extensions-redis`	Redis 智能体状态存储，负责持久化与读取数据。
`RedisClientAdapter`	interface	`agentscope-extensions-redis`	定义 Redis 客户端适配器契约的接口。
`RedisStateVersionSupport`	class	`agentscope-extensions-redis`	Redis 状态版本 Support，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.core.session.redis3

`Builder`	class	`agentscope-extensions-session-redis`	`RedisSession`的构建器。
`RedisClientAdapter`	interface	`agentscope-extensions-session-redis`	定义 Redis 客户端适配器契约的接口。
`RedisSession`	class	`agentscope-extensions-session-redis`	Redis 会话，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.core.session.redis.jedis3

`Builder`	class	`agentscope-extensions-session-redis`	`JedisSession`的构建器。
`JedisClientAdapter`	class	`agentscope-extensions-session-redis`	Jedis 客户端适配器，在多次调用之间保存和恢复会话与记忆数据。
`JedisSession`	class	`agentscope-extensions-session-redis`	Jedis 会话，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.core.session.redis.redisson3

`Builder`	class	`agentscope-extensions-session-redis`	`RedissonSession`的构建器。
`RedissonClientAdapter`	class	`agentscope-extensions-session-redis`	Redisson 客户端适配器，在多次调用之间保存和恢复会话与记忆数据。
`RedissonSession`	class	`agentscope-extensions-session-redis`	Redisson 会话，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.core.shutdown3

`ShutdownSessionBinding`	record	`agentscope-core`	承载 Shutdown 会话绑定数据的记录类型。
`ShutdownState`	enum	`agentscope-core`	定义Shutdown 状态的枚举。
`ShutdownStateSaver`	interface	`agentscope-core`	定义 Shutdown 状态 Saver契约的接口。

io.agentscope.extensions.jdbc.dialect.table3

`SessionStateDialect`	interface	`agentscope-extensions-jdbc`	定义会话状态 Dialect契约的接口。
`SnapshotDialect`	interface	`agentscope-extensions-jdbc`	定义快照 Dialect契约的接口。
`StoreDialect`	interface	`agentscope-extensions-jdbc`	定义存储 Dialect契约的接口。

io.agentscope.extensions.redis.state.jedis3

`Builder`	class	`agentscope-extensions-redis`	`JedisAgentStateStore`的构建器。
`JedisAgentStateStore`	class	`agentscope-extensions-redis`	Jedis 智能体状态存储，负责持久化与读取数据。
`JedisClientAdapter`	class	`agentscope-extensions-redis`	Jedis 客户端适配器，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.extensions.redis.state.redisson3

`Builder`	class	`agentscope-extensions-redis`	`RedissonAgentStateStore`的构建器。
`RedissonAgentStateStore`	class	`agentscope-extensions-redis`	Redisson 智能体状态存储，负责持久化与读取数据。
`RedissonClientAdapter`	class	`agentscope-extensions-redis`	Redisson 客户端适配器，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.runtime.engine.services.memory.persistence.session3

`InMemorySessionHistoryService`	class	`agentscope-runtime-engine`	In 记忆会话历史服务，在多次调用之间保存和恢复会话与记忆数据。
`RedisSessionHistoryService`	class	`agentscope-runtime-engine`	Redis 会话历史服务，在多次调用之间保存和恢复会话与记忆数据。
`TableStoreSessionHistoryService`	class	`agentscope-runtime-engine`	Table 存储会话历史服务，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.runtime.engine.services.memory.service3

`EmbeddingService`	interface	`agentscope-runtime-engine`	文本向量化服务。
`MemoryService`	interface	`agentscope-runtime-engine`	定义记忆服务契约的接口。
`SessionHistoryService`	interface	`agentscope-runtime-engine`	定义会话历史服务契约的接口。

io.agentscope.extensions.jdbc.sandbox2

`Builder`	class	`agentscope-extensions-jdbc`	`JdbcSandboxExecutionGuard`的构建器。
`JdbcSandboxExecutionGuard`	class	`agentscope-extensions-jdbc`	JDBC 沙箱执行守卫，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.extensions.jdbc.snapshot2

`JdbcRemoteSnapshotClient`	class	`agentscope-extensions-jdbc`	JDBC 远程快照客户端，封装与远端服务的连接和调用。
`JdbcSnapshotSpec`	class	`agentscope-extensions-jdbc`	JDBC 快照规格，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.extensions.jdbc.store2

`Builder`	class	`agentscope-extensions-jdbc`	`JdbcStore`的构建器。
`JdbcStore`	class	`agentscope-extensions-jdbc`	JDBC 存储，负责持久化与读取数据。

io.agentscope.extensions.mongodb.sandbox2

`Builder`	class	`agentscope-extensions-mongodb`	`MongoSandboxExecutionGuard`的构建器。
`MongoSandboxExecutionGuard`	class	`agentscope-extensions-mongodb`	Mongo 沙箱执行守卫，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.extensions.mongodb.snapshot2

`MongoRemoteSnapshotClient`	class	`agentscope-extensions-mongodb`	Mongo 远程快照客户端，封装与远端服务的连接和调用。
`MongoSnapshotSpec`	class	`agentscope-extensions-mongodb`	Mongo 快照规格，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.extensions.mongodb.state2

`Builder`	class	`agentscope-extensions-mongodb`	`MongoAgentStateStore`的构建器。
`MongoAgentStateStore`	class	`agentscope-extensions-mongodb`	Mongo 智能体状态存储，负责持久化与读取数据。

io.agentscope.extensions.mysql.sandbox2

`Builder`	class	`agentscope-extensions-mysql`	构建器，用于构建并配置目标实例。
`JdbcSandboxExecutionGuard`	class	`agentscope-extensions-mysql`	JDBC 沙箱执行守卫，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.extensions.mysql.snapshot2

`JdbcRemoteSnapshotClient`	class	`agentscope-extensions-mysql`	JDBC 远程快照客户端，封装与远端服务的连接和调用。
`JdbcSnapshotSpec`	class	`agentscope-extensions-mysql`	JDBC 快照规格，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.extensions.postgresql.sandbox2

`Builder`	class	`agentscope-extensions-postgresql`	构建器，用于构建并配置目标实例。
`PostgresSandboxExecutionGuard`	class	`agentscope-extensions-postgresql`	Postgres 沙箱执行守卫，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.extensions.postgresql.snapshot2

`PostgresRemoteSnapshotClient`	class	`agentscope-extensions-postgresql`	Postgres 远程快照客户端，封装与远端服务的连接和调用。
`PostgresSnapshotSpec`	class	`agentscope-extensions-postgresql`	Postgres 快照规格，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.extensions.postgresql.state2

`Builder`	class	`agentscope-extensions-postgresql`	`PostgresAgentStateStore`的构建器。
`PostgresAgentStateStore`	class	`agentscope-extensions-postgresql`	Postgres 智能体状态存储，负责持久化与读取数据。

io.agentscope.extensions.postgresql.store2

`Builder`	class	`agentscope-extensions-postgresql`	`PostgresBaseStore`的构建器。
`PostgresBaseStore`	class	`agentscope-extensions-postgresql`	Postgres 基类存储，负责持久化与读取数据。

io.agentscope.extensions.redis.sandbox2

`Builder`	class	`agentscope-extensions-redis`	`RedisSandboxExecutionGuard`的构建器。
`RedisSandboxExecutionGuard`	class	`agentscope-extensions-redis`	Redis 沙箱执行守卫，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.extensions.redis.snapshot2

`RedisRemoteSnapshotClient`	class	`agentscope-extensions-redis`	Redis 远程快照客户端，封装与远端服务的连接和调用。
`RedisSnapshotSpec`	class	`agentscope-extensions-redis`	Redis 快照规格，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.runtime.adapters.agentscope.memory2

`LongTermMemoryAdapter`	class	`agentscope-runtime-core`	Long Term 记忆适配器，在多次调用之间保存和恢复会话与记忆数据。
`MemoryAdapter`	class	`agentscope-runtime-core`	记忆适配器，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.core.session.mysql1

MysqlSession class agentscope-extensions-session-mysql MySQL 会话，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.core.session.redis.lettuce1

LettuceClientAdapter class agentscope-extensions-session-redis Lettuce 客户端适配器，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.core.state.legacy1

ToolkitState record agentscope-core 承载工具包状态数据的记录类型。

io.agentscope.extensions.agentprotocol1

AgentProtocolTaskStore class agentscope-extensions-agent-protocol 智能体协议任务存储，负责持久化与读取数据。

io.agentscope.extensions.jdbc1

JdbcDistributedStore class agentscope-extensions-jdbc JDBC 分布式存储，负责持久化与读取数据。

io.agentscope.extensions.jdbc.state1

JdbcAgentStateStore class agentscope-extensions-jdbc JDBC 智能体状态存储，负责持久化与读取数据。

io.agentscope.extensions.mongodb.store1

MongoBaseStore class agentscope-extensions-mongodb Mongo 基类存储，负责持久化与读取数据。

io.agentscope.extensions.mysql1

MysqlDistributedStore class agentscope-extensions-mysql MySQL 分布式存储，负责持久化与读取数据。

io.agentscope.extensions.mysql.state1

MysqlAgentStateStore class agentscope-extensions-mysql MySQL 智能体状态存储，负责持久化与读取数据。

io.agentscope.extensions.postgresql1

PostgresDistributedStore class agentscope-extensions-postgresql Postgres 分布式存储，负责持久化与读取数据。

io.agentscope.extensions.redis1

RedisDistributedStore class agentscope-extensions-redis Redis 分布式存储，负责持久化与读取数据。

io.agentscope.extensions.redis.state.lettuce1

LettuceClientAdapter class agentscope-extensions-redis Lettuce 客户端适配器，在多次调用之间保存和恢复会话与记忆数据。

io.agentscope.extensions.redis.store1

RedisStore class agentscope-extensions-redis Redis 存储，负责持久化与读取数据。

Python ↔ Java 对照Python ↔ Java

Python

AgentStateAgenticMemoryMiddlewareMem0Middleware

Java

AgentStateAgentStateStoreJsonFileAgentStateStoreMemoryInMemoryAgentStateStore

两套实现共享同一概念模型，但在并发（async/await 与 Reactor）、打包（wheel 模块与 Maven 构件）和生命周期 API 上存在差异。需要精确签名时请使用 API 全景。The two implementations follow the same conceptual model but differ in concurrency (async/await vs Reactor), packaging (wheel modules vs Maven artifacts) and lifecycle APIs. Use the full API map to locate exact signatures.

打开 API 全景Open full API map →