giuseppe-trisciuoglio/developer-kit / plugins/developer-kit-java/skills/langchain4j-tool-function-calling-patterns
langchain4j-tool-function-calling-patterns
VerifiedProvides and generates LangChain4j tool and function calling patterns: annotates methods as tools with @Tool, configures tool executors, registers tools with AiServices, validates tool parameters, and handles tool execution errors. Use when building AI agents that call tools, define function specifications, manage tool responses, or integrate external APIs with LLM-driven applications.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.2 KB |
| references/advanced-features.md | markdown | 2.3 KB |
| references/core-patterns.md | markdown | 2.2 KB |
| references/error-handling.md | markdown | 2.9 KB |
| references/examples.md | markdown | 16.0 KB |
| references/implementation-patterns.md | markdown | 14.2 KB |
| references/integration-examples.md | markdown | 5.1 KB |
| references/references.md | markdown | 9.3 KB |
| references/setup-configuration.md | markdown | 2.0 KB |
references/core-patterns.md
View on GitHub# Core Patterns
## Basic Tool Definition
Use `@Tool` annotation to define methods as executable tools:
```java
public class BasicTools {
@Tool("Add two numbers")
public int add(@P("first number") int a, @P("second number") int b) {
return a + b;
}
@Tool("Get greeting")
public String greet(@P("name to greet") String name) {
return "Hello, " + name + "!";
}
}
```
## Parameter Descriptions and Validation
Provide clear parameter descriptions using `@P` annotation:
```java
public class WeatherService {
@Tool("Get current weather conditions")
public String getCurrentWeather(
@P("City name or coordinates") String location,
@P("Temperature unit (celsius, fahrenheit)", required = false) String unit) {
// Implementation with validation
if (location == null || location.trim().isEmpty()) {
return "Location is required";
}
return weatherClient.getCurrentWeather(location, unit);
}
}
```
## Complex Parameter Types
Use Java records and descriptions for complex objects:
```java
public class OrderService {
@Description("Customer order information")
public record OrderRequest(
@Description("Customer ID") String customerId,
@Description("List of items") List<OrderItem> items,
@JsonProperty(required = false) @Description("Delivery instructions") String instructions
) {}
@Tool("Create customer order")
public String createOrder(OrderRequest order) {
return orderService.processOrder(order);
}
}
```
## Return Types
Tool methods can return various types:
```java
// Simple types
@Tool("Get current time")
public long getCurrentTime() {
return System.currentTimeMillis();
}
// JSON/POJO
@Tool("Get user profile")
public UserProfile getUserProfile(@P("User ID") String userId) {
return userProfileService.findById(userId);
}
// Collections
@Tool("Search products")
public List<Product> searchProducts(@P("Search query") String query) {
return productService.search(query);
}
// Maps
@Tool("Get system status")
public Map<String, Object> getSystemStatus() {
return monitoringService.getStatus();
}
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 468k | Updated | Claude CodeCodex | Unverified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |