类class io.agentscope.harness.agent.middleware 2.x

AgentTraceMiddleware

public class AgentTraceMiddleware implements HarnessRuntimeMiddleware

源码Source io/agentscope/harness/agent/middleware/AgentTraceMiddleware.java:51–284

智能体追踪中间件，在智能体执行流程中提供横切扩展。位于 io.agentscope.harness.agent.middleware 包，实现 HarnessRuntimeMiddleware。核心成员包括 onAgent、onReasoning、onActing。

Observability middleware that logs the reasoning and execution trace of an agent.

At INFO level, logs concise summaries: agent name, model, tool names/IDs, and message lengths. At DEBUG level, additionally logs tool call arguments, tool result content, reasoning text, and input message details.

方法摘要Method Summary

方法Method	说明Description
`public Flux<AgentEvent> onAgent(Agent agent, RuntimeContext ctx, AgentInput input, Function<AgentInput, Flux<AgentEvent>> next)`	处理智能体事件。 Performs the on agent operation.
`public Flux<AgentEvent> onReasoning(Agent agent, RuntimeContext ctx, ReasoningInput input, Function<ReasoningInput, Flux<AgentEvent>> next)`	处理推理事件。 Performs the on reasoning operation.
`public Flux<AgentEvent> onActing(Agent agent, RuntimeContext ctx, ActingInput input, Function<ActingInput, Flux<AgentEvent>> next)`	处理执行事件。 Performs the on acting operation.

方法详情Method Detail

onAgent

public Flux<AgentEvent> onAgent(Agent agent, RuntimeContext ctx, AgentInput input, Function<AgentInput, Flux<AgentEvent>> next)

处理智能体事件。

Performs the on agent operation.

参数Parameters

名称Name	类型Type	说明Description
`agent`	Agent	智能体（类型 `Agent`）。The agent.
`ctx`	RuntimeContext	运行时上下文（类型 `RuntimeContext`）。The ctx.
`input`	AgentInput	输入消息（类型 `AgentInput`）。The input.
`next`	Function<AgentInput, Flux<AgentEvent>>	下一个（类型 `Function >`）。The next.

返回Returns Flux<AgentEvent>

返回Flux。Returns flux.

源码Source io/agentscope/harness/agent/middleware/AgentTraceMiddleware.java:55–85

onReasoning

public Flux<AgentEvent> onReasoning(Agent agent, RuntimeContext ctx, ReasoningInput input, Function<ReasoningInput, Flux<AgentEvent>> next)

处理推理事件。

Performs the on reasoning operation.

参数Parameters

名称Name	类型Type	说明Description
`agent`	Agent	智能体（类型 `Agent`）。The agent.
`ctx`	RuntimeContext	运行时上下文（类型 `RuntimeContext`）。The ctx.
`input`	ReasoningInput	输入消息（类型 `ReasoningInput`）。The input.
`next`	Function<ReasoningInput, Flux<AgentEvent>>	下一个（类型 `Function >`）。The next.

返回Returns Flux<AgentEvent>

返回Flux。Returns flux.

源码Source io/agentscope/harness/agent/middleware/AgentTraceMiddleware.java:87–155

onActing

public Flux<AgentEvent> onActing(Agent agent, RuntimeContext ctx, ActingInput input, Function<ActingInput, Flux<AgentEvent>> next)

处理执行事件。

Performs the on acting operation.

参数Parameters

名称Name	类型Type	说明Description
`agent`	Agent	智能体（类型 `Agent`）。The agent.
`ctx`	RuntimeContext	运行时上下文（类型 `RuntimeContext`）。The ctx.
`input`	ActingInput	输入消息（类型 `ActingInput`）。The input.
`next`	Function<ActingInput, Flux<AgentEvent>>	下一个（类型 `Function >`）。The next.

返回Returns Flux<AgentEvent>

返回Flux。Returns flux.

源码Source io/agentscope/harness/agent/middleware/AgentTraceMiddleware.java:157–219

继承成员Inherited Members

继承自Methods inherited from MiddlewareBase

order, onModelCall, onSystemPrompt