使用SpringAI整合Ollama实现工具链调用功能

 更新时间:2026年05月20日 08:43:34   作者:霸道流氓气质  
文章介绍了SpringAI的ToolCalling能力,允许大模型自主调用外部工具以完成多步骤任务,具体而言,通过@Tool注解标记方法,SpringAI自动解析生成JSONSchema,@Tools注解注册多个工具,模型可自主选择调用顺序和组合,需要的朋友可以参考下

场景

Spring AI 提供了强大的 Tool Calling 能力,允许大模型在对话中自主决定调用哪些外部工具,

并自动组合它们的执行顺序。

这种机制让智能体能够完成复杂的多步骤任务,例如“查询北京天气并用英文回答”

——模型会先调用天气工具获取数据,再调用翻译工具输出英文。

核心概念

概念说明
Tool Calling大模型根据用户问题,生成函数调用请求(含函数名和参数),Spring AI 拦截后执行对应的 Java 方法,将结果返回模型。
@Tool 注解标记在方法上,Spring AI 自动解析方法签名和注释,生成 JSON Schema 供模型理解。
多工具注册通过 defaultTools(...) 同时注册多个工具,模型可自主选择调用顺序和组合。
链式调用模型在一次响应中先后调用多个工具,前一个的输出作为后一个的输入,形成“链”。

实现

pom.xml

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.3.3</version> <!-- 降级为稳定版,解决冲突 -->
    </parent>
    <groupId>com.example</groupId>
    <artifactId>spring-ai-ollama-tool-chain</artifactId>
    <version>1.0</version>
    <properties>
        <java.version>17</java.version>
        <spring-ai.version>1.1.2</spring-ai.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <!-- Spring AI Ollama 核心 -->
        <dependency>
            <groupId>org.springframework.ai</groupId>
            <artifactId>spring-ai-starter-model-ollama</artifactId>
            <version>${spring-ai.version}</version>
        </dependency>
    </dependencies>

application.yml

​
server:
  port: 886
spring:
  ai:
    ollama:
      base-url: http://localhost:11434
      chat:
        model: qwen2.5:7b-instruct
        options:
          temperature: 0.7
          num-ctx: 4096                         # 上下文窗口大小
logging:
  level:
    org.springframework.ai.chat.client: DEBUG   # 查看工具调用详情
​

天气工具

package com.badao.ai.tools;

import org.springframework.ai.tool.annotation.Tool;
import org.springframework.ai.tool.annotation.ToolParam;
import org.springframework.stereotype.Component;

@Component
public class WeatherTool {

    @Tool(name = "get_weather", description = "查询指定城市的实时天气")
    public String getWeather(@ToolParam(description = "城市名称") String city) {
        System.out.println("调用了天气工具");
        // 模拟天气数据
        return String.format("%s当前天气:晴,温度22℃,湿度45%%。", city);
    }
}

翻译工具

package com.badao.ai.tools;

import org.springframework.ai.tool.annotation.Tool;
import org.springframework.ai.tool.annotation.ToolParam;
import org.springframework.stereotype.Component;

@Component
public class TranslateTool {

    @Tool(name = "translate_to_english", description = "将中文文本翻译成英文")
    public String translate(@ToolParam(description = "待翻译的中文文本") String text) {
        System.out.println("调用了翻译工具");
        // 模拟翻译,实际可接入翻译API
        return "Translated: " + text + " (This is the English version.)";
    }
}

工具注册配置类

package com.badao.ai.config;

import com.badao.ai.tools.WeatherTool;
import com.badao.ai.tools.TranslateTool;
import org.springframework.ai.chat.client.ChatClient;
import org.springframework.ai.chat.model.ChatModel;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class ToolConfig {

    @Bean
    public ChatClient chatClient(ChatModel chatModel,
                                 WeatherTool weatherTool,
                                 TranslateTool translateTool) {
        return ChatClient.builder(chatModel)
                .defaultTools(weatherTool, translateTool)   // 注册天气和翻译工具
                .build();
    }
}

Agent 服务层

package com.badao.ai.service;

import org.springframework.ai.chat.client.ChatClient;
import org.springframework.stereotype.Service;

@Service
public class AgentService {

    private final ChatClient chatClient;

    public AgentService(ChatClient chatClient) {
        this.chatClient = chatClient;
    }

    public String ask(String question) {
        return chatClient.prompt()
                .user(question+ "(请先用天气工具,再用翻译工具)")
                .call()
                .content();
    }
}

控制器

package com.badao.ai.controller;

import com.badao.ai.service.AgentService;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/api")
public class AgentController {

    private final AgentService agentService;

    public AgentController(AgentService agentService) {
        this.agentService = agentService;
    }

    @PostMapping("/agent")
    public String ask(@RequestBody String question) {
        return agentService.ask(question);
    }
}

测试

测试单工具

测试工具链

以上就是使用SpringAI整合Ollama实现工具链调用功能的详细内容,更多关于SpringAI Ollama工具链调用的资料请关注脚本之家其它相关文章!

相关文章

  • Java实现数组转字符串及字符串转数组的方法分析

    Java实现数组转字符串及字符串转数组的方法分析

    这篇文章主要介绍了Java实现数组转字符串及字符串转数组的方法,结合实例形式分析了Java字符串及数组相关的分割、遍历、追加等操作技巧,需要的朋友可以参考下
    2018-06-06
  • java异步方式实现登录

    java异步方式实现登录

    这篇文章主要为大家详细介绍了java异步方式实现登录的相关资料,感兴趣的朋友可以参考一下
    2016-05-05
  • MybatisPlus调用原生SQL的实现方法

    MybatisPlus调用原生SQL的实现方法

    本文主要介绍了MybatisPlus调用原生SQL的实现方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-02-02
  •  java中StopWatch的使用详解

     java中StopWatch的使用详解

    本文主要介绍了 java中StopWatch的使用详解,stopWatch使用它可直观的输出代码执行耗时,以及执行时间百分比,非常具有实用价值,需要的朋友可以参考下
    2023-05-05
  • SpringCloud通过Feign传递List类型参数方式

    SpringCloud通过Feign传递List类型参数方式

    这篇文章主要介绍了SpringCloud通过Feign传递List类型参数方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-03-03
  • Java基础教程之八大基本数据类型

    Java基础教程之八大基本数据类型

    这篇文章主要给大家介绍了关于Java基础教程之八大基本数据类型的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面来一起学习学习吧
    2019-06-06
  • Spring Boot2中如何优雅地个性化定制Jackson实现示例

    Spring Boot2中如何优雅地个性化定制Jackson实现示例

    这篇文章主要为大家介绍了Spring Boot2中如何优雅地个性化定制Jackson实现示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-05-05
  • Java开发实现的Socket双向通信功能示例

    Java开发实现的Socket双向通信功能示例

    这篇文章主要介绍了Java开发实现的Socket双向通信功能,结合实例形式分析了java基于socket实现的服务器端与客户端双向通信相关操作技巧,需要的朋友可以参考下
    2018-01-01
  • Spring基于常用AspectJ切点表达式使用介绍

    Spring基于常用AspectJ切点表达式使用介绍

    AspectJ是一个基于Java语言的AOP框架,使用AspectJ需要导入Spring AOP和AspectJ相关jar包,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-12-12
  • 浅谈JSON的数据交换、缓存问题和同步问题

    浅谈JSON的数据交换、缓存问题和同步问题

    这篇文章主要介绍了浅谈JSON的数据交换、缓存问题和同步问题,具有一定借鉴价值,需要的朋友可以参考下
    2017-12-12

最新评论