Solon v3.9.3

simple - SimpleAgent 调用与选项调整

</> markdown
2026年1月28日 下午5:16:28

SimpleAgent 的调用采用流式 API 设计，通过 options(Consumer<ModelOptionsAmend>) 可以对单次对话进行深度的行为控制。

1、调用时选项调整示例

agent.prompt("帮我分析一下这个项目的代码质量")
     .session(mySession) 
     .options(o -> o.temperature(0.7)      // 调整模型温度
                    .skillAdd(new CodingSkill())) // 临时挂载技能
     .call();

2、可用选项说明 (ModelOptionsAmend)

选项分为 SimpleAgent 运行控制、模型参数控制、能力挂载（工具/技能） 以及 扩展配置 四大类。

A. 模型基础参数

底层大模型的通用配置。

部分方法说明默认值 / 备注
temperature(double)控制随机性（0.0-2.0）o.temperature(0.5)
max_tokens(long)限制生成的总 Token 数o.max_tokens(2000)
top_p(double)核采样控制o.top_p(0.9)
response_format(map)强制响应格式如 json_object
user(String)传递终端用户标识用于服务商侧的安全审计

B. 能力挂载 (Tools & Skills)

用于动态为当前调用增加或减少“手脚”。

部分方法说明默认值 / 备注
toolAdd(Object)添加本地 Java 对象工具自动扫描 @ToolMapping 注解方法。
toolAdd(FunctionTool)添加函数工具描述实例手动构建的工具描述。
skillAdd(Skill)挂载 AI 技能单元聚合了指令、工具和准入检查。

C. 扩展与拦截

部分方法说明默认值 / 备注
toolContextPut(key, val)注入工具执行上下文会成为 FunctionTool 参数的一部分。
interceptorAdd(interceptor)添加 SimpleInterceptor 拦截器可在推理步骤前后插入自定义审计或修改逻辑。
optionSet(key, val)设置自定义扩展选项用于透传给特定模型参数选项。