WorkspaceContextMiddleware
public class WorkspaceContextMiddleware implements HarnessRuntimeMiddlewareio/agentscope/harness/agent/middleware/WorkspaceContextMiddleware.java:50–595工作区上下文中间件，在智能体执行流程中提供横切扩展。位于 io.agentscope.harness.agent.middleware 包，实现 HarnessRuntimeMiddleware。核心成员包括 setAdditionalContextFiles、isDisableMemoryTools、isDisableMemoryHooks、setArtifactDeliveryEnabled、onSystemPrompt、WorkspaceContextMiddleware。
Appends workspace context (session info, AGENTS.md, MEMORY.md, knowledge) to the
system prompt via #onSystemPrompt(Agent, RuntimeContext, String).
Runs once per call() (just like the previous WorkspaceContextHook
fired on PreCallEvent).
Memory-related guidance and <memory_context> injection are gated by the same
builder flags as Harness memory tools/hooks (disableMemoryTools /
disableMemoryHooks) so the model is not instructed to use capabilities that are
turned off.
构造器摘要Constructor Summary
方法摘要Method Summary
| 方法Method | 说明Description |
|---|---|
public void setAdditionalContextFiles(List<String> files) | 设置 `setAdditionalContextFiles`。 Sets the additional context files. |
public boolean isDisableMemoryTools() | 判断是否禁用记忆工具。 Whether memory tools are disabled for this middleware (affects prompt guidance). |
public boolean isDisableMemoryHooks() | 判断是否 `isDisableMemoryHooks`。 Whether memory hooks are disabled for this middleware (affects prompt guidance). |
public void setArtifactDeliveryEnabled(boolean artifactDeliveryEnabled) | 设置 `setArtifactDeliveryEnabled`。 Whether an `io.agentscope.harness.agent.artifact.ArtifactDeliveryTarget` is configured
and the `deliver_artifact` tool is exposed. |
public Mono<String> onSystemPrompt(Agent agent, RuntimeContext ctx, String currentPrompt) | 处理系统提示词事件。 Performs the on system prompt operation. |
构造器详情Constructor Detail
WorkspaceContextMiddleware
public WorkspaceContextMiddleware(WorkspaceManager workspaceManager)初始化 WorkspaceContextMiddleware 实例。
Creates a new instance.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
workspaceManager | WorkspaceManager | 工作区管理器（类型 `WorkspaceManager`）。The workspace manager. |
io/agentscope/harness/agent/middleware/WorkspaceContextMiddleware.java:139–141WorkspaceContextMiddleware
public WorkspaceContextMiddleware(WorkspaceManager workspaceManager, int maxContextTokens)初始化 WorkspaceContextMiddleware 实例。
Creates a new instance.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
workspaceManager | WorkspaceManager | 工作区管理器（类型 `WorkspaceManager`）。The workspace manager. |
maxContextTokens | int | 最大上下文令牌数（类型 `int`）。The max context tokens. |
io/agentscope/harness/agent/middleware/WorkspaceContextMiddleware.java:143–145WorkspaceContextMiddleware
public WorkspaceContextMiddleware(WorkspaceManager workspaceManager, String agentName, String environmentMemory, int maxContextTokens)初始化 WorkspaceContextMiddleware 实例。
Creates a new instance.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
workspaceManager | WorkspaceManager | 工作区管理器（类型 `WorkspaceManager`）。The workspace manager. |
agentName | String | 智能体名称（类型 `String`）。The agent name. |
environmentMemory | String | 环境记忆（类型 `String`）。The environment memory. |
maxContextTokens | int | 最大上下文令牌数（类型 `int`）。The max context tokens. |
io/agentscope/harness/agent/middleware/WorkspaceContextMiddleware.java:147–153WorkspaceContextMiddleware
public WorkspaceContextMiddleware(WorkspaceManager workspaceManager, String agentName, String environmentMemory, int maxContextTokens, boolean disableMemoryTools, boolean disableMemoryHooks)初始化 WorkspaceContextMiddleware 实例。
Creates a new instance.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
workspaceManager | WorkspaceManager | 工作区管理器（类型 `WorkspaceManager`）。The workspace manager. |
agentName | String | 智能体名称（类型 `String`）。The agent name. |
environmentMemory | String | 环境记忆（类型 `String`）。The environment memory. |
maxContextTokens | int | 最大上下文令牌数（类型 `int`）。The max context tokens. |
disableMemoryTools | boolean | 禁用记忆工具（类型 `boolean`）。The disable memory tools. |
disableMemoryHooks | boolean | 禁用记忆 Hooks（类型 `boolean`）。The disable memory hooks. |
io/agentscope/harness/agent/middleware/WorkspaceContextMiddleware.java:155–168方法详情Method Detail
setAdditionalContextFiles
public void setAdditionalContextFiles(List<String> files)设置 setAdditionalContextFiles。
Sets the additional context files.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
files | List<String> | 文件（类型 `List`）。The files. |
io/agentscope/harness/agent/middleware/WorkspaceContextMiddleware.java:170–172isDisableMemoryTools
public boolean isDisableMemoryTools()判断是否禁用记忆工具。
Whether memory tools are disabled for this middleware (affects prompt guidance).
booleanio/agentscope/harness/agent/middleware/WorkspaceContextMiddleware.java:177–179isDisableMemoryHooks
public boolean isDisableMemoryHooks()判断是否 isDisableMemoryHooks。
Whether memory hooks are disabled for this middleware (affects prompt guidance).
booleanio/agentscope/harness/agent/middleware/WorkspaceContextMiddleware.java:184–186setArtifactDeliveryEnabled
public void setArtifactDeliveryEnabled(boolean artifactDeliveryEnabled)设置 setArtifactDeliveryEnabled。
Whether an io.agentscope.harness.agent.artifact.ArtifactDeliveryTarget is configured and the deliver_artifact tool is exposed.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
artifactDeliveryEnabled | boolean | artifact Delivery 已启用（类型 `boolean`）。The artifact delivery enabled. |
io/agentscope/harness/agent/middleware/WorkspaceContextMiddleware.java:194–196onSystemPrompt
public Mono<String> onSystemPrompt(Agent agent, RuntimeContext ctx, String currentPrompt)处理系统提示词事件。
Performs the on system prompt operation.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
agent | Agent | 智能体（类型 `Agent`）。The agent. |
ctx | RuntimeContext | 运行时上下文（类型 `RuntimeContext`）。The ctx. |
currentPrompt | String | 当前提示词（类型 `String`）。The current prompt. |
Mono<String>io/agentscope/harness/agent/middleware/WorkspaceContextMiddleware.java:198–209