agentscope.memory

import al memory related modules

class agentscope.memory.MemoryBase(config: dict | None = None)

基类：ABC

Base class for memory.

__init__(config: dict | None = None) → None

MemoryBase is a base class for memory of agents.

参数:

config (Optional[dict], defaults to None) – Configuration of this memory.

update_config(config: dict) → None

Configure memory as specified in config :param config: Configuration of resetting this memory :type config: dict

abstract get_memory(recent_n: int | None = None, filter_func: Callable[[int, dict], bool] | None = None) → list

Return a certain range (recent_n or all) of memory, filtered by filter_func :param recent_n: indicate the most recent N memory pieces to be returned. :type recent_n: int, optional :param filter_func: filter function to decide which pieces of memory should

be returned, taking the index and a piece of memory as input and return True (return this memory) or False (does not return)

abstract add(memories: Sequence[dict] | dict | None) → None

Adding new memory fragment, depending on how the memory are stored :param memories: Memories to be added. If the memory is not in MessageBase,

it will first be converted into a message type.

abstract delete(index: Iterable | int) → None

Delete memory fragment, depending on how the memory are stored and matched :param index: indices of the memory fragments to delete :type index: Union[Iterable, int]

abstract load(memories: str | list[MessageBase] | MessageBase, overwrite: bool = False) → None

Load memory, depending on how the memory are passed, design to load from both file or dict :param memories: memories to be loaded.

If it is in str type, it will be first checked if it is a file; otherwise it will be deserialized as messages. Otherwise, memories must be either in message type or list

of messages.

参数:

overwrite (bool) – if True, clear the current memory before loading the new ones; if False, memories will be appended to the old one at the end.

abstract export(file_path: str | None = None, to_mem: bool = False) → list | None

Export memory, depending on how the memory are stored :param file_path: file path to save the memory to. :type file_path: Optional[str] :param to_mem: if True, just return the list of messages in memory :type to_mem: Optional[str]

Notice: this method prevents file_path is None when to_mem is False.

abstract clear() → None

Clean memory, depending on how the memory are stored

abstract size() → int

Returns the number of memory segments in memory.

class agentscope.memory.TemporaryMemory(config: dict | None = None, embedding_model: str | Callable | None = None)

基类：MemoryBase

In-memory memory module, not writing to hard disk

__init__(config: dict | None = None, embedding_model: str | Callable | None = None) → None

Temporary memory module for conversation. :param config: configuration of the memory :type config: dict :param embedding_model: if the temporary memory needs to be embedded,

then either pass the name of embedding model or the embedding model itself.

add(memories: Sequence[dict] | dict | None, embed: bool = False) → None

Adding new memory fragment, depending on how the memory are stored :param memories: memories to be added. If the memory is not in MessageBase,

it will first be converted into a message type.

参数:

embed (bool) – whether to generate embedding for the new added memories

delete(index: Iterable | int) → None

Delete memory fragment, depending on how the memory are stored and matched :param index: indices of the memory fragments to delete :type index: Union[Iterable, int]

export(file_path: str | None = None, to_mem: bool = False) → list | None

Export memory, depending on how the memory are stored :param file_path: file path to save the memory to. The messages will

be serialized and written to the file.

参数:

to_mem (Optional[str]) – if True, just return the list of messages in memory

Notice: this method prevents file_path is None when to_mem is False.

load(memories: str | list[MessageBase] | MessageBase, overwrite: bool = False) → None

Load memory, depending on how the memory are passed, design to load from both file or dict :param memories: memories to be loaded.

If it is in str type, it will be first checked if it is a file; otherwise it will be deserialized as messages. Otherwise, memories must be either in message type or list

of messages.

参数:

overwrite (bool) – if True, clear the current memory before loading the new ones; if False, memories will be appended to the old one at the end.

clear() → None

Clean memory, depending on how the memory are stored

size() → int

Returns the number of memory segments in memory.

retrieve_by_embedding(query: str | list[Number], metric: Callable[[list[Number], list[Number]], float], top_k: int = 1, preserve_order: bool = True, embedding_model: Callable[[str | dict], list[Number]] | None = None) → list[dict]

Retrieve memory by their embeddings.

参数:

• query (Union[str, Embedding]) – Query string or embedding.

• metric (Callable[[Embedding, Embedding], float]) – A metric to compute the relevance between embeddings of query and memory. In default, higher relevance means better match, and you can set reverse to True to reverse the order.

• top_k (int, defaults to 1) – The number of memory units to retrieve.

• preserve_order (bool, defaults to True) – Whether to preserve the original order of the retrieved memory units.

• embedding_model (Callable[[Union[str, dict]], Embedding], defaults to None) – A callable object to embed the memory unit. If not provided, it will use the default embedding model.

返回:

a list of retrieved memory units in specific order.

返回类型:

list[dict]

get_embeddings(embedding_model: Callable[[str | dict], list[Number]] | None = None) → list

Get embeddings of all memory units. If embedding_model is provided, the memory units that doesn’t have embedding attribute will be embedded. Otherwise, its embedding will be None.

参数:

embedding_model – (Callable[[Union[str, dict]], Embedding], defaults to None): Embedding model or embedding vector.

返回:

List of embeddings or None.

返回类型:

list[Union[Embedding, None]]

get_memory(recent_n: int | None = None, filter_func: Callable[[int, dict], bool] | None = None) → list

Retrieve memory.

参数:

• recent_n (Optional[int], default None) – The last number of memories to return.

• filter_func – (Callable[[int, dict], bool], default to None): The function to filter memories, which take the index and memory unit as input, and return a boolean value.