程序包 com.agentsflex.core.model.chat.tool

类 ToolObservabilityInterceptor

java.lang.Object

com.agentsflex.core.model.chat.tool.ToolObservabilityInterceptor

所有已实现的接口:

ToolInterceptor

public class ToolObservabilityInterceptor
extends Object
implements ToolInterceptor

增强版工具可观测性拦截器，支持： - 全局/工具级开关 - JSON 结构化参数与结果 - 自动脱敏敏感字段 - 错误类型分类 - 类型安全结果处理

字段概要

字段

修饰符和类型	字段	说明
private static final int	MAX_JSON_LENGTH_FOR_SPAN
private static final io.opentelemetry.api.metrics.Meter	METER
private static final Pattern	SENSITIVE_KEY_PATTERN
private static final io.opentelemetry.api.metrics.LongCounter	TOOL_CALL_COUNT
private static final io.opentelemetry.api.metrics.LongCounter	TOOL_ERROR_COUNT
private static final io.opentelemetry.api.metrics.DoubleHistogram	TOOL_LATENCY_HISTOGRAM
private static final io.opentelemetry.api.trace.Tracer	TRACER

构造器概要

构造器

构造器	说明
ToolObservabilityInterceptor()

方法概要

修饰符和类型	方法	说明
Object	intercept(ToolContext context, ToolChain chain)	拦截函数调用。
private void	recordError(io.opentelemetry.api.trace.Span span, Exception e, String toolName, long startTimeNanos)
private void	recordMetrics(String toolName, boolean success, String errorType, long startTimeNanos)
private String	redactSensitiveFields(String json)
private String	safeToJson(Object obj)
private String	safeToString(Object obj)

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

TRACER

private static final io.opentelemetry.api.trace.Tracer TRACER

METER

private static final io.opentelemetry.api.metrics.Meter METER

TOOL_CALL_COUNT

private static final io.opentelemetry.api.metrics.LongCounter TOOL_CALL_COUNT

TOOL_LATENCY_HISTOGRAM

private static final io.opentelemetry.api.metrics.DoubleHistogram TOOL_LATENCY_HISTOGRAM

TOOL_ERROR_COUNT

private static final io.opentelemetry.api.metrics.LongCounter TOOL_ERROR_COUNT

MAX_JSON_LENGTH_FOR_SPAN

private static final int MAX_JSON_LENGTH_FOR_SPAN

另请参阅:

• 常量字段值

SENSITIVE_KEY_PATTERN

private static final Pattern SENSITIVE_KEY_PATTERN

构造器详细资料

ToolObservabilityInterceptor

public ToolObservabilityInterceptor()

方法详细资料

intercept

public Object intercept(ToolContext context,
 ToolChain chain)
                 throws Exception

从接口复制的说明: ToolInterceptor

拦截函数调用。

指定者:

intercept 在接口中 ToolInterceptor

参数:

context - 函数调用上下文

chain - 责任链的下一个节点

返回:

函数调用结果

抛出:

Exception - 通常由实际函数或拦截器抛出

safeToJson

private String safeToJson(Object obj)

redactSensitiveFields

private String redactSensitiveFields(String json)

safeToString

private String safeToString(Object obj)

recordMetrics

private void recordMetrics(String toolName,
 boolean success,
 String errorType,
 long startTimeNanos)

recordError

private void recordError(io.opentelemetry.api.trace.Span span,
 Exception e,
 String toolName,
 long startTimeNanos)