Builder
public static final class Builder源码Source
io/agentscope/harness/agent/memory/MemoryConfig.java:231–364构建器，用于构建并配置目标实例。位于 io.agentscope.harness.agent.memory 包。核心成员包括 model、flushPrompt、consolidationPrompt、consolidationMaxTokens、consolidationMinGap、dailyFileRetentionDays。
A class in io.agentscope.harness.agent.memory that persists and restores session and memory data across calls. Declared in io.agentscope.harness.agent.memory.
方法摘要Method Summary
| 方法Method | 说明Description |
|---|---|
public Builder model(Model model) | 设置模型。 Sets a dedicated model for memory operations (flush + consolidation),
allowing a lighter/cheaper model than the agent's primary reasoning model. |
public Builder model(String modelId) | 设置模型。 Sets a dedicated model for memory operations by model id string
(e.g. |
public Builder flushPrompt(String flushPrompt) | 设置刷新提示词。 Overrides the prompt used by `MemoryFlushManager#flushMemories`. |
public Builder consolidationPrompt(String consolidationPrompt) | 设置该配置项。 Overrides the prompt used by `MemoryConsolidator#consolidate`. |
public Builder consolidationMaxTokens(int consolidationMaxTokens) | 设置该配置项。 Token budget passed to the consolidation prompt. |
public Builder consolidationMinGap(Duration consolidationMinGap) | 设置该配置项。 Minimum gap between consolidation/maintenance runs. |
public Builder dailyFileRetentionDays(int dailyFileRetentionDays) | 设置该配置项。 Days before a daily ledger is moved to `memory/archive/`. |
public Builder sessionRetentionDays(int sessionRetentionDays) | 设置该配置项。 Days before a session JSONL log is pruned. |
public Builder flushTrigger(FlushTrigger flushTrigger) | 设置该配置项。 Trigger policy for the per-call flush hook. |
public MemoryConfig build() | 构建并返回最终实例。 Creates and returns an instance. |
方法详情Method Detail
model
public Builder model(Model model)设置模型。
Sets a dedicated model for memory operations (flush + consolidation), allowing a lighter/cheaper model than the agent's primary reasoning model.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
model | Model | 模型实例（类型 `Model`）。The model. |
Builder返回当前实例，以支持链式调用。Returns the current instance for chaining.
源码Source
io/agentscope/harness/agent/memory/MemoryConfig.java:247–250model
public Builder model(String modelId)设置模型。
Sets a dedicated model for memory operations by model id string (e.g.
@see ModelRegistry#resolve(String)
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
modelId | String | 模型标识（类型 `String`）。The model id. |
Builder返回当前实例，以支持链式调用。Returns the current instance for chaining.
源码Source
io/agentscope/harness/agent/memory/MemoryConfig.java:258–261flushPrompt
public Builder flushPrompt(String flushPrompt)设置刷新提示词。
Overrides the prompt used by MemoryFlushManager#flushMemories.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
flushPrompt | String | 刷新提示词（类型 `String`）。The flush prompt. |
Builder返回当前实例，以支持链式调用。Returns the current instance for chaining.
源码Source
io/agentscope/harness/agent/memory/MemoryConfig.java:268–271consolidationPrompt
public Builder consolidationPrompt(String consolidationPrompt)设置该配置项。
Overrides the prompt used by MemoryConsolidator#consolidate.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
consolidationPrompt | String | consolidation 提示词（类型 `String`）。The consolidation prompt. |
Builder返回当前实例，以支持链式调用。Returns the current instance for chaining.
IllegalArgumentException可能抛出 `IllegalArgumentException`。if the prompt does not contain exactly two `%d` placeholders
源码Source
io/agentscope/harness/agent/memory/MemoryConfig.java:282–294consolidationMaxTokens
public Builder consolidationMaxTokens(int consolidationMaxTokens)设置该配置项。
Token budget passed to the consolidation prompt.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
consolidationMaxTokens | int | consolidation 最大令牌数（类型 `int`）。The consolidation max tokens. |
Builder返回当前实例，以支持链式调用。Returns the current instance for chaining.
源码Source
io/agentscope/harness/agent/memory/MemoryConfig.java:297–304consolidationMinGap
public Builder consolidationMinGap(Duration consolidationMinGap)设置该配置项。
Minimum gap between consolidation/maintenance runs.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
consolidationMinGap | Duration | consolidation 最小 Gap（类型 `Duration`）。The consolidation min gap. |
Builder返回当前实例，以支持链式调用。Returns the current instance for chaining.
源码Source
io/agentscope/harness/agent/memory/MemoryConfig.java:311–320dailyFileRetentionDays
public Builder dailyFileRetentionDays(int dailyFileRetentionDays)设置该配置项。
Days before a daily ledger is moved to memory/archive/.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
dailyFileRetentionDays | int | daily 文件 Retention Days（类型 `int`）。The daily file retention days. |
Builder返回当前实例，以支持链式调用。Returns the current instance for chaining.
源码Source
io/agentscope/harness/agent/memory/MemoryConfig.java:323–330sessionRetentionDays
public Builder sessionRetentionDays(int sessionRetentionDays)设置该配置项。
Days before a session JSONL log is pruned.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
sessionRetentionDays | int | 会话 Retention Days（类型 `int`）。The session retention days. |
Builder返回当前实例，以支持链式调用。Returns the current instance for chaining.
源码Source
io/agentscope/harness/agent/memory/MemoryConfig.java:333–340flushTrigger
public Builder flushTrigger(FlushTrigger flushTrigger)设置该配置项。
Trigger policy for the per-call flush hook.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
flushTrigger | FlushTrigger | 刷新 Trigger（类型 `FlushTrigger`）。The flush trigger. |
Builder返回当前实例，以支持链式调用。Returns the current instance for chaining.
源码Source
io/agentscope/harness/agent/memory/MemoryConfig.java:343–349build
public MemoryConfig build()构建并返回最终实例。
Creates and returns an instance.
MemoryConfig返回MemoryConfig。Returns memory config.
源码Source
io/agentscope/harness/agent/memory/MemoryConfig.java:351–353