Java + AI 应用入门

AI Agent 入门:工具调用、执行循环与停止条件

区分固定工作流和 Agent,用预设决策演示工具白名单与步数上限,不把模拟循环当成模型实测。

Agent 系统让模型在任务过程中决定下一步行动,并结合工具结果继续处理。固定代码顺序调用几个接口,可以是有效工作流;仅仅接入聊天或列出“规划、记忆、工具”几个模块,还不能说明系统已经具备可靠的自主执行能力。

区分工作流、工具调用与 Agent

按照 Anthropic 文章中的区分,工作流沿预设代码路径编排模型和工具,Agent 则由模型动态决定处理过程和工具使用。这是一种工程分类,并非所有产品统一采用的术语。

应用通常要把工具定义、模型提出的调用、参数校验和实际执行分别处理。模型提出“删除文件”不等于 Java 程序已经获得执行授权。返回工具结果后,还要决定继续、结束或转人工处理。

记忆也需要区分:当前请求携带的消息属于上下文;跨会话保存的摘要或记录属于应用存储。保存下来不保证下一次自动检索,也不保证模型会正确使用。

先实现可以停止的工具循环

下面用预设字符串代替模型决策,只允许读取一份本地说明。步数上限设为 2,第三个决策不会执行。这段程序演示执行层的边界,没有调用模型,不是 Agent 的完整实现。

package site;

import java.util.ArrayList;
import java.util.List;
import java.util.Map;
import java.util.function.Supplier;

/** Scripted decisions demonstrate an execution boundary; no model is called. */
public final class BoundedToolLoop {
  public static List<String> run(List<String> decisions, int maxSteps,
      Map<String, Supplier<String>> tools) {
    if (maxSteps <= 0) throw new IllegalArgumentException("Invalid step budget");
    var trace = new ArrayList<String>();
    int steps = 0;
    for (String decision : decisions) {
      if (steps++ >= maxSteps) { trace.add("STOP: step budget"); return List.copyOf(trace); }
      if ("finish".equals(decision)) { trace.add("DONE"); return List.copyOf(trace); }
      var tool = tools.get(decision);
      if (tool == null) { trace.add("DENIED: " + decision); return List.copyOf(trace); }
      trace.add(decision + " -> " + tool.get());
    }
    trace.add("STOP: decisions exhausted");
    return List.copyOf(trace);
  }

  public static void main(String[] args) {
    run(List.of("read-doc", "read-doc", "finish"), 2,
        Map.of("read-doc", () -> "local note")).forEach(System.out::println);
  }
}

下载完整示例工程,解压进入 core 目录,使用 JDK 21 和 Maven 3.9.9 运行:

mvn package dependency:copy-dependencies -DincludeScope=runtime
java -cp 'target/classes:target/dependency/*' site.BoundedToolLoop

首次构建需要下载公开依赖。命令使用 macOS/Linux 类路径分隔符;Windows 未在本轮验证。 本轮容器运行输出:

read-doc -> local note
read-doc -> local note
STOP: step budget

finish 在列表里,但因为达到步数上限,程序先停止。将决策改为未列入工具表的 delete,会返回 DENIED,不会把任意字符串交给 shell 执行。

步数上限控制的是调用次数,并不能终止一个已经阻塞的工具。真实系统还需要单工具超时、参数范围、身份与权限、幂等处理及审计;有副作用的操作应在执行前落实相应授权。模型提示词不能代替这些执行约束。

什么时候先用固定工作流

任务路径清楚、失败条件明确时,可以先使用固定流程,把每一步的输入输出记录下来。只有确实需要模型在多个行动之间选择时,再引入动态循环,并用真实任务评测是否值得增加复杂度。本轮没有验证自主规划、长期记忆、真实工具调用或生产权限系统。

继续学习

返回 Java + AI 应用入门目录