Solon v3.8.3

simple - SimpleAgent 简单直接

</> markdown
2026年1月14日 下午2:25:46

SimpleAgent 是 Solon AI 智能体家族中最轻量级的成员。它采用了“直接指令执行”模式,将复杂的 LLM 交互抽象为简单的函数调用。

它最适合以下场景:

  • 确定性任务:如翻译、润色、格式转换。
  • 低延迟交互:无需多轮思考过程,追求最快响应。
  • 作为组件集成:在大型业务系统中作为“智能化处理插件”使用。

1、核心特性

  • 极简编程界面:一行代码即可发起智能体调用。
  • 内置状态管理:自动处理 Chat History,支持多轮对话。
  • 工具无缝挂载:支持通过 ToolMapping 注解将本地 Java 方法直接变为智能体可用的工具。
  • 高性能/低开销:去除了复杂的推理循环(Thought),直接进行 Action 和 Answer。

2、快速上手

A. 基础调用 只需配置好 ChatModel,即可快速创建一个具备特定角色的智能体。

// 1. 定义智能体
SimpleAgent agent = SimpleAgent.of(chatModel)
        .name("Translator")
        .systemPrompt(SimpleSystemPrompt.builder()
                .role("你是一个中英文翻译助手")
                .instruction("请直接输出翻译结果,不要输出任何解释。")
                .build())
        .build();

// 2. 发起对话
String result = agent.prompt("请把:'Life is short, use Python' 翻译成中文").call().getContent();
System.out.println(result); // 人生苦短,我用 Python

B. 挂载本地工具 通过 ToolMapping,你可以让智能体具备操作本地系统的能力。

public class MyTools {
    @ToolMapping(description = "获取当前系统时间")
    public String getTime() {
        return LocalDateTime.now().toString();
    }
}

// 构建时注入工具
SimpleAgent agent = SimpleAgent.of(chatModel)
        .toolAdd(new MethodToolProvider(new MyTools()))
        .build();