票务 Tool接口 / 方法 / 参数【无意义、可读、业务化、参数数量过多】 20260521

• • 接口 / 方法 / 参数必须可读、业务化
    • AI 大模型是通过方法名、参数名、注释 / 描述来理解工具用途的，可读性差会导致它根本不会调用，或者调用时传错参数。
    • 避免乱码、无意义缩写（比如 dsadsa、fdasfda 这种），否则大模型无法理解参数含义。
     
  • 方法参数数量不宜过多
    • 建议单个工具方法的参数 ≤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;
      }
  }

  
  
  
  5、
  5.1

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

   

   

  无意义参数

   

  

   

   

   

   

   

   

   

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