Spring AI Alibaba 核心组件

Spring AI Alibaba 核心组件

Tools（工具）

工具创建

创建工具需要实现BiFunction<String, ToolContext, String>接口方法。

接口方法说明

接口中包含两个核心方法：

1. apply方法（核心方法）

   • 参数：String s- 通常是用户输入的参数
   • 参数：ToolContext toolContext- 工具上下文，包含调用时的元数据、配置等
   • 返回值：String- 处理结果

2. andThen方法（链式调用）

   • 用于链式调用，可以继续添加后续处理工具
   • 通常是默认实现

工具调用示例

// 基本工具调用ToolCallbacksearchTool=FunctionToolCallback.builder("weather",poeticWeatherTool).inputType(String.class).description("天气查询工具").build();

⚠️ 注意：inputType必须要定义

链式工具创建

如果需要用到andThen方法，在创建工具调用时使用andThen创建链式工具：

WeatherToolweatherTool=newWeatherTool();// 显式调用 andThen，传入后置处理函数BiFunction<String,ToolContext,String>poeticWeatherTool=weatherTool.andThen(result->{// 可以在这里二次处理结果returnresult;});

完整使用流程

1. 实现BiFunction<String, ToolContext, String>接口创建工具类
2. 使用andThen方法进行链式处理（可选）
3. 通过FunctionToolCallback.builder()构建工具回调
4. 必须指定inputType
5. 添加描述信息便于理解和使用

System Prompt（系统提示）

两种用法

1. systemPrompt

   • 使用场景：个性化、场景化适配

2. instruction

   • 使用场景：通用角色定义
   • 优先级：instruction > systemPrompt

动态系统提示词

动态的系统提示词是通过ModelInterceptor（模型拦截器）来实现的：

• 可以追加到原有的提示词后面
• 也可以覆盖原有的提示词

ModelInterceptor 接口方法

ModelInterceptor 包含两个核心方法：

1. interceptModel

   • 拦截模型，实现动态系统提示词
   • 除了实现动态提示词，还可以实现其他功能
   • 例如：日志记录、权限控制等

2. getName

   • 获取拦截器名称

Agent 执行方法

核心执行方法

常用的两个方法：invoke和call

• 两者都是触发 Agent 执行的方法
• invoke方法可以调用到 Agent 的历史记录等多种信息

核心应用场景

• 多轮对话
• 复杂工作流
• 工具调用
• 状态管理

RunnableConfig 配置对象

RunnableConfig 是配置对象，常用方法包括：

1. threadId

   • 设置线程ID

2. addMetadata

   • 添加元数据
   • 增量添加运行时上下文信息

结构化输出

outputType 和 outputSchema 比较

outputSchema 转化

⚠️ 注意：outputSchema需要通过Be