Solon v3.9.3

team - TeamAgen 调用与选项调整

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

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

1、调用时选项调整示例

agent.prompt("帮我分析一下这个项目的代码质量")
     .session(mySession) 
     .options(o -> o.maxTurns(10)          // 增加推理步数
                    .feedbackMode(true)    // 开启反馈模式
                    .temperature(0.7)      // 调整模型温度
                    .skillAdd(new CodingSkill())) // 临时挂载技能
     .call();

2、可用选项说明 (TeamOptionsAmend)

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

A. 运行控制

这些选项直接影响 TeamAgent 回合的深度、容错和逻辑流转。

部分方法说明默认值 / 备注
maxTurns(int)设置最大回合数默认 8。防止 Agent 进入死循环。
retryConfig(int, long)设置重试次数及延迟（毫秒）默认 3次 / 1000ms。
sessionWindowSize(int)设置会话回溯窗口大小默认 8。控制短期记忆的深度。
feedbackMode(boolean)是否开启反馈模式允许 Agent 主动调用 feedback 工具寻求人工介入。
feedbackDescription(fn)自定义反馈工具的描述引导 Agent 什么时候该寻求反馈。

B. 模型基础参数 (ModelOptions)

底层大模型的通用配置。

部分方法说明默认值 / 备注
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)传递终端用户标识用于服务商侧的安全审计

C. 能力挂载 (Tools & Skills)

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

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

D. 扩展与拦截

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