接口interface io.agentscope.core.memory 2.x

Memory

@Deprecated(forRemoval = true, since = "2.0.0") public interface Memory

源码Source io/agentscope/core/memory/Memory.java:34–78

定义记忆契约的接口。位于 io.agentscope.core.memory 包。核心成员包括 saveTo、loadFrom、addMessage、getMessages、deleteMessage、clear。

Interface for memory components that store and manage conversation history.

Different memory implementations can provide various storage strategies such as in-memory, database-backed, or window-based storage. #saveTo / #loadFrom let callers persist the message buffer through a AgentStateStore for legacy v1 sessions; new code should use io.agentscope.core.state.AgentState instead.

方法摘要Method Summary

方法Method	说明Description
`public void saveTo(AgentStateStore stateStore, String userId, String sessionId)`	保存到。 Save the message buffer under the `memory_messages` session key.
`public void loadFrom(AgentStateStore stateStore, String userId, String sessionId)`	加载来自。 Load a previously saved message buffer (no-op when none exists).
`public void addMessage(Msg message)`	添加消息。 Adds a message to the memory.
`public List<Msg> getMessages()`	获取消息。 Retrieves all messages stored in memory.
`public void deleteMessage(int index)`	删除消息。 Deletes a message at the specified index.
`public void clear()`	清空或重置内部状态。 Clears all messages from memory.

方法详情Method Detail

saveTo

public void saveTo(AgentStateStore stateStore, String userId, String sessionId)

保存到。

Save the message buffer under the memory_messages session key.

参数Parameters

名称Name	类型Type	说明Description
`stateStore`	AgentStateStore	状态存储（类型 `AgentStateStore`）。The state store.
`userId`	String	用户标识（类型 `String`）。The user id.
`sessionId`	String	会话标识（类型 `String`）。The session id.

源码Source io/agentscope/core/memory/Memory.java:40

loadFrom

public void loadFrom(AgentStateStore stateStore, String userId, String sessionId)

加载来自。

Load a previously saved message buffer (no-op when none exists).

参数Parameters

名称Name	类型Type	说明Description
`stateStore`	AgentStateStore	状态存储（类型 `AgentStateStore`）。The state store.
`userId`	String	用户标识（类型 `String`）。The user id.
`sessionId`	String	会话标识（类型 `String`）。The session id.

源码Source io/agentscope/core/memory/Memory.java:45

addMessage

public void addMessage(Msg message)

添加消息。

Adds a message to the memory.

参数Parameters

名称Name	类型Type	说明Description
`message`	Msg	消息到存储 in 记忆。The message to store in memory

源码Source io/agentscope/core/memory/Memory.java:52

getMessages

public List<Msg> getMessages()

获取消息。

Retrieves all messages stored in memory.

返回Returns List<Msg>

返回列出。A list of all messages (may be empty but never null)

源码Source io/agentscope/core/memory/Memory.java:59

deleteMessage

public void deleteMessage(int index)

删除消息。

Deletes a message at the specified index.

参数Parameters

名称Name	类型Type	说明Description
`index`	int	索引（类型 `int`）。The index of the message to delete (0-based)

源码Source io/agentscope/core/memory/Memory.java:69

clear

public void clear()

清空或重置内部状态。

Clears all messages from memory.

源码Source io/agentscope/core/memory/Memory.java:77