> ## Documentation Index
> Fetch the complete documentation index at: https://javaai.pig4cloud.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 工具调用
Spring AI 中的工具调用使 AI 模型能够与外部工具和服务交互，从而增强其功能。
## 概述
工具调用允许 AI 模型：
* 执行外部函数
* 访问外部服务
* 执行复杂操作
* 与现有系统集成
## 工具类型
执行自定义函数和方法
与外部 API 和服务交互
执行数据库操作
实现自定义工具功能
## 实现
### 基本工具定义
```java theme={"system"}
@Tool
public class CalculatorTool {
@ToolMethod
public double add(double a, double b) {
return a + b;
}
@ToolMethod
public double subtract(double a, double b) {
return a - b;
}
}
```
### 工具注册
```java theme={"system"}
@Configuration
public class ToolConfig {
@Bean
public ToolRegistry toolRegistry() {
return new ToolRegistry()
.register(new CalculatorTool())
.register(new WeatherTool())
.register(new DatabaseTool());
}
}
```
### 在聊天中使用工具
```java theme={"system"}
@Service
public class ChatService {
private final ChatClient chatClient;
private final ToolRegistry toolRegistry;
public ChatService(ChatClient chatClient, ToolRegistry toolRegistry) {
this.chatClient = chatClient;
this.toolRegistry = toolRegistry;
}
public String chat(String message) {
return chatClient.generate(message, toolRegistry);
}
}
```
## 工具类别
### 1. 函数工具
```java theme={"system"}
@Tool
public class MathTool {
@ToolMethod
public double calculate(String expression) {
// 实现
}
}
```
### 2. API 工具
```java theme={"system"}
@Tool
public class WeatherTool {
@ToolMethod
public Weather getWeather(String location) {
// API 调用实现
}
}
```
### 3. 数据库工具
```java theme={"system"}
@Tool
public class DatabaseTool {
@ToolMethod
public List query(String sql) {
// 数据库查询实现
}
}
```
## 配置属性
```properties theme={"system"}
spring.ai.tools.enabled=true
spring.ai.tools.timeout=5000
spring.ai.tools.max-retries=3
spring.ai.tools.cache-enabled=true
```
## 最佳实践
实现工具调用时，请考虑以下最佳实践：
* **错误处理**：实现强大的错误处理
* **安全性**：验证输入并限制访问
* **性能**：优化工具执行
* **监控**：跟踪工具使用情况和性能
* **文档**：记录工具功能和用法
## 高级特性
### 自定义工具实现
```java theme={"system"}
@Component
public class CustomTool implements Tool {
@Override
public String getName() {
return "custom-tool";
}
@Override
public Object execute(Map parameters) {
// 自定义实现
return result;
}
}
```
### 工具监控
监控工具使用情况和性能：
```properties theme={"system"}
management.endpoints.web.exposure.include=tools
management.endpoint.tools.enabled=true
```
## 故障排除
常见问题和解决方案：
1. **工具执行错误**
* 实现适当的错误处理
* 添加重试机制
* 记录详细的错误信息
2. **性能问题**
* 优化工具实现
* 实现缓存
* 使用异步执行
3. **安全问题**
* 验证输入
* 实现访问控制
* 监控工具使用情况
发现文档问题？点击此处直接在 GitHub 上编辑并提交 PR，帮助我们改进文档！