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


### 1、调用时选项调整示例


```java
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)`     | 设置自定义扩展选项      |  用于透传给特定模型参数选项。     |