chat - Talent 与 Tool 的使用区别

在实际应用中，我们经常需要根据当前用户的 身份（Role）或上下文（Context） 动态分配工具集。例如：普通用户只能查询天气，而管理员可以调用系统重启工具。

Solon AI 通过 Options 动态添加“工具” 和 “才能”展示它们的使用区别。

1、通过 Options 动态添加工具

这种方式最为直接，适合简单的逻辑判断。你可以在每次发起 prompt 请求时，通过 options 配置项实时注入工具。

ChatModel chatModel = ChatModel.of(...).model("...").build();

public void demo(String prompt, String role) {

     chatModel.prompt("今天杭州的天气情况？")
            .options(o -> {
                //添加系统提示词
                o.systemPrompt("你是个天气预报员");
                
                // 根据业务角色，动态注入不同的工具实例
                if("admin".equals(role)) { //在请求时添加（只能在请求时添加）
                    o.toolAdd(new UserTool());
                    o.toolAdd(new AdminTool());
                } else {
                    o.toolAdd(new UserTool());
                }
            }) //添加请求时选项处理
            .call();
}

• 优点：上手快，逻辑直观。
• 缺点：业务判断逻辑耦合在调用层，如果多处用到该逻辑，代码会比较冗余。

2、使用 Solon AI Talent 实现高级解耦（同等效果）

Talent 是对一组“工具”、“系统指令”及其选择逻辑的更高维度封装。通过自定义 Talent，你可以将“根据角色筛选工具”的逻辑隐藏在组件内部，让调用端保持极致简洁。

更多内容请参考：《Solon AI Talents 开发》

第一步：定义 Talent

继承 AbsTalent 并实现 getTools 方法。你可以从 Prompt 的属性中获取上下文信息。

public class AuthControlTalent extends AbsTalent {
    UserTool userTool =  new UserTool();
    AdminTool adminTool =  new AdminTool();
   
    @Override
    public String getInstruction(Prompt prompt) {
        return "你是个天气预报员";
    }
    
    @Override
    public boolean isSupported(Prompt prompt) {
        return prompt.getUserContent().contains("天气"); //提示词中有“天气时”才支持
    }
    
    @Override
    public Collection<FunctionTool> getTools(Prompt prompt) {
        // 从请求上下文中提取角色信息
        String role = prompt.attrAs("role");
        
         if("admin".eq(role)) {
             return Arrays.asList(userTool, adminTool);
          } else {
              return Arrays.asList(userTool);
          }
    }
}

第二步：应用 Talent

你可以选择在 ChatModel 构建时全局挂载。

ChatModel chatModel = ChatModel.of(...).model("...").defaultTalentAdd(new AuthControlTalent()).build();

public void demo(String prompt, String role) {
     chatModel.prompt(Prompt.of("今天杭州的天气情况？").attrPut("role", role))
            .call();
}

或者在单次请求时按需挂载

public void demo(String prompt, String role) {
     chatModel.prompt(Prompt.of("今天杭州的天气情况？").attrPut("role", role))
            .options(o -> {
                o.talentAdd(new UserTalent()); 
            }) 
            .call();
}

3、总结：如何选择？