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


它最适合以下场景：

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


### 1、核心特性

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



### 2、快速上手


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



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

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


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


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

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