google-genai/com.google.genai.types/ToolCall

ToolCall

public abstract class ToolCall extends JsonSerializable

A predicted server-side `ToolCall` returned from the model.

This message contains information about a tool that the model wants to invoke. The client is NOT expected to execute this `ToolCall`. Instead, the client should pass this `ToolCall` back to the API in a subsequent turn within a `Content` message, along with the corresponding `ToolResponse`.

Constructors

public void ToolCall()

Types

public abstract class Builder

Builder for ToolCall.

Properties

MAX_READ_LENGTH_PROPERTY

public final static String MAX_READ_LENGTH_PROPERTY

System property to override the default max JSON string length (20MB) in read constraints.

Functions

public abstract Optional<Map<String, Object>> args()

The tool call arguments.

public static ToolCall.Builder builder()

Instantiates a builder for ToolCall.

public static ToolCall fromJson(String jsonString)

Deserializes a JSON string to a ToolCall object.

@InternalApi()

public static T fromJsonNode<T extends JsonSerializable>(JsonNode jsonNode, Class<T> clazz)

Deserializes a JsonNode to an object of the given type.

@InternalApi()

public static T fromJsonString<T extends JsonSerializable>(String jsonString, Class<T> clazz)

Deserializes a Json string to an object of the given type.

public abstract Optional<String> id()

Unique identifier of the tool call.

public static ObjectMapper objectMapper()

setMaxReadLength

public static void setMaxReadLength(int maxReadLength)

Overrides the default maximum JSON string length (20MB) for the JSON parser.

stringToJsonNode

public static JsonNode stringToJsonNode(String string)

Converts a Json string to a JsonNode.

public abstract ToolCall.Builder toBuilder()

Creates a builder with the same values as this instance.

public String toJson()

Serializes the instance to a Json string.

public static JsonNode toJsonNode(Object object)

Serializes an object to a JsonNode.

public static String toJsonString(Object object)

Serializes an object to a Json string.

public abstract Optional<ToolType> toolType()

The type of tool that was called.