类class agentscope.middleware

AgenticMemoryMiddleware

class AgenticMemoryMiddleware(MiddlewareBase)

源码Source agentscope/middleware/_longterm_memory/_agentic_memory/_middleware.py:359–959

Agentic 记忆中间件，在智能体执行流程中提供横切扩展。位于 agentscope.middleware 包，继承自 MiddlewareBase。核心成员包括 on_system_prompt、on_reply、on_reasoning。

The AgenticMemoryMiddleware supports different backends via the backend argument in its constructor.

嵌套类摘要Nested Class Summary

类Class	类型Kind	说明Description
`Parameters`	类class	参数，驱动智能体的推理、工具调用与会话执行。 The user-tunable filesystem parameters.

构造器摘要Constructor Summary

构造器Constructor	说明Description
`def __init__(*, workdir: str, memory_dir: str = 'Memory', parameters:` `Parameters \| None = None, backend: BackendBase \|…`	初始化 `AgenticMemoryMiddleware` 实例。 Initialize filesystem-backed long-term memory behavior.

属性摘要Attribute Summary

属性Attribute	类型Type	说明Description	值Value
`FILENAME_MEMORY_MD`	str	FILENAME 记忆 MD字段。	`'MEMORY.md'`

方法摘要Method Summary

方法Method	说明Description
`async def on_system_prompt(agent: 'Agent', current_prompt: str) -> str`async	拦截并修改系统提示词。 Append memory instructions and a bounded ``MEMORY.md`` snapshot.
`async def on_reply(agent: 'Agent', input_kwargs: dict, next_handler: Callable[..., AsyncGenerator]) -> AsyncGenerator`async	拦截并扩展回复流程。 Cache the user input and kick off an asynchronous retrieval task that runs concurrently with the agent reply.
`async def on_reasoning(agent: 'Agent', input_kwargs: dict, next_handler: Callable[..., AsyncGenerator]) -> AsyncGenerat…`async	拦截并扩展推理阶段。 Check if the retrieval finished and if yes, insert a hint block to the content.

构造器详情Constructor Detail

AgenticMemoryMiddleware

def __init__(*, workdir: str, memory_dir: str = 'Memory', parameters: Parameters | None = None, backend: BackendBase | None = None) -> None

初始化 AgenticMemoryMiddleware 实例。

Initialize filesystem-backed long-term memory behavior.

参数Parameters

名称Name	类型Type	说明Description
`workdir`kw	str	workdir（类型 `str`）。The working directory of this agent, used to store the agentic searchable memory files.
`memory_dir`kw默认default `'Memory'`	str	记忆目录（类型 `str`）。The directory to store the long-term memory files, including `MEMORY.md`.
`parameters`kw默认default `None`	Parameters \| None	参数（类型 `Parameters \| None`）。User-tunable parameters. When `None`, defaults are used.
`backend`kw默认default `None`	BackendBase \| None	backend（类型 `BackendBase \| None`）。The backend to switch between local and remote storage. When `None`, a local filesystem is used.

源码Source agentscope/middleware/_longterm_memory/_agentic_memory/_middleware.py:450–483

属性详情Attribute Detail

FILENAME_MEMORY_MD

str = 'MEMORY.md'

FILENAME 记忆 MD字段。声明为 str。

The FILENAME MEMORY MD field.

源码Source agentscope/middleware/_longterm_memory/_agentic_memory/_middleware.py:368

方法详情Method Detail

on_system_prompt

async def on_system_prompt(agent: 'Agent', current_prompt: str) -> str

async

拦截并修改系统提示词。

Append memory instructions and a bounded MEMORY.md snapshot.

参数Parameters

名称Name	类型Type	说明Description
`agent`	'Agent'	智能体（类型 `'Agent'`）。The executing agent. Unused, but part of the middleware contract.
`current_prompt`	str	当前提示词（类型 `str`）。The system prompt produced by previous middleware.

返回Returns str

返回字符串结果。`str`:

源码Source agentscope/middleware/_longterm_memory/_agentic_memory/_middleware.py:513–566

on_reply

async def on_reply(agent: 'Agent', input_kwargs: dict, next_handler: Callable[..., AsyncGenerator]) -> AsyncGenerator

async

拦截并扩展回复流程。

Cache the user input and kick off an asynchronous retrieval task that runs concurrently with the agent reply.

参数Parameters

名称Name	类型Type	说明Description
`agent`	'Agent'	智能体（类型 `'Agent'`）。The executing agent whose model may be used for retrieval.
`input_kwargs`	dict	输入关键字参数（类型 `dict`）。Reply input kwargs forwarded unchanged.
`next_handler`	Callable[..., AsyncGenerator]	下一个处理器（类型 `Callable[..., AsyncGenerator]`）。The downstream middleware or core reply logic.

返回Returns AsyncGenerator

返回AsyncGenerator。`Any`:

源码Source agentscope/middleware/_longterm_memory/_agentic_memory/_middleware.py:568–633

on_reasoning

async def on_reasoning(agent: 'Agent', input_kwargs: dict, next_handler: Callable[..., AsyncGenerator]) -> AsyncGenerator

async

拦截并扩展推理阶段。

Check if the retrieval finished and if yes, insert a hint block to the content.

参数Parameters

名称Name	类型Type	说明Description
`agent`	'Agent'	智能体（类型 `'Agent'`）。The executing agent whose context may receive a hint block.
`input_kwargs`	dict	输入关键字参数（类型 `dict`）。Reasoning input kwargs forwarded unchanged.
`next_handler`	Callable[..., AsyncGenerator]	下一个处理器（类型 `Callable[..., AsyncGenerator]`）。The downstream middleware or core reasoning logic.

返回Returns AsyncGenerator

返回AsyncGenerator。`Any`:

源码Source agentscope/middleware/_longterm_memory/_agentic_memory/_middleware.py:635–677

嵌套类详情Nested Class Detail

Parameters

class Parameters

参数，驱动智能体的推理、工具调用与会话执行。位于 agentscope.middleware 包。

The user-tunable filesystem parameters. Declared in agentscope.middleware.

继承成员Inherited Members

继承自Inherited from MiddlewareBase

is_implemented, on_acting, on_check_permission, on_model_call, on_compress_context, list_tools, get_middleware_key