类class io.agentscope.core.training.strategy 2.x

TrainingContext

public class TrainingContext

源码Source io/agentscope/core/training/strategy/TrainingContext.java:60–175

Training 上下文，对智能体行为进行评测、追踪与可观测性分析。位于 io.agentscope.core.training.strategy 包。核心成员包括 mark、getCurrent、REACTOR_KEY。

TrainingContext provides API for marking agent calls for training.

This class uses Reactor Context for propagating training markers across thread boundaries.

Usage Examples:

Basic marking:

`Msg response = agent.call(msg)
.contextWrite(TrainingContext.mark())
.block();
`

Marking with labels:

`Msg response = agent.call(msg)
.contextWrite(TrainingContext.mark("high-quality", "production"))
.block();
`

Marking with metadata:

`Msg response = agent.call(msg)
.contextWrite(TrainingContext.mark(
List.of("important"),
Map.of("user_id", "12345", "session_id", "abc")
))
.block();
`

字段摘要Field Summary

字段Field	类型Type	说明Description
`REACTOR_KEY` staticfinal	String	REACTOR 键字段。 Reactor Context key for storing training annotations

方法摘要Method Summary

方法Method	说明Description
`public static Function<Context, Context> mark()` static	返回 `mark` 结果。 Mark current Agent call for training (basic version)
`public static Function<Context, Context> mark(String... labels)` static	设置该参数。 Mark current Agent call for training (with labels)
`public static Function<Context, Context> mark(List<String> labels, Map<String, Object> metadata)` static	执行 `mark` 方法。 Mark current Agent call for training (with labels and metadata)
`public static Function<Context, Context> mark(Map<String, Object> metadata)` static	设置该参数。 Mark current Agent call for training (metadata only)
`public static` `TrainingAnnotation getCurrent(ContextView reactorContext)` static	获取当前。 Get the current training marker from Reactor Context.

字段详情Field Detail

REACTOR_KEY

public static final String REACTOR_KEY

staticfinal

REACTOR 键字段。声明为 public static final String REACTOR_KEY。

Reactor Context key for storing training annotations

源码Source io/agentscope/core/training/strategy/TrainingContext.java:65

方法详情Method Detail

mark

public static Function<Context, Context> mark()

static

返回 mark 结果。

Mark current Agent call for training (basic version) Returns Reactor Context write function, must be used via .contextWrite().

返回Returns Function<Context, Context>

返回函数。Reactor Context write function

源码Source io/agentscope/core/training/strategy/TrainingContext.java:81–85

mark

public static Function<Context, Context> mark(String... labels)

static

设置该参数。

Mark current Agent call for training (with labels) Returns Reactor Context write function, must be used via .contextWrite().

参数Parameters

名称Name	类型Type	说明Description
`labels` varargs	String...	labels（类型 `String...`）。Training labels

返回Returns Function<Context, Context>

返回函数。Reactor Context write function

源码Source io/agentscope/core/training/strategy/TrainingContext.java:102–109

mark

public static Function<Context, Context> mark(List<String> labels, Map<String, Object> metadata)

static

执行 mark 方法。

Mark current Agent call for training (with labels and metadata) Returns Reactor Context write function, must be used via .contextWrite().

参数Parameters

名称Name	类型Type	说明Description
`labels`	List<String>	labels（类型 `List`）。Training labels
`metadata`	Map<String, Object>	元数据（类型 `Map`）。Metadata

返回Returns Function<Context, Context>

返回函数。Reactor Context write function

源码Source io/agentscope/core/training/strategy/TrainingContext.java:130–138

mark

public static Function<Context, Context> mark(Map<String, Object> metadata)

static

设置该参数。

Mark current Agent call for training (metadata only)

参数Parameters

名称Name	类型Type	说明Description
`metadata`	Map<String, Object>	元数据（类型 `Map`）。Metadata

返回Returns Function<Context, Context>

返回函数。Reactor Context write function

源码Source io/agentscope/core/training/strategy/TrainingContext.java:146–148

getCurrent

public static TrainingAnnotation getCurrent(ContextView reactorContext)

static

获取当前。

Get the current training marker from Reactor Context.

参数Parameters

名称Name	类型Type	说明Description
`reactorContext`	ContextView	reactor 上下文（类型 `ContextView`）。Reactor context

返回Returns TrainingAnnotation

返回TrainingAnnotation。TrainingAnnotation if present, null otherwise

源码Source io/agentscope/core/training/strategy/TrainingContext.java:156–163