类class io.agentscope.core.hook.recorder 2.x

Builder

public static final class Builder

源码Source io/agentscope/core/hook/recorder/JsonlTraceExporter.java:441–547

构建器，用于构建并配置目标实例。位于 io.agentscope.core.hook.recorder 包。核心成员包括 append、flushEveryLine、failFast、priority、enabledEvents、includeReasoningChunks。

A class in io.agentscope.core.hook.recorder that drives agent reasoning, tool calls and conversation execution. Declared in io.agentscope.core.hook.recorder.

方法摘要Method Summary

方法Method	说明Description
`public` `Builder append(boolean append)`	设置追加。 Appends to existing file if present (default: true).
`public` `Builder flushEveryLine(boolean flushEveryLine)`	设置该配置项。 Flushes after each JSONL line (default: true).
`public` `Builder failFast(boolean failFast)`	设置该配置项。 If enabled, exporter errors fail the agent execution (default: false, best-effort).
`public` `Builder priority(int priority)`	设置优先级。 Hook priority (default: 900, low priority for logging/export).
`public` `Builder enabledEvents(Set<HookEventType> enabledEvents)`	启用d 事件。 Enables exactly these event types (chunk and summary helpers still apply).
`public` `Builder includeReasoningChunks(boolean includeReasoningChunks)`	设置该配置项。 Includes reasoning streaming events (ReasoningChunkEvent).
`public` `Builder includeActingChunks(boolean includeActingChunks)`	设置该配置项。 Includes tool streaming events (ActingChunkEvent).
`public` `Builder includeSummary(boolean includeSummary)`	设置该配置项。 Includes summary events (PreSummaryEvent/PostSummaryEvent).
`public` `Builder includeSummaryChunks(boolean includeSummaryChunks)`	设置该配置项。 Includes summary streaming events (SummaryChunkEvent).
`public` `JsonlTraceExporter build()`	构建并返回最终实例。 Creates and returns an instance.

方法详情Method Detail

append

public Builder append(boolean append)

设置追加。

Appends to existing file if present (default: true).

参数Parameters

名称Name	类型Type	说明Description
`append`	boolean	追加（类型 `boolean`）。The append.

返回Returns Builder

返回当前实例，以支持链式调用。Returns the current instance for chaining.

源码Source io/agentscope/core/hook/recorder/JsonlTraceExporter.java:469–472

flushEveryLine

public Builder flushEveryLine(boolean flushEveryLine)

设置该配置项。

Flushes after each JSONL line (default: true).

参数Parameters

名称Name	类型Type	说明Description
`flushEveryLine`	boolean	刷新每个 Line（类型 `boolean`）。The flush every line.

返回Returns Builder

返回当前实例，以支持链式调用。Returns the current instance for chaining.

源码Source io/agentscope/core/hook/recorder/JsonlTraceExporter.java:475–478

failFast

public Builder failFast(boolean failFast)

设置该配置项。

If enabled, exporter errors fail the agent execution (default: false, best-effort).

参数Parameters

名称Name	类型Type	说明Description
`failFast`	boolean	fail Fast（类型 `boolean`）。The fail fast.

返回Returns Builder

返回当前实例，以支持链式调用。Returns the current instance for chaining.

源码Source io/agentscope/core/hook/recorder/JsonlTraceExporter.java:483–486

priority

public Builder priority(int priority)

设置优先级。

Hook priority (default: 900, low priority for logging/export).

参数Parameters

名称Name	类型Type	说明Description
`priority`	int	优先级（类型 `int`）。The priority.

返回Returns Builder

返回当前实例，以支持链式调用。Returns the current instance for chaining.

源码Source io/agentscope/core/hook/recorder/JsonlTraceExporter.java:489–492

enabledEvents

public Builder enabledEvents(Set<HookEventType> enabledEvents)

启用d 事件。

Enables exactly these event types (chunk and summary helpers still apply).

参数Parameters

名称Name	类型Type	说明Description
`enabledEvents`	Set<HookEventType>	已启用事件（类型 `Set`）。The enabled events.

返回Returns Builder

返回当前实例，以支持链式调用。Returns the current instance for chaining.

源码Source io/agentscope/core/hook/recorder/JsonlTraceExporter.java:495–501

includeReasoningChunks

public Builder includeReasoningChunks(boolean includeReasoningChunks)

设置该配置项。

Includes reasoning streaming events (ReasoningChunkEvent).

参数Parameters

名称Name	类型Type	说明Description
`includeReasoningChunks`	boolean	include 推理 Chunks（类型 `boolean`）。The include reasoning chunks.

返回Returns Builder

返回当前实例，以支持链式调用。Returns the current instance for chaining.

源码Source io/agentscope/core/hook/recorder/JsonlTraceExporter.java:504–507

includeActingChunks

public Builder includeActingChunks(boolean includeActingChunks)

设置该配置项。

Includes tool streaming events (ActingChunkEvent).

参数Parameters

名称Name	类型Type	说明Description
`includeActingChunks`	boolean	include 执行 Chunks（类型 `boolean`）。The include acting chunks.

返回Returns Builder

返回当前实例，以支持链式调用。Returns the current instance for chaining.

源码Source io/agentscope/core/hook/recorder/JsonlTraceExporter.java:510–513

includeSummary

public Builder includeSummary(boolean includeSummary)

设置该配置项。

Includes summary events (PreSummaryEvent/PostSummaryEvent).

参数Parameters

名称Name	类型Type	说明Description
`includeSummary`	boolean	include 摘要（类型 `boolean`）。The include summary.

返回Returns Builder

返回当前实例，以支持链式调用。Returns the current instance for chaining.

源码Source io/agentscope/core/hook/recorder/JsonlTraceExporter.java:516–519

includeSummaryChunks

public Builder includeSummaryChunks(boolean includeSummaryChunks)

设置该配置项。

Includes summary streaming events (SummaryChunkEvent).

参数Parameters

名称Name	类型Type	说明Description
`includeSummaryChunks`	boolean	include 摘要 Chunks（类型 `boolean`）。The include summary chunks.

返回Returns Builder

返回当前实例，以支持链式调用。Returns the current instance for chaining.

源码Source io/agentscope/core/hook/recorder/JsonlTraceExporter.java:522–525

build

public JsonlTraceExporter build()

构建并返回最终实例。

Creates and returns an instance.

返回Returns JsonlTraceExporter

返回JsonlTraceExporter。Returns jsonl trace exporter.

源码Source io/agentscope/core/hook/recorder/JsonlTraceExporter.java:527–546