惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

Martin Fowler
Martin Fowler
D
DataBreaches.Net
F
Fortinet All Blogs
阮一峰的网络日志
阮一峰的网络日志
博客园_首页
Apple Machine Learning Research
Apple Machine Learning Research
H
Help Net Security
M
MIT News - Artificial intelligence
美团技术团队
人人都是产品经理
人人都是产品经理
freeCodeCamp Programming Tutorials: Python, JavaScript, Git & More
Cyber Security Advisories - MS-ISAC
Cyber Security Advisories - MS-ISAC
The Cloudflare Blog
有赞技术团队
有赞技术团队
L
LangChain Blog
博客园 - Franky
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
博客园 - 【当耐特】
S
SegmentFault 最新的问题
V
Visual Studio Blog
Blog — PlanetScale
Blog — PlanetScale
Hugging Face - Blog
Hugging Face - Blog
B
Blog
I
InfoQ

博客园 - cn2025

K8s -sentinel-dashboard【nacos版本】集 20260815 kubeSphere【ks-controller-manager-webhook-cert】证书 20260814 K8s -nacos集 20260813 K8s - 安装部署redis集群-哨兵sentinels集(支持从K8s外部访问)20260812 k8s-deployment发布测试(pv-pvc-deployment-service) 20260810 K8s - 安装部署Kafka、Zookeeper集群教程(支持从K8s外部访问)20260808 k8s-关机及启动脚本工具 【kubeSphere发布ruoyi-pro前端】工具脚本20260731 【k8s】 etcd服务端及客户端版本及快照【定时】备份 20260730 harbor【https启用】及k8节点部证书20260728 kube-flannel.yml k8s集群-安装helm 【kubeShpere】 官网 20260710 kubesphere-KDP 工具脚本【kubeSphere发布ruoyi-pro前端】20260720 HbuilderX 内置终端转为 gitBash 20260720 kubeSphere发布ruoyi-pro后端-用到脚本 kubeSphere发布ruoyi-web前端 20260711 kubeSphere发布ruoyi-pro后端 k8s集群-kubeShpere 20260710 安装Helm 20260710 k8s-portainer docker 镜像查询 k8集群一键重置 docker run OceanBase spring ai alibaba doc AI2.0 【多模态】 20260615 世界只有一个墨脱 AI2.0 【Mcp-client】 20260611 AI2.0 【Mcp-server】 20260611 GoLand 配Go SDK
票务 Tool接口 / 方法 / 参数【无意义、可读、业务化、参数数...
cn2025 · 2026-05-22 · via 博客园 - cn2025
    • 接口 / 方法 / 参数必须可读、业务化
      • AI 大模型是通过方法名、参数名、注释 / 描述来理解工具用途的,可读性差会导致它根本不会调用,或者调用时传错参数。
      • 避免乱码、无意义缩写(比如 dsadsafdasfda 这种),否则大模型无法理解参数含义。
    • 方法参数数量不宜过多
      • 建议单个工具方法的参数 ≤5 个,参数越多,大模型越难正确理解和填充,出错率指数级上升。

1、pom

  • <properties>
    <java.version>17</java.version>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
    <spring-boot.version>3.2.0</spring-boot.version>
    <spring-ai.version>1.0.0</spring-ai.version>
    <spring-ai-alibaba.version>1.0.0.2</spring-ai-alibaba.version>
    <jedis.version>5.2.0</jedis.version>
    </properties>
    <dependencies>
    <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <!-- 阿里云通义千问(DashScope)starter -->
    <dependency>
    <groupId>com.alibaba.cloud.ai</groupId>
    <artifactId>spring-ai-alibaba-starter-dashscope</artifactId>
    </dependency>
    <!--对话记忆 chat-memory-->
    <dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-autoconfigure-model-chat-memory</artifactId>
    </dependency>
    </dependencies>
    <dependencyManagement>
    <dependencies>
    <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-dependencies</artifactId>
    <version>${spring-boot.version}</version>
    <type>pom</type>
    <scope>import</scope>
    </dependency>
    <!-- 统一管理Spring AI依赖版本 -->
    <dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-bom</artifactId>
    <version>${spring-ai.version}</version>
    <type>pom</type>
    <scope>import</scope>
    </dependency>
    <dependency>
    <groupId>com.alibaba.cloud.ai</groupId>
    <artifactId>spring-ai-alibaba-bom</artifactId>
    <version>${spring-ai-alibaba.version}</version>
    <type>pom</type>
    <scope>import</scope>
    </dependency>
    </dependencies>
    </dependencyManagement>
    <!-- Spring AI 里程碑/快照仓库(必须配置,否则依赖无法下载) -->
    <repositories>
    <repository>
    <id>spring-milestones</id>
    <name>Spring Milestones</name>
    <url>https://repo.spring.io/milestone</url>
    <snapshots>
    <enabled>false</enabled>
    </snapshots>
    </repository>
    <repository>
    <id>spring-snapshots</id>
    <name>Spring Snapshots</name>
    <url>https://repo.spring.io/snapshot</url>
    <releases>
    <enabled>false</enabled>
    </releases>
    </repository>
    </repositories>

    2、yml

    server:
    port: 18086
    spring:
    ai:
    dashscope:
    api-key: sk-8718a83408d7443xxxxxxxxx
    3、service
    import org.springframework.stereotype.Service;

    //票务服务
    @Service
    public class TicketService {

    //退票
    public void cancel(String ticketNumber, String name) {
    // 实际业务逻辑:调用数据库/API执行退票
    System.out.println("退票成果");
    }
    }

     
    import org.springframework.ai.tool.annotation.Tool;
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.stereotype.Service;

    @Service
    public class ToolService {

    @Autowired
    private TicketService ticketService;

    record cancelParam(String dsadsa,String fdasfda){}

    @Tool(description = "退票")
    public String cancel(cancelParam param) {
    ticketService.cancel(param.dsadsa(), param.fdasfda());
    return "退票成功!";
    }

    // record cancelParam(String mmmmmmmmmmqweqweqw,String oooooooooodsfsdds){}
    //
    // // @Tool告诉大模型提供了什么工具
    // @Tool(description = "根据订单号和乘客姓名办理机票退票业务,退票成功后会返还票款")
    // public String cancel(
    // //@ToolParam告诉大模型参数描述
    // cancelParam param) {
    // //先查询--->先校验
    // ticketService.cancel(param.mmmmmmmmmmqweqweqw(), param.oooooooooodsfsdds());
    // return "退票成功!";
    // }

    // record cancelParam(String ticketNumber,String name){}
    //
    // // @Tool告诉大模型提供了什么工具
    // @Tool(description = "退票")
    // public String cancel(
    // //@ToolParam告诉大模型参数描述
    // cancelParam param) {
    // //先查询--->先校验
    // ticketService.cancel(param.ticketNumber(), param.name());
    // return "退票成功!";
    // }

    // // @Tool告诉大模型提供了什么工具
    // @Tool(description = "退票")
    // public String cancel(
    // //@TooLParam告诉大模型参数的描述 加严参数描述与校验
    // @ToolParam(description = "预定号,可以是纯数字") String ticketNumber,
    // @ToolParam(description = "真实人名(必填,必须为人的真实姓名,严禁用其他信息代替如缺失请传null)") String name) {
    // // 后端代码加强校验和兜底保护
    // //先查询--->先校验
    // ticketService.cancel(ticketNumber, name);
    // return "退票成功!";
    // }

    }

    
    

    4、controller
    import com.sb.dashscope18086.service.ToolService;
    import org.springframework.ai.chat.client.ChatClient;
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.stereotype.Controller;
    import org.springframework.web.bind.annotation.GetMapping;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RequestParam;
    import org.springframework.web.bind.annotation.ResponseBody;

    /**
    * @author Administrator
    */
    @RequestMapping("/openai")
    @ResponseBody
    @Controller
    public class ChatclientToolController {

    @Autowired
    private ChatClient.Builder chatClientBuilder;
    //
    @Autowired
    private ToolService toolService;

    // ChatClient chatClient;
    //
    // public ChatclientToolController(ChatClient.Builder chatClientBuilder, ToolService toolService) {
    // chatClient= chatClientBuilder
    // .defaultTools(toolService)
    // .build();
    // }

    @GetMapping("/simple/tool5")
    public String tool5(
    @RequestParam(value = "message",
    defaultValue = "讲个笑话") String message
    ) {
    // // 构建ChatClient并调用
    ChatClient chatClient = chatClientBuilder
    //
    //系统Prompt设定限制
    .build();
    String content = chatClient.prompt()
    .user(message)
    .tools(toolService)//用 .tools() 替代 defaultTools()
    .call()
    .content();

    System.out.println(content);
    return content;
    }
    }

    
    

      http://localhost:18086/openai/simple/tool5?message=退票,12131231.李奇

    无意义参数

    image

    5.2
    http://localhost:18086/openai/simple/tool5?message=退票,12131231.李奇

    image

     

posted on 2026-05-22 10:35  cn2025  阅读(7)  评论()    收藏  举报