工具无法访问 Agent 运行时上下文

[niceliangfan]

工具无法通过 ToolContext 访问 Agent 运行时上下文。
工具代码如下：

public class UserFunction implements BiFunction<UserFunction.Request, ToolContext, UserFunction.Response> {

    Logger logger = LoggerFactory.getLogger(UserFunction.class);

    @Override
    public Response apply(Request request, ToolContext toolContext) {
        logger.info("toolContext: {}", JSON.toJSONString(toolContext));
        OverAllState state = (OverAllState) toolContext.getContext().get("state");
        RunnableConfig config = (RunnableConfig) toolContext.getContext().get("config");
        logger.info("state:{}, config:{}", JSON.toJSONString(state), JSON.toJSONString(config));

        // 具体实现省略
        return new Response("用户信息不存在");
    }

    public record Request() {}

    public record Response(String message) {}
}

自定义 ToolInterceptor 代码如下：

public class MonitoringToolInterceptor extends ToolInterceptor {

    Logger logger = LoggerFactory.getLogger(MonitoringToolInterceptor.class);

    @Override
    public ToolCallResponse interceptToolCall(ToolCallRequest request, ToolCallHandler handler) {
        logger.info("interceptToolCall...");
        logger.info("toolCallRequest: {}", JSON.toJSONString(request));
        ToolCallResponse response = handler.call(request);
        logger.info("toolCallResponse: {}", JSON.toJSONString(response));
        return response;
    }

    @Override
    public String getName() {
        return "monitoringToolInterceptor";
    }

}

智能体代码如下：

ToolCallback userToolCallback = FunctionToolCallback.builder("userFunction", new UserFunction())
        .description("获取用户信息")
        .inputType(UserFunction.Request.class)
        .build();

ReactAgent agent = ReactAgent.builder()
        .name("simpleAgent")
        .model(chatModel)
        .systemPrompt("You are a helpful assistant.")
        .tools(userToolCallback)
        .interceptors(new MonitoringToolInterceptor())
        .build();

RunnableConfig config = RunnableConfig.builder()
        .addMetadata("userId", "1")
        .build();
return agent.call(content, config).getText();

通过 自定义的 ToolInterceptor 可以看到 Agent 的上下文中是有用户ID，然而 ToolContext 打印却什么也没有。

2025-12-06T23:38:07.599+08:00  INFO 9664 --- [ali-agent] [nio-8101-exec-2] c.l.a.i.MonitoringToolInterceptor        : interceptToolCall...
2025-12-06T23:38:07.603+08:00  INFO 9664 --- [ali-agent] [nio-8101-exec-2] c.l.a.i.MonitoringToolInterceptor        : toolCallRequest: {"arguments":"{}","context":{"_stream_":false,"_AGENT_":"simpleAgent","userId":"1"},"toolCallId":"call_3e61203b5fa943a3aca45da6","toolName":"userFunction"}
2025-12-06T23:38:07.618+08:00  INFO 9664 --- [ali-agent] [nio-8101-exec-2] c.liangfan.aliagent.tools.UserFunction   : toolContext: {"context":{"_AGENT_CONFIG_":{},"_AGENT_STATE_":{},"_AGENT_STATE_FOR_UPDATE_":{}}}
2025-12-06T23:38:07.618+08:00  INFO 9664 --- [ali-agent] [nio-8101-exec-2] c.liangfan.aliagent.tools.UserFunction   : state:null, config:null
2025-12-06T23:38:07.622+08:00  INFO 9664 --- [ali-agent] [nio-8101-exec-2] c.l.a.i.MonitoringToolInterceptor        : toolCallResponse: {"metadata":{},"result":"{\"message\":\"用户信息不存在\"}","toolCallId":"call_3e61203b5fa943a3aca45da6","toolName":"userFunction"}