id="content_views">

1.定义

1. 定义一个工具
2. 把工具注册进去

MCP

Model

够以结构化的⽅式与外部⼯具和资源进⾏交互。

该协议⽀持多种传输机制，以在不同环境中提供灵活

模型更顺畅⼯作的桥梁和助⼿。

2.快速入门（获取当前时间）

2.1导包

org.springframework.bootspring-boot-starter-weborg.springframework.aispring-ai-starter-model-openai

2.2配置yml文件

ai-siliconflow-mcp-glmai:openai:base-url:

https://api.siliconflow.cnapi-key:

sk-rlpneielwjrtbzwghvmtnkrfzsqoorkclubnimumojlptvqzchat:options:model:

0.7

class="language-java">@Configuration

public

openAiChatModel;@Bean("openAiChatClient")public

ChatClient

openAiChatClient(Wea***rJiaService

wea***rJiaService,

ChatClient.builder(openAiChatModel).build();}

}

com.jiazhong.mingxing.ai.siliconflow.mcp.glm.service;

import

org.springframework.stereotype.Service;

@Service

{log.info("开始调用获取当前时间的工具......");SimpleDateFormat

simpleDateFormat=new

class="language-java">@Configuration

public

openAiChatModel;@Resourceprivate

NowDateToolService

nowDateToolService;@Bean("openAiChatClient")public

ChatClient

openAiChatClient(Wea***rJiaService

wea***rJiaService,

ChatClient.builder(openAiChatModel).defaultTools(nowDateToolService).build();}

}

class="language-java">@GetMapping(value

"/stream",produces

"text/html;charset=utf-8")public

Flux

stream(@RequestParam("question")

String

openAiChatClient.prompt().user(question).stream().content();}

2.8配置启动类

并在浏览器中问关于时间的问题，会给出系统时间

alt=""

src="https://i-blog.csdnimg.cn/direct/c0552ef5305b445fb213e0e9269e6984.png"

width="1488">

3.采取行动

在前⾯的示例中，我们使⽤了⼀个⼯具来确定当前⽇期和时间。

在这个例⼦中，我们将定义第⼆个⼯

具，⽤于在特定时间设置警报。

⽬标是从现在开始设置10分钟的警报，因此我们需要为模型提供这两

DateTimeToolsService

格式的时间。

然后，该⼯具将向控制台打印⼀条消息，指示已在给定时间内设置报警。

与

之前⼀样，该⼯具被定义为⼀个⽤

class="language-java">@Tool(description

"设置一个时间报警器")public

setAlarm(@ToolParam(description

"当前系统时间")

time){log.info("时间是：{}",time);LocalDateTime

localDateTime=LocalDateTime.parse(time);log.info("转换后的时间:{}",localDateTime);}

4.方法即工具

4.1声明式

您可以通过使⽤

@tool

对⽅法进⾏注释，将其转化为⼯具。

如上述入门案例所示。

@Tool

注释允许您提供有关⼯具的关键信息：

• name

  模型在调⽤⼯具时使⽤此名称来

  标识⼯具。

  因此，不允许在同⼀类中有两个同名⼯具。

  对于特定的聊天请求，该名称在模型可

  style="color:

  1)">（可以不写）

• description

  ：⼯具的描述，模型可以使⽤它来了解何时以及如何调⽤⼯具。

  如果没有提

  供，⽅法名称将⽤作⼯具描述。

  然⽽，强烈建议提供详细的描述，因为这对于模型理解⼯具的

  ⽬的以及如何使⽤它⾄关重要。

  如果不能提供⼀个好的描述，可能会导致模型在应该使⽤的时

  style="color:

  1)">（要写）

• returnDirect

  ：⼯具结果是应该直接返回给客户端还是传递回模型。

• resultConverter

  String

  还是可选的。

  默认情况下，所有输⼊参数都被认为是必需的。

  4.2编程式

  4.2.1在controller中

  "text/html;charset=utf-8")public

  Flux

  stream2(@RequestParam("question")

  String

  ReflectionUtils.findMethod(NowDateToolService.class,"getNowDate");//开始创建工具ToolDefinition

  toolDefinition

  ToolDefinitions.builder(method).description("获取⽤户时区中的当前时间").name("getCurrentDateTime2").build();//开始注册工具MethodToolCallback

  methodToolCallback

  MethodToolCallback.builder().toolDefinition(toolDefinition).toolMethod(method).toolObject(nowDateToolService)

  必须是DateTimeToolsService类的实例.build();return

  openAiChatClient.prompt().toolCallbacks(methodToolCallback).user(question).stream().content();}

  删掉serviceImp中的@Tool注解即可实现。

  5.函数即工具

  SpringAI

  FunctionToolCallback

  。

  5.1函数工具的回调

  案例--查看城市天气（假的）

  5.1.1bean包下写Wea***r类

  定义两个实体类

  com.jiazhong.mingxing.ai.siliconflow.mcp.glm.bean;

  public

  com.jiazhong.mingxing.ai.siliconflow.mcp.glm.service;

  import

  com.jiazhong.mingxing.ai.siliconflow.mcp.glm.bean.Wea***r;

  import

  org.springframework.stereotype.Service;

  import

  Function

  }

  com.jiazhong.mingxing.ai.siliconflow.mcp.glm.service.impl;

  import

  com.jiazhong.mingxing.ai.siliconflow.mcp.glm.bean.Wea***r;

  import

  com.jiazhong.mingxing.ai.siliconflow.mcp.glm.service.Wea***rJiaService;

  import

  org.springframework.stereotype.Service;

  @Service

  {@Override//因为Wea***rRequest是内部类，在Wea***r类中，所以要使用Wea***r.Wea***rRequestpublic

  wea***rRequest)

  ("西安".equals(wea***rRequest.city())){return

  new

  Wea***r.Wea***rResponse(30.1);}else

  ("宝鸡".equals(wea***rRequest.city())){return

  new

  Wea***r.Wea***rResponse(25.4);}else

  ("漠河".equals(wea***rRequest.city())){return

  new

  Wea***r.Wea***rResponse(-27.9);}return

  new

  5.1.4controller类（局部写法）

  class="language-java">@GetMapping(value

  "stream3",produces

  "text/html;charset=utf-8")public

  Flux

  stream3(@RequestParam("question")

  String

  question){FunctionToolCallback

  toolCallback=FunctionToolCallback.builder("wea***rJiaServiceImpl",wea***rJiaService).description("获取到指定位置的天气").inputType(Wea***r.Wea***rRequest.class).build();return

  openAiChatClient.prompt().toolCallbacks(toolCallback).user(question).stream().content();}

  class="language-java">@Bean("openAiChatClient")public

  ChatClient

  openAiChatClient(Wea***rJiaService

  wea***rJiaService,

  amapSrvice){FunctionToolCallback

  toolCallback=FunctionToolCallback.builder("wea***rJiaServiceImpl",wea***rJiaService).description("获取到执行位置的天气").inputType(Wea***r.Wea***rRequest.class).build();return

  ChatClient.builder(openAiChatModel).defaultTools(wea***rJiaService)/*.defaultToolNames("currentWea***r","currentDressing")*/.defaultTools(toolCallback).build();}

  5.2@Bean

  动态规范

  5.2.1新建ToolConfig类

  com.jiazhong.mingxing.ai.siliconflow.mcp.glm.config;

  import

  com.jiazhong.mingxing.ai.siliconflow.mcp.glm.bean.Wea***r;

  import

  com.jiazhong.mingxing.ai.siliconflow.mcp.glm.service.DressingService;

  import

  com.jiazhong.mingxing.ai.siliconflow.mcp.glm.service.Wea***rJiaService;

  import

  org.springframework.beans.factory.annotation.Autowired;

  import

  org.springframework.context.annotation.Bean;

  import

  org.springframework.context.annotation.Configuration;

  import

  wea***rJiaService;@Resourceprivate

  DressingService

  dressingService;@Bean("currentWea***r")public

  Function

  wea***r(){return

  wea***rJiaService;}@Bean("currentDressing")public

  Function

  dressing(){return

  }

  5.2.2写ChatClientController

  @Bean("openAiChatClient")public

  ChatClient

  openAiChatClient(Wea***rJiaService

  wea***rJiaService,

  amapSrvice){/*FunctionToolCallback

  toolCallback=FunctionToolCallback.builder("wea***rJiaServiceImpl",wea***rJiaService).description("获取到执行位置的天气").inputType(Wea***r.Wea***rRequest.class).build();*/return

  ChatClient.builder(openAiChatModel)/*.defaultTools(currentWea***r)*/.defaultToolNames("currentWea***r")/*

  .defaultTools(amapSrvice)*/.build();}