> ## Documentation Index
> Fetch the complete documentation index at: https://java.agentscope.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 概览

<Note>
  **推荐使用 [DistributedStore](/v2/zh/integration/distributed/index) 一键配置**——它同时覆盖 AgentStateStore、BaseStore、SandboxSnapshotSpec、SandboxExecutionGuard。如果只需要单独配置 AgentStateStore，继续阅读本页。
</Note>

`io.agentscope.core.state.AgentStateStore` 是 AgentScope 用来持久化 Agent 状态的接口——比如 Memory、Workspace、Plan 等组件都会被序列化为 `State` 后由 `AgentStateStore` 落盘，从而支持重启恢复、跨节点共享。

状态通过 `(userId, sessionId)` 二元组寻址：

* `sessionId`——非空、非空白，标识一次会话 / session。
* `userId`——可空。`null` 表示匿名 / 单租户调用方（CLI、测试等）。

## 可用实现

| 实现                        | 模块                            | 适合场景                                             |
| ------------------------- | ----------------------------- | ------------------------------------------------ |
| `InMemoryAgentStateStore` | `agentscope-core`             | 单元测试                                             |
| `JsonFileAgentStateStore` | `agentscope-core`             | 单机开发（**HarnessAgent 默认**）                        |
| `RedisAgentStateStore`    | `agentscope-extensions-redis` | [多副本生产首选](/v2/zh/integration/distributed/redis)  |
| `MysqlAgentStateStore`    | `agentscope-extensions-mysql` | [已有数据库的场景](/v2/zh/integration/distributed/mysql) |
| `OssAgentStateStore`      | `agentscope-extensions-oss`   | [阿里云生态](/v2/zh/integration/distributed/oss)      |

## 单独配置

```java theme={null}
ReActAgent agent = ReActAgent.builder()
    .name("assistant")
    .model(model)
    .stateStore(stateStore)   // 任选一种 AgentStateStore 实现
    .build();
```

详细用法和代码示例请参阅各后端的文档：

* [Redis](/v2/zh/integration/distributed/redis#1-redisagentstatestore)
* [MySQL](/v2/zh/integration/distributed/mysql#1-mysqlagentstatestore)
* [OSS](/v2/zh/integration/distributed/oss#1-ossagentstatestore)