org.noear.solon.ai.chat.skill

类 SkillDesc

java.lang.Object

org.noear.solon.ai.chat.skill.SkillDesc

所有已实现的接口:

Skill

@Preview(value="3.8.4")
public class SkillDesc
extends java.lang.Object
implements Skill

技能描述实现类（提供流式构建支持）

查询示例：

 Skill weatherSkill = SkillDesc.builder("weather")
     .description("查询实时天气和预报")
     .isSupported("天气", "气温") // 关键词匹配
     .instruction("查询天气时，如果用户没说城市，默认查杭州。") // 静态指令
     .toolAdd(new WeatherTools()) // 挂载工具
     .build();
 

从以下版本开始:

3.8.4

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	SkillDesc.Builder

构造器概要

构造器

构造器和说明
SkillDesc(SkillMetadata metadata, java.util.function.Function<Prompt,java.lang.Boolean> isSupportedHandler, java.util.function.Function<Prompt,java.lang.String> getInstructionHandler, java.util.function.Consumer<Prompt> onAttachHandler, java.util.function.Function<Prompt,java.util.Collection<FunctionTool>> getToolsHandler)

方法概要

限定符和类型	方法和说明
static SkillDesc.Builder	builder(java.lang.String name)
java.lang.String	description() 获取技能描述
java.lang.String	getInstruction(Prompt prompt) 动态指令注入：生成并注入到 System Message 的描述性文本（如果使用 MD 层级，从第三级开始） 用于约束 AI 如何使用该技能下的工具
java.util.Collection<FunctionTool>	getTools(Prompt prompt) 动态工具注入：获取该技能挂载的所有功能工具
boolean	isSupported(Prompt prompt) 准入检查：决定该技能在当前对话上下文中是否被激活
SkillMetadata	metadata() 获取技能元信息
java.lang.String	name() 获取技能名称（默认类名）
void	onAttach(Prompt prompt) 挂载钩子：技能被激活时触发 可用于初始化会话状态、审计日志记录或上下文预处理

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

SkillDesc

public SkillDesc(SkillMetadata metadata,
                 java.util.function.Function<Prompt,java.lang.Boolean> isSupportedHandler,
                 java.util.function.Function<Prompt,java.lang.String> getInstructionHandler,
                 java.util.function.Consumer<Prompt> onAttachHandler,
                 java.util.function.Function<Prompt,java.util.Collection<FunctionTool>> getToolsHandler)

方法详细资料

name

public java.lang.String name()

从接口复制的说明: Skill

获取技能名称（默认类名）

指定者:

name 在接口中 Skill

description

public java.lang.String description()

从接口复制的说明: Skill

获取技能描述

指定者:

description 在接口中 Skill

metadata

public SkillMetadata metadata()

从接口复制的说明: Skill

获取技能元信息

指定者:

metadata 在接口中 Skill

isSupported

public boolean isSupported(Prompt prompt)

从接口复制的说明: Skill

准入检查：决定该技能在当前对话上下文中是否被激活

指定者:

isSupported 在接口中 Skill

参数:

prompt - 当前提示词上下文

返回:

true 表示激活并挂载该技能

onAttach

public void onAttach(Prompt prompt)

从接口复制的说明: Skill

挂载钩子：技能被激活时触发 可用于初始化会话状态、审计日志记录或上下文预处理

指定者:

onAttach 在接口中 Skill

getInstruction

public java.lang.String getInstruction(Prompt prompt)

从接口复制的说明: Skill

动态指令注入：生成并注入到 System Message 的描述性文本（如果使用 MD 层级，从第三级开始） 用于约束 AI 如何使用该技能下的工具

指定者:

getInstruction 在接口中 Skill

getTools

public java.util.Collection<FunctionTool> getTools(Prompt prompt)

从接口复制的说明: Skill

动态工具注入：获取该技能挂载的所有功能工具

指定者:

getTools 在接口中 Skill

builder

public static SkillDesc.Builder builder(java.lang.String name)